Een bedrijfsprofiel van een klant ophalen

Artikel
07/25/2024

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Hiermee haalt u het bedrijfsprofiel van een klant op.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in partnercentrum. Selecteer de werkruimte Klanten op de startpagina van Partnercentrum. Selecteer de klant in de lijst Klant en selecteer Vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Details van het klantaccount. De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

Belangrijk

De api-aanroep Bedrijfsprofiel ophalen van klant retourneert niet de volgende kenmerken in het antwoord als de partner geen DAP- of GDAP-toegang heeft op de tenant van de klant.

CompanyProfileAddress
CompanyProfileEmail
CustomDomain Ten minste een van de volgende GDAP-rollen is vereist om het e-mailadres CompanyProfileAddress en CompanyProfile op te halen.

Globale beheerder
Mapschrijver
Algemene lezer

Ten minste één van de volgende GDAP-rollen is vereist om het CustomDomain op te halen.

Domeinbeheerder
Lezers van mappen
Globale beheerder
Algemene lezer
Hybrid Identity-beheerder

Zie Ingebouwde rollen van Microsoft voor meer informatie over de rollen.

C#

Als u het bedrijfsprofiel voor een klant wilt ophalen, belt u de methode IAggregatePartner.Customers.ById met de klant-id om de klant te identificeren. Haal vervolgens de ICustomerProfileCollection-interface van de klant op uit de eigenschap Profiles om toegang te krijgen tot de bedrijfseigenschap. Haal vervolgens de ICustomerReadonlyProfile-interface op uit de eigenschap ICustomerProfileCollection.Company en roep de get() of GetAsync() methoden aan.

// IAggregatePartner partnerOperations;
// string customerId;

var companyProfile = partnerOperations.Customers.ById(customerId).Profiles.Company.Get();

Voorbeeld: Download de Partner Center SDK. Project: Klasse PartnerSdk.FeatureSamples: GetCustomerCompanyProfile.cs

Java

De Partner Center Java SDK kan worden gebruikt voor het beheren van Partnercentrum-resources. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.

Als u het bedrijfsprofiel voor een klant wilt ophalen, roept u de functie IAggregatePartner.getCustomers().byId aan met de klant-id om de klant te identificeren. Haal vervolgens de ICustomerProfileCollection-interface van de klant op via de functie [getProfiles] om toegang te krijgen tot de bedrijfseigenschap. Haal vervolgens de interface ICustomerReadonlyProfile op uit de functie ICustomerProfileCollection.getCompany en roep de get-functie aan.

// IAggregatePartner partnerOperations;
// String customerId;

CustomerCompanyProfile companyProfile = partnerOperations.getCustomers().byId(customerId).getProfiles().getCompany().get();

REST-aanvraag

Aanvraagsyntaxis

Wijze	Aanvraag-URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/profiles/company HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter om het bedrijfsprofiel op te halen.

Name	Type	Vereist	Beschrijving
klant-tenant-id	Guid	J	De waarde is een door een GUID opgemaakte klant-tenant-id waarmee de reseller de resultaten kan filteren op een bepaalde klant die deel uitmaakt van de reseller.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/v1/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/profiles/company HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0b6f039c-e4b5-4b9e-bdac-b39077bb60da
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

REST-antwoord

Als dit lukt, retourneert deze methode informatie in de hoofdtekst van het antwoord.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Rest-foutcodes in Partnercentrum voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 200 OK
Content-Length: 488
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 0b6f039c-e4b5-4b9e-bdac-b39077bb60da
MS-CV: /e74N8OrkE29ycwZ.0
MS-ServerId: 101112202
Date: Wed, 04 Jan 2017 19:48:51 GMT

{
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "domain": "dtdemocspcustomer005.onmicrosoft.com",
    "companyName": "DT Demo CSP Customer 005",
    "address": {
        "country": "US",
        "region": "WA",
        "city": "Redmond ",
        "addressLine1": "1 Microsoft Way",
        "postalCode": "98052",
        "phoneNumber": "4155551212"
    },
    "email": "daniel@hotmail.com.tw",
    "links": {
        "self": {
            "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/profiles/company",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "CustomerCompanyProfile"
    }
}

Delen via