Actualizar las calificaciones de un cliente de forma asincrónica

  • Article

Novedades las calificaciones de un cliente de forma asincrónica.

Un asociado puede actualizar las calificaciones de un cliente de forma asincrónica para que sea "Educación", "GovernmentCommunityCloud" o "StateOwnedEntity". No se pueden establecer otros valores como "None" y "Sin ánimo de lucro".

Requisitos previos

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.

  • Un id. de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , luego el cliente de la lista de clientes y, a continuación , Cuenta. En la página Cuenta del cliente, busque el identificador de Microsoft en la sección Información de la cuenta de cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

  • Solo para las calificaciones de Government Community Cloud (GCC): necesitará al menos uno de los siguientes roles de privilegios de administrador delegados pormenorizados (GDAP). Para obtener más información sobre el GDAP, explore nuestros artículos de MS Learn, empezando por Introducción al GDAP.

    • Lector del directorio
    • Escritor de directorios
    • Administrador de licencias
    • Administrador de usuarios

C#

Para crear primero la calificación de un cliente para "Educación", cree un CustomerQualificationRequest objeto de tipo y especifique el Education tipo de calificación y EducationSegment, junto con un Website (opcional).

A continuación, llame al método IAggregatePartner.Customers.ById con el identificador de cliente.

A continuación, use la propiedad Qualification para recuperar una interfaz ICustomerQualification.

Por último, llame a CreateQualifications() o CreateQualificationsAsync() con el CustomerQualificationRequest objeto type como parámetro de entrada.

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

Ejemplo: Aplicación de ejemplo de consola. Project: SdkSamples (Clase): CreateCustomerQualification.cs

Para actualizar la calificación de un cliente a GovernmentCommunityCloud en un cliente existente sin una calificación, el asociado también debe incluir el código de validación del cliente.

En primer lugar, cree un CustomerQualificationRequest objeto de tipo y especifique el GovernmentCommunityCloud tipo de calificación y el código de validación.

A continuación, llame al método IAggregatePartner.Customers.ById con el identificador de cliente.

A continuación, use la propiedad Qualification para recuperar una interfaz ICustomerQualification.

Por último, llame a CreateQualifications() o CreateQualificationsAsync() con el CustomerQualificationRequest objeto type como parámetro de entrada.

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

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

Ejemplo: Aplicación de ejemplo de consola. Project: SdkSamples (Clase): CreateCustomerQualificationWithGCC.cs

Solicitud REST

Sintaxis de la solicitud

Método URI de solicitud
POST {baseURL}/v1/customers/{customer_tenant_id}/qualifications HTTP/1.1

Parámetro de URI

Use el siguiente parámetro de consulta para actualizar la calificación.

Nombre Type Obligatorio Descripción
customer-tenant-id GUID Sí El valor es un GUID con formato customer-tenant-id que permite al revendedor filtrar los resultados de un cliente determinado que pertenece al revendedor.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

En esta tabla se describe el objeto de calificación en el cuerpo de la solicitud.

Propiedad Type Obligatorio Descripción
cualificación string Sí Valor de cadena de la enumeración CustomerQualification.

En esta tabla se describe específicamente el cuerpo de la solicitud para la calificación educativa.

Propiedad Type Obligatorio Descripción
cualificación string Sí Education
EducationSegment string Sí K12, HigherEducation
Website string No Sitio web de la entidad education

Si la calificación es para Educación , el segmento Educación es un campo obligatorio.

  • Los valores permitidos para EducationSegment son K12 y HigherEducation
  • El sitio web sigue siendo un campo opcional y solo es relevante si la calificación es para educación. Sin embargo, se recomienda incluirlo si está disponible o aplicable.

En esta tabla se describe específicamente el cuerpo de solicitud para la calificación GovernmentCommunityCloud.

Propiedad Type Obligatorio Descripción
cualificación string Sí GovernmentCommunityCloud
ValidationCode string Sí Código de validación GCC del asociado. Ejemplo: 123456

Si la calificación es para GovernmentCommunityCloud , ValidationCode es un campo obligatorio.

Ejemplo de solicitud

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

Respuesta REST

Si se ejecuta correctamente, este método devuelve un objeto de calificaciones en el cuerpo de la respuesta. A continuación se muestra un ejemplo de la llamada POST en un cliente (con una calificación anterior de None) con la calificación Education .

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica éxito o error y otra información de depuración. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error.

Ejemplo de respuesta

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
}