Dela via

Uppdatera en kunds kvalifikationer asynkront

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

  • Inloggningsuppgifter som beskrivs i Partner Center-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 leta upp 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 i avsnittet Kundkontoinformation. Microsoft-ID:t är detsamma 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 Introduction to 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 objekt av typen CustomerQualificationRequest och anger Education kvalifikationstyp och EducationSegment, tillsammans med en Website (valfritt).

Anropa sedan metoden IAggregatePartner.Customers.ById med kundidentifieraren.

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

Anropa slutligen CreateQualifications() eller CreateQualificationsAsync() med objektet CustomerQualificationRequest typ 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 på: Console Sample App. Project: SdkSamples Class: CreateCustomerQualification.cs

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

Skapa först ett objekt av typen CustomerQualificationRequest och ange GovernmentCommunityCloud kvalifikationstyp och verifieringskod.

Anropa sedan metoden IAggregatePartner.Customers.ById med kundidentifieraren.

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

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

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

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

Exempel på: Console Sample App. Project: SdkSamples Class: CreateCustomerQualificationWithGCC.cs

REST-begäran

Syntax för förfrågan

Metod Begäran URI
POST {baseURL}/v1/customers/{customer_tenant_id}/qualifications HTTP/1.1

URI-parametrar

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

Namn Typ Krävs Beskrivning
customer-tenant-id GUID Ja Värdet är ett GUID-formaterat customer-tenant-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 Partner Center.

Begäransinnehåll

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

Egenskap Typ Krävs Beskrivning
Kvalifikation sträng Ja Strängvärdet från CustomerQualification uppräkningstyp.

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

Egenskap Typ Krävs Beskrivning
Kvalifikation sträng Ja Utbildning
Utbildningssegment sträng Ja K-12-utbildning, Högre utbildning
Webbplats sträng Nej Webbplats för utbildningsentiteten

Om kvalificeringen gäller för Education är Education-segmentet 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

I den här tabellen beskrivs innehållet i begärandekroppen för GovernmentCommunityCloud-kvalificering i detalj.

Egenskap Typ Krävs Beskrivning
Kvalifikation sträng Ja GovernmentCommunityCloud
Valideringskod sträng Ja Partnerns GCC-verifieringskod. Exempel – 123456

Om kvalificeringen gäller 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-samtal med en kund (utan tidigare kvalificering None) med kvalificeringen Education.

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
}