Bestätigen der Zustimmung des Kunden zur Microsoft-Kundenvereinbarung mithilfe von Partner Center-APIs

Artikel
08/02/2024

Gilt für: Partner Center

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

Partner Center unterstützt derzeit nur die Bestätigung der Kundenzustimmung zur Microsoft-Kundenvereinbarung in der öffentlichen Microsoft-Cloud.

In diesem Artikel wird beschrieben, wie die Zustimmung des Kunden zur Microsoft-Kundenvereinbarung bestätigt oder erneut bestätigt wird.

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 das SDK-Release von GitHub zusammen mit einer Infodatei herunterladen, die nützliche Informationen enthält.

Partnern wird empfohlen, weiterhin die Partner Center-REST-APIs zu verwenden.

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt nur App- und 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 " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. Suchen Sie auf der Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).
Das Datum (dateAgreed), an dem der Kunde der Microsoft-Kundenvereinbarung zugestimmt hat.
Informationen zum Benutzer von der Kundenorganisation, die der Microsoft-Kundenvereinbarung zugestimmt hat. Dies umfasst:
- Vorname
- Nachname
- E-Mail-Adresse
- Telefonnummer (optional)
Wenn sich die folgenden Werte für einen Kunden ändern, erlaubt Partner Center die Erstellung einer weiteren Vereinbarung für diesen Kunden: Vorname, Nachname, E-Mail-Adresse, Telefonnummer. Andernfalls erhalten Partner den folgenden Fehlercode für die doppelte Erstellung eines Kunden.

{
"code": 600061,
"message": "A partner confirmed agreement already exists for the customer.",
"description": "A partner confirmed agreement already exists for the customer.",
"errorName": "PartnerConfirmedAgreementAlreadyExists",
"isRetryable": false,
"parameters": {},
"errorMessageExtended": "InternalErrorCode=600061"
}

.NET

So bestätigen Sie die Zustimmung oder erneute Zustimmung des Kunden zur Microsoft-Kundenvereinbarung:

Rufen Sie die Metadaten der Vereinbarung für die Microsoft-Kundenvereinbarung ab. Sie müssen die templateID der Microsoft-Kundenvereinbarung abrufen. Weitere Informationen finden Sie unter Abrufen von Vertragsmetadaten für die Microsoft-Kundenvereinbarung.
```
// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();
```
Erstellen Sie ein neues Vereinbarungsobjekt, das Details zur Bestätigung enthält.
Verwenden Sie die IAgreggatePartner.Customers-Sammlung, und rufen Sie die ById-Methode mit der angegebenen customer-tenant-id auf.

Verwenden Sie die Agreements-Eigenschaft, gefolgt von einem Aufruf von Create oder CreateAsync.

// string selectedCustomerId;

var agreementToCreate = new Agreement
{
    DateAgreed = DateTime.UtcNow,
    TemplateId = microsoftCustomerAgreementDetails.TemplateId,
    PrimaryContact = new Contact
    {
        FirstName = "Tania",
        LastName = "Carr",
        Email = "someone@example.com",
        PhoneNumber = "1234567890"
    }
};

Agreement agreement = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Create(agreementToCreate);

Ein vollständiges Beispiel finden Sie in der CreateCustomerAgreement-Klasse aus dem console test app-Projekt.

REST-Anforderung

So bestätigen Sie die Zustimmung oder erneute Zustimmung des Kunden zur Microsoft-Kundenvereinbarung:

Rufen Sie die Metadaten der Vereinbarung für die Microsoft-Kundenvereinbarung ab. Sie müssen die templateID der Microsoft-Kundenvereinbarung abrufen. Weitere Informationen finden Sie unter Abrufen von Vertragsmetadaten für die Microsoft-Kundenvereinbarung.
Erstellen Sie eine neue Agreement-Ressource, um zu bestätigen, dass ein Kunde der Microsoft-Kundenvereinbarung zugestimmt hat. Verwenden Sie die folgende REST-Anforderungssyntax.

Anforderungssyntax

Methode	Anforderungs-URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um den Kunden anzugeben, den Sie bestätigten.

Name	Type	Erforderlich	Beschreibung
customer-tenant-id	GUID	Ja	Der Wert ist eine als GUID formatierte customer-tenant-id, bei der es sich um einen Bezeichner handelt, mit dem Sie einen Kunden angeben können.

Anforderungsheader

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

Anforderungstext

In der folgenden Tabelle werden die erforderlichen Eigenschaften im REST-Anforderungstext beschrieben.

Name	Typ	Beschreibung
Vereinbarung	Objekt	Vom Partner bereitgestellte Details zum Bestätigen der Kundenzustimmung zur Microsoft-Kundenvereinbarung.

Vereinbarung

In dieser Tabelle werden die mindestens erforderlichen Felder zum Erstellen einer Agreement-Ressource beschrieben.

Eigenschaft	Type	Beschreibung
primaryContact	Kontakt	Informationen zu dem Benutzer aus der Kundenorganisation, der der Microsoft-Kundenvereinbarung zugestimmt hat. Diese umfassen: firstName, lastName, email und phoneNumber (optional)
dateAgreed	Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit)	Das Datum, an dem der Kunde der Vereinbarung zugestimmt hat.
templateId	Zeichenfolge	Eindeutiger Bezeichner des Vereinbarungstyps, dem der Kunde zugestimmt hat. Sie können die templateId für die Microsoft-Kundenvereinbarung abrufen, indem Sie die Vertragsmetadaten für die Microsoft-Kundenvereinbarung abrufen. Weitere Informationen finden Sie unter Abrufen von Vertragsmetadaten für die Microsoft-Kundenvereinbarung.
Typ	Zeichenfolge	Der Vereinbarungstyp, dem der Kunde zugestimmt hat. Verwenden Sie „MicrosoftCustomerAgreement“, wenn der Kunde der Microsoft-Kundenvereinbarung zugestimmt hat.

Beispiel für eine Anfrage

POST https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements HTTP/1.1
Authorization: Bearer <token>
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}

REST-Antwort

Bei Erfolg gibt diese Methode eine Agreement-Ressource zurück.

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 201 Created
Content-Length: 261
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "userId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}

Freigeben über