Abrufen des Unternehmensprofils eines Kunden

Artikel
07/25/2024

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

Ruft das Unternehmensprofil eines Kunden ab.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die ID des Kunden nicht kennen, können Sie sie im Partner Center nachschlagen. Wählen Sie auf der Partner Center-Startseite den Arbeitsbereich "Kunden " aus. Wählen Sie den Kunden aus der Kundenliste aus, und wählen Sie dann "Konto" aus. Suchen Sie auf der Kontoseite des Kunden im Abschnitt "Kundenkontodetails" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

Wichtig

Der API-Aufruf der Get Customer Company Profile API gibt die folgenden Attribute nicht zurück in der Antwort zurück, wenn der Partner keinen DAP- oder GDAP-Zugriff auf den Kundenmandanten hat.

CompanyProfileAddress
CompanyProfileEmail
CustomDomain Mindestens eine der folgenden GDAP-Rollen ist erforderlich, um die CompanyProfileAddress- und CompanyProfile-E-Mail abzurufen.

Globaler Administrator
Verzeichnis schreiben
Globaler Leser

Mindestens eine der folgenden GDAP-Rollen ist erforderlich, um die CustomDomain abzurufen.

Domänenadministrator
Verzeichnisleseberechtigte
Globaler Administrator
Globaler Leser
Hybrididentitätsadministrator

Weitere Informationen zu den Rollen finden Sie unter "Integrierte Microsoft-Rollen".

C#

Um das Unternehmensprofil für einen Kunden zu ermitteln, rufen Sie zum Identifizieren des Kunden die IAggregatePartner.Customers.ById-Methode mit der Kunden-ID auf. Rufen Sie dann die ICustomerProfileCollection-Schnittstelle des Kunden über die Profiles-Eigenschaft ab, um auf die Eigenschaft "Company" zuzugreifen. Rufen Sie als Nächstes die ICustomerReadonlyProfile-Schnittstelle aus der ICustomerProfileCollection.Company-Eigenschaft ab, und rufen Sie die Methoden "Get()" oder "GetAsync()" auf.

// IAggregatePartner partnerOperations;
// string customerId;

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

Beispiel: Laden Sie das Partner Center SDK herunter. Projekt: PartnerSdk.FeatureSamples-Klasse: GetCustomerCompanyProfile.cs

Java

Das Partner Center Java SDK kann zum Verwalten von Partner Center-Ressourcen verwendet werden. Es handelt sich um ein Open-Source-Projekt, das von der Partnercommunity verwaltet wird und von Microsoft nicht offiziell unterstützt wird. Sie können Hilfe von der Community erhalten oder ein Issue auf GitHub öffnen, wenn ein Problem auftritt.

Rufen Sie zum Abrufen des Unternehmensprofils für einen Kunden die Funktion "IAggregatePartner.getCustomers().byId " mit der Kunden-ID auf, um den Kunden zu identifizieren. Rufen Sie dann die ICustomerProfileCollection-Schnittstelle des Kunden über die [getProfiles]-Funktion ab, um auf die Eigenschaft "Company" zuzugreifen. Rufen Sie als Nächstes die ICustomerReadonlyProfile-Schnittstelle aus der Funktion "ICustomerProfileCollection.getCompany " ab, und rufen Sie die Get-Funktion auf .

// IAggregatePartner partnerOperations;
// String customerId;

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

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um das Unternehmensprofil abzurufen.

Name	Type	Erforderlich	Beschreibung
customer-tenant-id	guid	Y	Der Wert ist eine GUID-formatierte Kundenmandanten-ID , die es dem Händler ermöglicht, die Ergebnisse für einen bestimmten Kunden zu filtern, der zum Händler gehört.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine

Anforderungsbeispiel

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-Antwort

Wenn die Methode erfolgreich verläuft, werden Informationen im Antworttext zurückgegeben.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantwort

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"
    }
}

Freigeben über