Freigeben über

Asynchrones Aktualisieren der Qualifikationen eines Kunden

  • Artikel

Aktualisiert die Qualifikationen eines Kunden asynchron.

Ein Partner kann die Qualifikationen eines Kunden asynchron aktualisieren, um "Education", "GovernmentCommunityCloud" oder "StateOwnedEntity" zu sein. Andere Werte wie "None" und "Non-Profit" können nicht festgelegt werden.

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

  • Nur für GCC-Qualifikationen (Government Community Cloud): Sie benötigen mindestens eine der folgenden differenzierten delegierten Administratorberechtigungen (GDAP). Weitere Informationen zu GDAP finden Sie in unseren MS Learn-Artikeln, beginnend mit einführung in GDAP.

    • Verzeichnis lesen
    • Verzeichnis schreiben
    • Lizenzadministrator
    • Benutzeradministrator

C#

Um zuerst die Qualifikation eines Kunden für "Education" zu erstellen, erstellen Sie zunächst ein CustomerQualificationRequest Typobjekt, und geben Sie den Education Qualifikationstyp und den EducationSegmentQualifizierungstyp zusammen mit einem Website (optional) an.

Rufen Sie dann die IAggregatePartner.Customers.ById-Methode mit der Kunden-ID auf.

Verwenden Sie dann die Qualification-Eigenschaft, um eine ICustomerQualification-Schnittstelle abzurufen.

Rufen Sie CreateQualifications() schließlich das CustomerQualificationRequest Typobjekt als Eingabeparameter auf.CreateQualificationsAsync()

// Education
var eduRequestBody = new CustomerQualificationRequest 
{
    Qualification = "Education",
    EducationSegment = "K12", // could also be "HigherEducation"
    Website = "example.edu"
};

var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(eduRequestBody);

// State Owned Entity
var soeRequestBody = new CustomerQualificationRequest 
{
    Qualification = "StateOwnedEntity"
};

var soeCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(soeRequestBody);

Beispiel: Konsolenbeispiel-App. Projekt: SdkSamples-Klasse: CreateCustomerQualification.cs

Um die Qualifikation eines Kunden an GovernmentCommunityCloud auf einem vorhandenen Kunden ohne Qualifikation zu aktualisieren, muss der Partner auch den Validierungscode des Kunden einschließen.

Erstellen Sie zunächst ein CustomerQualificationRequest Typobjekt, und geben Sie den GovernmentCommunityCloud Qualifizierungstyp und den Validierungscode an.

Rufen Sie dann die IAggregatePartner.Customers.ById-Methode mit der Kunden-ID auf.

Verwenden Sie dann die Qualification-Eigenschaft, um eine ICustomerQualification-Schnittstelle abzurufen.

Rufen Sie CreateQualifications() schließlich das CustomerQualificationRequest Typobjekt als Eingabeparameter auf.CreateQualificationsAsync()

var gccRequestBody = new CustomerQualificationRequest 
{
    Qualification = "GovernmentCommunityCloud",
    ValidationCode = "<validation code>"
};

var gccCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(gccRequestBody);

Beispiel: Konsolenbeispiel-App. Projekt: SdkSamples-Klasse: CreateCustomerQualificationWithGCC.cs

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
POST {baseURL}/v1/customers/{customer_tenant_id}/qualifications HTTP/1.1

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um die Qualifizierung zu aktualisieren.

Name Type Erforderlich Beschreibung
customer-tenant-id GUID Ja 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

In dieser Tabelle wird das Qualifizierungsobjekt im Anforderungstext beschrieben.

Eigenschaft Type Erforderlich Beschreibung
Qualification Zeichenfolge Ja Der Zeichenfolgenwert aus der Enumeration "CustomerQualification ".

In dieser Tabelle wird der Anforderungstext für die Bildungsqualifizierung speziell beschrieben.

Eigenschaft Type Erforderlich Beschreibung
Qualification Zeichenfolge Ja Education
EducationSegment Zeichenfolge Ja K12, Höhere Unterweisung
Website Zeichenfolge No Website für die Bildungseinrichtung

Wenn die Qualifikation für Bildungseinrichtungen gilt, ist das Segment "Education" ein Pflichtfeld.

  • Zulässige Werte für EducationSegment sind K12 und HigherEducation
  • Die Website bleibt ein optionales Feld und ist nur dann relevant, wenn die Qualifikation für Bildungseinrichtungen gilt. Es wird jedoch empfohlen, falls verfügbar/zutreffend, dies zu verwenden.

In dieser Tabelle wird der Anforderungstext für die GovernmentCommunityCloud-Qualifikation speziell beschrieben.

Eigenschaft Type Erforderlich Beschreibung
Qualification Zeichenfolge Ja GovernmentCommunityCloud
ValidationCode Zeichenfolge Ja GCC-Validierungscode des Partners. Beispiel - 123456

Wenn die Qualifikation für GovernmentCommunityCloud gilt, ist ValidationCode ein pflichtfeld.

Anforderungsbeispiel

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications HTTP/1.1
Accept: application/json
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68

// SOE
{
    "qualification": "StateOwnedEntity"
}

// Education
{
    "qualification": "Education",
    "educationSegment": "HigherEducation", // could also be "K12"
    "website": "contoso.edu"
}

// GCC
{
    "qualification": "GovernmentCommunityCloud",
    "validationCode": "123456"
}

REST-Antwort

Bei erfolgreicher Ausführung gibt die Methode ein Qualifikationsobjekt im Antworttext zurück. Nachfolgend sehen Sie ein Beispiel für den POST-Aufruf eines Kunden (mit einer vorherigen Qualifikation ohne Qualifikation) mit der Education-Qualifikation.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und andere Debuginformationen angibt. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Beispielantwort

HTTP/1.1 201 CREATED
Content-Length: 29
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
{
    "qualification": "Education",
    "vettingStatus": "InReview",
    "vettingCreateDate": "2020-12-04T20:54:24Z" // UTC
}