Asynchronní aktualizace kvalifikace zákazníka

  • Článek

Aktualizace 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 popsané v ověřování v Partnerském centru 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 Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. 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 úvodem do GDAP.

    • Čtenář adresáře
    • Zapisovač adresářů
    • Licenční Správa istrator
    • Správce uživatelů

C#

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

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

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

Nakonec zavolejte CreateQualifications() nebo CreateQualificationsAsync() s objektem CustomerQualificationRequest typu jako vstupním parametrem.

// 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á aplikace konzoly Projekt: SdkSamples – třída: CreateCustomerQualification.cs

Pokud chcete aktualizovat kvalifikaci zákazníka na GovernmentCommunityCloud u stávajícího zákazníka bez kvalifikace, musí partner také zahrnout ověřovací kód zákazníka.

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

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

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

Nakonec zavolejte CreateQualifications() nebo CreateQualificationsAsync() s objektem CustomerQualificationRequest typu jako vstupním parametrem.

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

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

Ukázka: Ukázková aplikace konzoly Projekt: SdkSamples – třída: CreateCustomerQualificationWithGCC.cs

Požadavek REST

Syntaxe požadavku

metoda Identifikátor URI žádosti
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.

Name Type Požadováno Popis
customer-tenant-id Identifikátor GUID Ano Hodnota je GUID formátované ID tenanta zákazníka, které umožňuje prodejci filtrovat výsledky pro daného zákazníka, který patří k prodejci.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Tato tabulka popisuje objekt kvalifikace v textu požadavku.

Vlastnost Typ Požadováno Popis
Kvalifikace string Ano Řetězcová hodnota z výčtu CustomerQualification .

Tato tabulka popisuje text žádosti o konkrétní kvalifikaci vzdělávání.

Vlastnost Typ Požadováno Popis
Kvalifikace string Ano Vzdělávání
EducationSegment string Ano K12, Vyššíedukace
Website string No Web pro entitu vzdělávání

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

  • Povolené hodnoty pro EducationSegment jsou K12 a HigherEducation
  • Web zůstává nepovinným polem a je relevantní pouze v případě, že je kvalifikace pro vzdělávání. Pokud je ale k dispozici nebo je to možné, důrazně se doporučuje, abyste ho do něj zapomněli.

Tato tabulka popisuje text žádosti o kvalifikaci GovernmentCommunityCloud konkrétně.

Vlastnost Typ Požadováno Popis
Kvalifikace string Ano GovernmentCommunityCloud
Ověřovací kód string Ano Ověřovací kód GCC partnera Příklad – 123456

Pokud je kvalifikace pro GovernmentCommunityCloud , pak Ověřovací kód je 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: 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"
}

Odpověď REST

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

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: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
{
    "qualification": "Education",
    "vettingStatus": "InReview",
    "vettingCreateDate": "2020-12-04T20:54:24Z" // UTC
}