Dela via

Uppdatera en kunds kvalifikationer asynkront

  • Artikel

Uppdaterar en kunds kvalifikationer asynkront.

En partner kan uppdatera en kunds kvalifikationer asynkront till "Education", "GovernmentCommunityCloud" eller "StateOwnedEntity". Det går inte att ange andra värden som "Ingen" och "Ideell organisation".

Förutsättningar

  • Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med App+User-autentiseringsuppgifter.

  • Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).

  • Endast för GCC-kvalifikationer (Government Community Cloud): du behöver minst en av följande detaljerade delegerade administratörsbehörigheter (GDAP). Om du vill veta mer om GDAP kan du utforska våra MS Learn-artiklar, som börjar med Introduktion till GDAP.

    • Katalogläsare
    • Katalogskrivare
    • Licensadministratör
    • Användaradministratör

C#

Om du vill skapa en kunds kvalificering för "Education" skapar du först ett CustomerQualificationRequest typobjekt och anger Education kvalifikationstypen och EducationSegment, tillsammans med en Website (valfritt).

Anropa sedan metoden IAggregatePartner.Customers.ById med kundidentifieraren.

Använd sedan egenskapen Kvalificering för att hämta ett ICustomerQualification-gränssnitt.

Anropa slutligen CreateQualifications() eller CreateQualificationsAsync() med CustomerQualificationRequest typobjektet som indataparameter.

// 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);

Exempel: Exempelapp för konsol. Projekt: SdkSamples-klass: CreateCustomerQualification.cs

För att uppdatera en kunds kvalificering till GovernmentCommunityCloud på en befintlig kund utan kvalificering måste partnern även inkludera kundens valideringskod.

Skapa först ett CustomerQualificationRequest typobjekt och ange kvalifikationstypen GovernmentCommunityCloud och verifieringskoden.

Anropa sedan metoden IAggregatePartner.Customers.ById med kundidentifieraren.

Använd sedan egenskapen Kvalificering för att hämta ett ICustomerQualification-gränssnitt.

Anropa slutligen CreateQualifications() eller CreateQualificationsAsync() med CustomerQualificationRequest typobjektet som indataparameter.

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

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

Exempel: Exempelapp för konsol. Projekt: SdkSamples-klass: CreateCustomerQualificationWithGCC.cs

REST-begäran

Syntax för begäran

Metod URI för förfrågan
POST {baseURL}/v1/customers/{customer_tenant_id}/qualifications HTTP/1.1

URI-parameter

Använd följande frågeparameter för att uppdatera kvalificeringen.

Namn Typ Obligatoriskt Beskrivning
customer-tenant-id GUID Ja Värdet är ett GUID-formaterat kund-klient-ID som gör att återförsäljaren kan filtrera resultatet för en viss kund som tillhör återförsäljaren.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

I den här tabellen beskrivs kvalificeringsobjektet i begärandetexten.

Property Type Obligatoriskt Beskrivning
Kvalifikation sträng Ja Strängvärdet från CustomerQualification-uppräkningen.

Den här tabellen beskriver begärandetexten för utbildningskvalifikationen specifikt.

Property Type Obligatoriskt Beskrivning
Kvalifikation sträng Ja Education
EducationSegment sträng Ja K12, HigherEducation
Website sträng Nej Webbplats för utbildningsentiteten

Om kvalificeringen är för Utbildnings är utbildningssegmentet ett obligatoriskt fält.

  • Tillåtna värden för EducationSegment är K12 och HigherEducation
  • Webbplatsen är fortfarande ett valfritt fält och är endast relevant om kvalificeringen är för utbildning. Men att inkludera det om det är tillgängligt/tillämpligt rekommenderas starkt

Den här tabellen beskriver begärandetexten för GovernmentCommunityCloud-kvalificeringen specifikt.

Property Type Obligatoriskt Beskrivning
Kvalifikation sträng Ja GovernmentCommunityCloud
Valideringskod sträng Ja Partnerns GCC-verifieringskod. Exempel – 123456

Om kvalificeringen är för GovernmentCommunityCloud är ValidationCode ett obligatoriskt fält.

Exempel på begäran

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-svar

Om det lyckas returnerar den här metoden ett kvalificeringsobjekt i svarstexten. Följande är ett exempel på POST-anropet på en kund (med en tidigare kvalificering av None) med utbildningskvalifikationen.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och annan felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder.

Svarsexempel

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
}