Actualizar las calificaciones de un cliente de forma asincrónica

Actualiza 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".

Prerrequisitos

  • Credenciales como se describe en Autenticación del Centro de partners. Este escenario solo admite la autenticación con credenciales de App+User.

  • Identificador 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, posteriormente el cliente de la lista de clientes y, finalmente, 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 identificador de Microsoft es el mismo que el identificador 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 GDAP, explore nuestros artículos de MS Learn, comenzando con Introducción a GDAP.

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

C#

Para crear la calificación de un cliente para "Education", primero cree un objeto de tipo CustomerQualificationRequest y especifique el tipo de calificación Education y el 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 Calificación para recuperar una interfaz ICustomerQualification

Por último, llame a CreateQualifications() o CreateQualificationsAsync() con el objeto de tipo CustomerQualificationRequest 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);

Muestra: Aplicación de Muestra de consola. Project: SdkSamples Clase: CreateCustomerQualification.cs

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

En primer lugar, cree un objeto de tipo CustomerQualificationRequest y especifique el tipo de calificación GovernmentCommunityCloud 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 Calificación para recuperar una interfaz ICustomerQualification.

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

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

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

Muestra: Aplicación de Muestra de consola. Project: SdkSamples Clase: CreateCustomerQualificationWithGCC.cs

Solicitud REST

Sintaxis de 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 Tipo Obligatorio Descripción
id de cliente-arrendatario 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 Tipo Obligatorio Descripción
Calificación cadena Sí Valor de texto de la enumeración CustomerQualification.

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

Propiedad Tipo Obligatorio Descripción
Calificación cadena Sí Educación
SegmentoEducativo string Sí Educación K-12, Educación Superior
Sitio web cadena No Sitio web de la entidad educativa

Si la calificación es para Educación, el segmento de 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 Tipo Obligatorio Descripción
Calificación cadena Sí GovernmentCommunityCloud
Código de validación cadena 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: 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"
}

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 a un cliente (con una calificación anterior de Ninguna) con la calificación Educación.

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, tipo de error y 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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
{
    "qualification": "Education",
    "vettingStatus": "InReview",
    "vettingCreateDate": "2020-12-04T20:54:24Z" // UTC
}
  • Last updated on