Обновление квалификации клиента асинхронно

Обновляет квалификацию клиента асинхронно.

Партнер может асинхронно обновить квалификацию клиента, чтобы она была «Образование», «Облако для государственных учреждений» или «Государственная организация». Другие значения, такие как "Нет" и "Некоммерческая организация", не могут быть заданы.

Необходимые условия

• Учетные данные, как описано в аутентификации Центра партнеров. Этот сценарий поддерживает проверку подлинности только с учетными данными app+User.

• Идентификатор клиента (customer-tenant-id). Если вы не знаете идентификатор клиента, его можно найти в Центре партнеров, выбрав рабочую область клиентов, затем клиента из списка, и затем выберите учетную запись . На странице "Учетная запись клиента" найдите идентификатор Майкрософт в разделе сведения о учетной записи клиента. Идентификатор Майкрософт совпадает с идентификатором клиента (customer-tenant-id).

• Только для квалификаций в Government Community Cloud (GCC): вам потребуется по крайней мере одна из следующих гранулярных делегированных ролей администратора (GDAP). Дополнительные сведения о GDAP см. в статьях MS Learn, начав с Введение в GDAP.

  • Средство чтения каталогов
  • Редактор каталогов
  • Администратор лицензии
  • Администратор пользователей

C#

Чтобы создать квалификацию клиента для "Образования", сначала создайте объект типа CustomerQualificationRequest и укажите тип квалификации Education и EducationSegmentвместе с Website (необязательно).

Затем вызовите метод IAggregatePartner.Customers.ById с идентификатором клиента.

Затем используйте свойство Qualification, чтобы получить интерфейс ICustomerQualification.

Наконец, вызовите CreateQualifications() или CreateQualificationsAsync() с объектом типа 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);

Пример: Пример консольного приложения. Проект: SdkSamples Класс: CreateCustomerQualification.cs

Чтобы обновить квалификацию клиента до GovernmentCommunityCloud на существующем клиенте без квалификации, партнер также должен включить код проверки клиента.

Сначала создайте объект типа CustomerQualificationRequest и укажите тип GovernmentCommunityCloud квалификации и код проверки.

Затем вызовите метод IAggregatePartner.Customers.ById с идентификатором клиента.

Затем используйте свойство Qualification, чтобы получить интерфейс ICustomerQualification.

Наконец, вызовите CreateQualifications() или CreateQualificationsAsync() с объектом типа CustomerQualificationRequest в качестве входного параметра.

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

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

Пример: Пример консольного приложения. Project: SdkSamples Класс: CreateCustomerQualificationWithGCC.cs

Запрос REST

Синтаксис запроса

Метод	URI запроса
POST	{baseURL}/v1/customers/{customer_tenant_id}/квалификации HTTP/1.1

Параметр URI

Чтобы обновить квалификацию, используйте следующий параметр запроса.

Имя	Тип	Обязательно	Описание
идентификатор клиента-арендатора	GUID	Да	Это значение представляет собой идентификатор GUID формата , который позволяет реселлеру фильтровать результаты для конкретного клиента, принадлежащего реселлеру.

Заголовки запросов

Для получения дополнительной информации см. заголовки REST Центра партнеров.

Текст запроса

В этой таблице описывается объект квалификации в тексте запроса.

Свойство	Тип	Обязательно	Описание
Квалификация	струна	Да	Строковое значение из перечисления CustomerQualification.

В этой таблице конкретно описывается структура запроса для образовательной квалификации.

Собственность	Тип	Обязательно	Описание
Квалификация	струна	Да	Образование
Сегмент образования	струна	Да	образование с детского сада до 12 класса, высшее образование
Сайт	струна	Нет	Сайт для образовательного учреждения

Если речь идет о квалификации в области образования, сегмент образования является обязательным полем.

• Допустимые значения для EducationSegment: K12 и Высшее образование
• Веб-сайт остается необязательным полем и имеет значение только в том случае, если квалификация является для образования. Однако, включая его, если доступно или применимо, настоятельно рекомендуется

В этой таблице конкретно описывается тело запроса для квалификации GovernmentCommunityCloud.

Свойство	Тип	Обязательно	Описание
Квалификация	струна	Да	Облако для государственной сферы
Код проверки	струна	Да	Код проверки GCC партнера. Пример — 123456

Если квалификация предназначена для GovernmentCommunityCloud, ValidationCode является обязательным полем.

Пример запроса

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

В случае успешного выполнения этот метод возвращает объект квалификации в теле ответа. Ниже приведен пример вызова POST для клиента (с предыдущей квалификацией None) с квалификацией Образование.

Коды успешных действий и ошибок

Каждый ответ содержит код состояния HTTP, указывающий на успешность или сбой, а также другие сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и дополнительных параметров. Полный список см. в разделе Коды ошибок.

Пример ответа

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
}

Связанные статьи

• получить информацию о квалификациях клиента
• Получить коды валидации партнера