Udostępnij za pośrednictwem

Asynchroniczna aktualizacja kwalifikacji klienta

  • Artykuł

Aktualizacje asynchronicznie kwalifikacji klienta.

Partner może zaktualizować kwalifikacje klienta asynchronicznie tak, aby był "Edukacja", "GovernmentCommunityCloud" lub "StateOwnedEntity". Nie można ustawić innych wartości, takich jak "None" i "Non-profit".

Wymagania wstępne

  • Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń aplikacji i użytkownika.

  • Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim, wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta. Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).

  • Tylko w przypadku kwalifikacji usługi Government Community Cloud (GCC): musisz mieć co najmniej jedną z następujących szczegółowych uprawnień administratora delegowanego (GDAP). Aby dowiedzieć się więcej na temat GDAP, zapoznaj się z naszymi artykułami MS Learn, począwszy od artykułu Introduction to GDAP (Wprowadzenie do GDAP).

    • Czytelnik katalogów
    • Składnik zapisywania katalogów
    • Administracja istrator licencji
    • Administrator użytkowników

C#

Aby utworzyć kwalifikację klienta do "Edukacja", najpierw utwórz CustomerQualificationRequest obiekt typu i określ Education typ kwalifikacji oraz EducationSegmentelement , wraz z Website (opcjonalnie).

Następnie wywołaj metodę IAggregatePartner.Customers.ById przy użyciu identyfikatora klienta.

Następnie użyj właściwości Qualification, aby pobrać interfejs ICustomerQualification.

Na koniec wywołaj CreateQualifications() metodę CustomerQualificationRequest lub CreateQualificationsAsync() za pomocą obiektu typu jako parametru wejściowego.

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

Przykład: przykładowa aplikacja konsoli. Projekt: SdkSamples , klasa: CreateCustomerQualification.cs

Aby zaktualizować kwalifikacje klienta do aplikacji GovernmentCommunityCloud na istniejącym kliencie bez kwalifikacji, partner jest również zobowiązany do uwzględnienia kodu weryfikacji klienta.

Najpierw utwórz CustomerQualificationRequest obiekt typu i określ GovernmentCommunityCloud typ kwalifikacji oraz kod weryfikacji.

Następnie wywołaj metodę IAggregatePartner.Customers.ById przy użyciu identyfikatora klienta.

Następnie użyj właściwości Qualification, aby pobrać interfejs ICustomerQualification.

Na koniec wywołaj CreateQualifications() metodę CustomerQualificationRequest lub CreateQualificationsAsync() za pomocą obiektu typu jako parametru wejściowego.

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

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

Przykład: przykładowa aplikacja konsoli. Projekt: SdkSamples , klasa: CreateCustomerQualificationWithGCC.cs

Żądanie REST

Składnia żądania

Method Identyfikator URI żądania
POST {baseURL}/v1/customers/{customer_tenant_id}/kwalifikacje HTTP/1.1

Parametr identyfikatora URI

Aby zaktualizować kwalifikację, użyj następującego parametru zapytania.

Nazwisko Type Wymagania opis
identyfikator dzierżawy klienta Identyfikator GUID Tak Wartość to identyfikator GUID sformatowany jako customer-tenant-id , który umożliwia odsprzedawcy filtrowanie wyników dla danego klienta należącego do odsprzedawcy.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

W tej tabeli opisano obiekt kwalifikacji w treści żądania.

Właściwość Type Wymagania opis
kwalifikacje string Tak Wartość ciągu z wyliczenia CustomerQualification.

W tej tabeli opisano treść żądania dla kwalifikacji edukacyjnych.

Właściwość Type Wymagania opis
kwalifikacje string Tak Education
EducationSegment string Tak K12, HigherEducation
Witryna internetowa string Nie Witryna internetowa dla jednostki edukacyjnej

Jeśli kwalifikacja dotyczy edukacji , segment Edukacja jest polem wymaganym.

  • Dozwolone wartości dla elementu EducationSegment to K12 i HigherEducation
  • Witryna internetowa pozostaje polem opcjonalnym i jest odpowiednia tylko wtedy, gdy kwalifikacja dotyczy edukacji. Jednak uwzględnienie go, jeśli jest dostępne/odpowiednie, jest zdecydowanie zalecane

W tej tabeli opisano treść wniosku o kwalifikacje GovernmentCommunityCloud w szczególności.

Właściwość Type Wymagania opis
kwalifikacje string Tak GovernmentCommunityCloud
Kod weryfikacji string Tak Kod weryfikacji GCC partnera. Przykład — 123456

Jeśli kwalifikacja jest dla GovernmentCommunityCloud , walidacjaCode jest polem wymaganym.

Przykład żądania

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

Odpowiedź REST

W przypadku powodzenia ta metoda zwraca obiekt kwalifikacji w treści odpowiedzi. Poniżej znajduje się przykład wywołania POST dla klienta (z poprzednią kwalifikacją None) z kwalifikacjami edukacyjnymi.

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i inne informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów.

Przykład odpowiedzi

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
}