Delen via

De kwalificaties van een klant asynchroon bijwerken

  • Artikel

Werkt de kwalificaties van een klant asynchroon bij.

Een partner kan de kwalificaties van een klant asynchroon bijwerken naar 'Education', 'GovernmentCommunityCloud' of 'StateOwnedEntity'. Andere waarden, zoals 'Geen' en 'Non-profit', kunnen niet worden ingesteld.

Vereisten

  • Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.

  • Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

  • Alleen voor GCC-kwalificaties (Government Community Cloud): u hebt ten minste een van de volgende gedetailleerde rollen voor gedelegeerde beheerdersbevoegdheden (GDAP) nodig. Voor meer informatie over GDAP, bekijkt u onze MS Learn-artikelen, te beginnen met Inleiding tot GDAP.

    • Maplezer
    • Mapschrijver
    • Licentiebeheerder
    • Gebruikersbeheerder

C#

Als u eerst de kwalificatie van een klant voor 'Onderwijs' wilt maken, maakt u eerst een CustomerQualificationRequest typeobject en geeft u het Education kwalificatietype en de EducationSegment, samen met een Website (optioneel) op.

Roep vervolgens de methode IAggregatePartner.Customers.ById aan met de klant-id.

Gebruik vervolgens de eigenschap Kwalificatie om een ICustomerQualification-interface op te halen.

Roep ten slotte CreateQualifications() het CustomerQualificationRequest typeobject aan als CreateQualificationsAsync() de invoerparameter.

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

Voorbeeld: Consolevoorbeeld-app. Project: Klasse SdkSamples: CreateCustomerQualification.cs

Als u de kwalificatie van een klant wilt bijwerken naar GovernmentCommunityCloud op een bestaande klant zonder kwalificatie, moet de partner ook de validatiecode van de klant opnemen.

Maak eerst een CustomerQualificationRequest typeobject en geef het GovernmentCommunityCloud kwalificatietype en de validatiecode op.

Roep vervolgens de methode IAggregatePartner.Customers.ById aan met de klant-id.

Gebruik vervolgens de eigenschap Kwalificatie om een ICustomerQualification-interface op te halen.

Roep ten slotte CreateQualifications() het CustomerQualificationRequest typeobject aan als CreateQualificationsAsync() de invoerparameter.

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

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

Voorbeeld: Consolevoorbeeld-app. Project: SdkSamples-klasse: CreateCustomerQualificationWithGCC.cs

REST-aanvraag

Aanvraagsyntaxis

Wijze Aanvraag-URI
POST {baseURL}/v1/customers/{customer_tenant_id}/kwalificaties HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter om de kwalificatie bij te werken.

Name Type Vereist Beschrijving
klant-tenant-id GUID Ja De waarde is een door een GUID opgemaakte klant-tenant-id waarmee de reseller de resultaten kan filteren op een bepaalde klant die deel uitmaakt van de reseller.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

In deze tabel wordt het kwalificatieobject in de aanvraagbody beschreven.

Eigenschap Type Vereist Beschrijving
kwalificatie tekenreeks Ja De tekenreekswaarde van de enum CustomerQualification.

In deze tabel wordt specifiek de aanvraagtekst voor de opleidingskwalificatie beschreven.

Eigenschap Type Vereist Beschrijving
kwalificatie tekenreeks Ja Onderwijs
EducationSegment tekenreeks Ja K12, HigherEducation
Website tekenreeks Nee Website voor de onderwijsentiteit

Als de kwalificatie voor Education is, is het onderwijssegment een verplicht veld.

  • Toegestane waarden voor EducationSegment zijn K12 en HigherEducation
  • Website blijft een optioneel veld en is alleen relevant als de kwalificatie voor onderwijs is. Het is echter raadzaam om deze indien beschikbaar/van toepassing te gebruiken

In deze tabel wordt de aanvraagbody voor de GovernmentCommunityCloud-kwalificatie specifiek beschreven.

Eigenschap Type Vereist Beschrijving
kwalificatie tekenreeks Ja GovernmentCommunityCloud
Validatiecode tekenreeks Ja GCC-validatiecode van partner. Voorbeeld: 123456

Als de kwalificatie voor GovernmentCommunityCloud is, is ValidationCode een vereist veld.

Aanvraagvoorbeeld

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications HTTP/1.1
Accept: application/json
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
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-antwoord

Als dit lukt, retourneert deze methode een kwalificatieobject in de antwoordtekst. Hieronder volgt een voorbeeld van de POST-aanroep van een klant (met een eerdere kwalificatie van Geen) met de Education-kwalificatie .

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en andere informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 201 CREATED
Content-Length: 29
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
{
    "qualification": "Education",
    "vettingStatus": "InReview",
    "vettingCreateDate": "2020-12-04T20:54:24Z" // UTC
}