Abrufen des Unternehmensprofils eines Kunden

Artikel
10/18/2023

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 Api "Kundenprofil abrufen" gibt die folgenden Attribute nicht zurück in der Antwort zurück, wenn der Partner keinen DAP-Zugriff auf den Kundenmandanten hat. Andernfalls werden alle im Antwortbeispiel aufgeführten Attribute zurückgegeben.

CompanyProfileAddress
CompanyProfileEmail
BenutzerdefinierteDomäne

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, Standard von der Partnercommunity unterstützt und nicht offiziell von Microsoft 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	J	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

None

Beispiel für eine Anfrage

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

Share via