Een bedrijfsprofiel van een klant ophalen

Artikel
10/19/2023

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 Voor het ophalen van het bedrijfsprofiel van de klant retourneert de volgende kenmerken niet terug in het antwoord als de partner geen DAP-toegang heeft tot de tenant van de klant. Anders worden alle kenmerken geretourneerd die worden vermeld in het antwoordvoorbeeld.

CompanyProfileAddress
CompanyProfileEmail
CustomDomain

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

Methode	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.

Naam	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/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/profiles/company HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0b6f039c-e4b5-4b9e-bdac-b39077bb60da
MS-CorrelationId: ffa9174c-dbcb-47de-b70d-10e640a7f1b4
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: ffa9174c-dbcb-47de-b70d-10e640a7f1b4
MS-RequestId: 0b6f039c-e4b5-4b9e-bdac-b39077bb60da
MS-CV: /e74N8OrkE29ycwZ.0
MS-ServerId: 101112202
Date: Wed, 04 Jan 2017 19:48:51 GMT

{
    "tenantId": "4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04",
    "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/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/profiles/company",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "CustomerCompanyProfile"
    }
}

Delen via