Actualizar la calificación de un clienteUpdate a customer's qualification

Se aplica aApplies To

  • Centro de partnersPartner Center

Actualiza la calificación de un cliente.Updates a customer's qualification.

Un asociado puede actualizar la calificación de un cliente para que sea "Education" o "GovernmentCommunityCloud".A partner can update a customer's qualification to be "Education" or "GovernmentCommunityCloud". No se pueden establecer otros valores, "none" y "Nonprofit".Other values, "None" and "Nonprofit", cannot be set.

Requisitos previosPrerequisites

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners.Credentials as described in Partner Center authentication. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.This scenario supports authentication with App+User credentials only.

  • Un id. de cliente (customer-tenant-id).A customer ID (customer-tenant-id). Si no conoces el identificador del cliente, puedes buscarlo en el panel del Centro de partners.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Selecciona CSP en el menú del Centro de partners, seguido de Clientes.Select CSP from the Partner Center menu, followed by Customers. En la lista de clientes, selecciona el cliente y, a continuación, elige Cuenta.Select the customer from the customer list, then select Account. En la página cuenta del cliente, busque el identificador de Microsoft en la sección información de la cuenta de cliente .On the customer's Account page, look for the Microsoft ID in the Customer Account Info section. El identificador de Microsoft es el mismo que el de cliente (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

C#C#

Para actualizar la calificación de un cliente a "Education", llame a [Update/dotnet/API/Microsoft. Store. partnercenter. Qualification. icustomerqualification. Update] en un [Customer/dotnet/API/Microsoft.Store.partnercenter.Models.customers.Customer) existente.To update a customer's qualification to "Education", call [Update/dotnet/api/microsoft.store.partnercenter.qualification.icustomerqualification.update) on an existing [Customer/dotnet/api/microsoft.store.partnercenter.models.customers.customer).

// CustomerQualification is an enum

var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.Update(CustomerQualification.Education);

Ejemplo: aplicación de prueba de consola.Sample: Console test app. Proyecto: PartnerSDK. FeatureSamples ( clase): CustomerQualificationOperations.CSProject: PartnerSDK.FeatureSamples Class: CustomerQualificationOperations.cs

Para actualizar la calificación de un cliente a GovernmentCommunityCloud en un cliente existente sin una calificación.To update a customer's qualification to GovernmentCommunityCloud on an existing customer without a qualification. El asociado también es necesario para incluir el ValidationCodedel cliente.The partner is also are required to include the customer's ValidationCode.

// CustomerQualification is an enum
// GCC validation is type ValidationCode

var gccCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.Update(CustomerQualification.GovernmentCommunityCloud, gccValidation);

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de solicitudRequest URI
PUTPUT {baseurl}/v1/customers/{customer_id}/Qualification? Code = {VALIDATIONCODE} http/1.1{baseURL}/v1/customers/{customer_id}/qualification?code={validationCode} HTTP/1.1

Parámetro de URIURI parameter

Use el siguiente parámetro de consulta para actualizar la calificación.Use the following query parameter to update the qualification.

NombreName TipoType ObligatorioRequired DescripciónDescription
customer-tenant-idcustomer-tenant-id GUIDGUID Yes El valor es un identificador de inquilino de cliente con formato de GUID que permite que el revendedor filtre los resultados de un determinado cliente que pertenece al distribuidor.The value is a GUID formatted customer-tenant-id that allows the reseller to filter the results for a given customer that belongs to the reseller.
validationCodevalidationCode intint NoNo Solo es necesario para la nube de la comunidad gubernamental.Only needed for Government Community Cloud.

Encabezados de solicitudRequest headers

Para obtener más información, consulta Encabezados REST del Centro de partners.For more information, see Partner Center REST headers.

Cuerpo de la solicitudRequest body

Valor entero de la enumeración [CustomerQualification/dotnet/API/Microsoft.Store.partnercenter.Models.customers.customerqualification).The integer value from the [CustomerQualification/dotnet/api/microsoft.store.partnercenter.models.customers.customerqualification) enum.

Ejemplo de solicitudRequest example

PUT https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualification?code=<validation-code> HTTP/1.1
Accept: application/json
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68

Respuesta RESTREST response

Si se realiza correctamente, este método devuelve la propiedad [Qualification/dotnet/API/Microsoft.Store.partnercenter.customers.icustomer.Qualification] actualizada en el cuerpo de la respuesta.If successful, this method returns updated [Qualification/dotnet/api/microsoft.store.partnercenter.customers.icustomer.qualification) property in the response body.

Códigos de error y de respuesta correctosResponse success and error codes

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulte Códigos de error.For the full list, see Error Codes.

Ejemplo de respuestaResponse example

HTTP/1.1 200 OK
Content-Length: 14
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
"governmentcommunitycloud"