Bestätigung der Zustimmung des Kunden zur Microsoft-Kundenvereinbarung abrufen

Gilt für: Partner Center

Gilt nicht für: Partner Center, betrieben von 21Vianet | Partner Center für Microsoft Cloud für die US-Regierung

Die Agreement-Ressource wird derzeit nur von Partner Center in der öffentlichen Microsoft-Cloud unterstützt.

In diesem Artikel wird erläutert, wie Sie Bestätigungen der Annahme des Microsoft-Kundenvertrags eines Kunden abrufen können.

Voraussetzungen

• Wenn Sie das Partner Center .NET SDK verwenden, ist Version 1.14 oder höher erforderlich.

  Wichtig

  Ab Juni 2023 ist jetzt die neueste Partner Center .NET SDK-Version 3.4.0 archiviert. Sie können die SDK-Version von GitHubzusammen mit einer Readme-Datei herunterladen, die nützliche Informationen enthält.

  Partner werden ermutigt, weiterhin die Partner Center-REST-APIszu verwenden.

• Anmeldeinformationen wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt nur die App+Benutzerauthentifizierung.

• Eine Kunden-ID (customer-tenant-id). Wenn Sie die Kunden-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden auswählen, dann den Kunden aus der Kundenliste und anschließend Konto. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID ist identisch mit der Kunden-ID (customer-tenant-id).

.NET

So rufen Sie Bestätigungen der Kundenakzeptanz ab, die zuvor bereitgestellt wurde:

• Verwenden Sie die IAggregatePartner.Customers Kollektion und rufen Sie die Methode ById mit der angegebenen Kunden-ID auf.

• Rufen Sie die Agreements-Eigenschaft ab, und filtern Sie die Ergebnisse nach der Microsoft-Kundenvereinbarung, indem Sie die -ByAgreementType-Methode aufrufen.

• Rufen Sie die Methode Get oder die Methode GetAsync auf.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

var customerAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

Ein vollständiges Beispiel finden Sie in der GetCustomerAgreements-Klasse aus dem Projekt Konsolentest-App.

REST-Anforderung

So rufen Sie die Bestätigung der Kundenakzeptanz ab, die zuvor bereitgestellt wurde:

1. Erstellen Sie eine REST-Anforderung zum Abrufen der Vereinbarungen Sammlung für den Kunden.

2. Verwenden Sie den agreementType- Abfrageparameter, um die Ergebnisse nur auf den Microsoft-Kundenvertrag zu beschränken.

Anforderungssyntax

Verwenden Sie die folgende Anforderungssyntax:

Methode	Anforderungs-URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/agreements?agreementType={agreement-type} HTTP/1.1

URI-Parameter

Sie können die folgenden URI-Parameter mit Ihrer Anforderung verwenden:

Name	Typ	Erforderlich	BESCHREIBUNG
customer-tenant-id	GUID	Ja	Der Wert ist eine GUID, die CustomerTenantId- formatiert ist, mit der Sie einen Kunden angeben können.
Vereinbarungstyp	Schnur	Nein	Dieser Parameter gibt alle Vereinbarungsmetadaten zurück. Verwenden Sie diesen Parameter, um die Abfrageantwort auf einen bestimmten Vertragstyp festzulegen. Die unterstützten Werte sind: MicrosoftCloudAgreement, die nur Vereinbarungsmetadaten des Typs MicrosoftCloudAgreemententhält. MicrosoftCustomerAgreement, die nur Vereinbarungsmetadaten des Typs MicrosoftCustomerAgreemententhält. *, die alle Vereinbarungsmetadaten zurückgibt. (Verwenden Sie * nicht, es sei denn, Ihr Code verfügt über die erforderliche Logik zum Behandeln unerwarteter Vertragstypen.) Hinweis: Wenn der URI-Parameter nicht angegeben wurde, wird die Abfrage standardmäßig aus Gründen der Abwärtskompatibilität auf MicrosoftCloudAgreement festgelegt. Microsoft kann Vertragsmetadaten jederzeit mit neuen Vertragstypen einführen.

Anforderungsheader

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

Anforderungstext

Keiner.

Beispielanfrage

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements?agreementType=MicrosoftCustomerAgreement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine Sammlung von Agreement-Ressourcen im Antworttext zurück.

Antworterfolgs- und Fehlercodes

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und andere Debuginformationen angibt.

Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Antwortbeispiel

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "dateAgreed":"2019-08-26T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}