Sdílet prostřednictvím

Asynchronní aktualizace kvalifikace zákazníka

  • Článek

Aktualizuje kvalifikace zákazníka asynchronně.

Partner může asynchronně aktualizovat kvalifikace zákazníka tak, aby byla "Education", "GovernmentCommunityCloud" nebo "StateOwnedEntity". Jiné hodnoty, například None (Žádné) a Nonprofit (Neziskové organizace), nejde nastavit.

Požadavky

  • Přihlašovací údaje, jak je popsáno v ověřování Partnerského centra. Tento scénář podporuje ověřování pouze s přihlašovacími údaji aplikace a uživatele.

  • ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v partnerském centru tak, že vyberete pracovní prostor Zákazníci, pak zákazník ze seznamu zákazníků a pak účet. Na stránce účtu zákazníka vyhledejte ID Microsoftu v části Informace o zákaznickém účtu. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

  • Pouze pro kvalifikace GCC (Government Community Cloud): Budete potřebovat alespoň jednu z následujících podrobných delegovaných rolí správce (GDAP). Další informace o GDAP najdete v našich článcích MS Learn, počínaje Úvod do GDAP.

    • Čtenář adresáře
    • Správce adresářů
    • Správce licencí
    • Správce uživatelů

C#

Pokud chcete nejprve vytvořit kvalifikaci zákazníka pro vzdělávání, vytvořte objekt typu CustomerQualificationRequest a zadejte Education typ kvalifikace a EducationSegmentspolu s Website (volitelné).

Potom volejte metodu IAggregatePartner.Customers.ById s identifikátorem zákazníka.

Pak použijte vlastnost Kvalifikace k načtení rozhraní ICustomerQualification.

Nakonec jako vstupní parametr volejte CreateQualifications() nebo CreateQualificationsAsync() s objektem typu CustomerQualificationRequest.

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

Ukázka: Ukázková konzolová aplikace. Projekt: SdkSamples Třída: CreateCustomerQualification.cs

Pokud chce partner aktualizovat kvalifikaci zákazníka na GovernmentCommunityCloud u stávajícího zákazníka, který nemá kvalifikaci, musí zahrnout ověřovací kód zákazníka.

Nejprve vytvořte objekt typu CustomerQualificationRequest a zadejte GovernmentCommunityCloud typ kvalifikace a ověřovací kód.

Potom volejte metodu IAggregatePartner.Customers.ById s identifikátorem zákazníka.

Pak použijte vlastnost Kvalifikace k načtení rozhraní ICustomerQualification.

Nakonec jako vstupní parametr volejte CreateQualifications() nebo CreateQualificationsAsync() s objektem typu CustomerQualificationRequest.

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

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

Ukázka: Ukázková konzolová aplikace. Project: SdkSamples Class: CreateCustomerQualificationWithGCC.cs

Požadavek REST

Syntaxe požadavku

Metoda Požadavek URI
POST {baseURL}/v1/customers/{customer_tenant_id}/kvalifikace HTTP/1.1

Parametr identifikátoru URI

K aktualizaci kvalifikace použijte následující parametr dotazu.

Jméno Typ Povinný Popis
ID zákaznického tenanta GUID Ano Hodnota je identifikátor GUID formátovaný jako customer-tenant-id, který umožňuje prodejci filtrovat výsledky pro daného zákazníka, který patří prodejci.

Hlavičky požadavku

Další informace najdete v části REST hlavičky Partnerského centra.

Text požadavku

Tato tabulka popisuje objekt kvalifikace v textu požadavku.

Majetek Typ Povinný Popis
Kvalifikace řetězec Ano Řetězcová hodnota z výčtu CustomerQualification.

Tato tabulka popisuje tělo požadavku pro vzdělávací kvalifikace konkrétně.

Majetek Typ Povinný Popis
Kvalifikace řetězec Ano Vzdělávání
Segment Vzdělávání řetězec Ano K12, Vyššíedukace
Internetová stránka řetězec Ne Web pro entitu vzdělávání

Pokud je kvalifikace určená pro vzdělávání, segment vzdělávání je povinným polem.

  • Povolené hodnoty pro EducationSegment jsou K12 a VyššíVzdělávání
  • Webová stránka zůstává nepovinným polem a je relevantní pouze v případě, že se kvalifikace týká vzdělávání. Pokud je ale k dispozici nebo je to použitelné, důrazně se doporučuje jeho zahrnutí.

Tato tabulka popisuje konkrétně tělo žádosti pro kvalifikaci Government Community Cloud .

Majetek Typ Povinný Popis
Kvalifikace řetězec Ano Vládní komunitní cloud
Ověřovací kód řetězec Ano Ověřovací kód GCC partnera Příklad – 123456

Pokud je kvalifikace pro GovernmentCommunityCloud, pak je ValidationCode povinné pole.

Příklad požadavku

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"
}

Odpověď REST

Pokud je tato metoda úspěšná, vrátí objekt kvalifikace v textu odpovědi. Následuje příklad volání na zákazníka s předchozí kvalifikací None a s kvalifikací Education pomocí POST.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi

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
}