Abrufen der indirekten Vertriebspartner eines Kunden

Artikel
04/01/2024

Gilt für: Partner Center

So erhalten Sie eine Liste der indirekten Wiederverkäufer, die über eine Beziehung mit einem bestimmten Kunden verfügen.

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

C#

Um eine Liste der indirekten Wiederverkäufer abzurufen, mit denen der angegebene Kunde über eine Beziehung verfügt, rufen Sie zuerst eine Schnittstelle zu Kundensammlungsvorgängen für den spezifischen Kunden aus der Eigenschaft "partnerOperations.Customers " ab, indem sie die Kunden-ID zum Identifizieren des Kunden bereitstellt. Rufen Sie dann die Relationships.Get - oder Get_Async-Methode auf, um die Liste der indirekten Wiederverkäufer abzurufen.

// IAggregatePartner partnerOperations;
// string customerId;

 var indirectResellers = partnerOperations.Customers[customerId].Relationships.Get();

Beispiel: Konsolentest-App-Projekt: Partner Center SDK Samples Class: GetIndirectResellersOfCustomer.cs

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
GET	{baseURL}/v1/customers/{customer-id}/relationships HTTP/1.1

URI-Parameter

Verwenden Sie zum Identifizieren des Kunden die folgenden Pfadparameter:

Name	Type	Erforderlich	Beschreibung
Kunden-ID	Zeichenfolge	Ja	Eine guid formatierte Zeichenfolge, die den Kunden identifiziert.

Anforderungsheader

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

Anforderungstext

Keine.

Anforderungsbeispiel

GET https://api.partnercenter.microsoft.com/v1/customers/c501c3c4-d776-40ef-9ecf-9cefb59442c1/relationships HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c9251710-5a30-4cd3-891a-c42d550af9a8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST-Antwort

Wenn die Antwort erfolgreich verläuft, enthält der Antworttext eine Sammlung von PartnerRelationship-Ressourcen , um die Händler zu identifizieren.

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

Beispielantwort

HTTP/1.1 200 OK
Content-Length: 264
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: c9251710-5a30-4cd3-891a-c42d550af9a8
MS-CV: plJP3ufU0UqXMeuh.0
MS-ServerId: 020021921
Date: Fri, 07 Apr 2017 23:42:11 GMT

{
    "totalCount": 1,
    "items": [{
            "id": "484e548c-f5f3-4528-93a9-c16c6373cb59",
            "name": "First Up Consultants",
            "relationshipType": "is_indirect_cloud_solution_provider_of",
            "mpnId": "4847383",
            "attributes": {
                "objectType": "PartnerRelationship"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Freigeben über