Obter confirmação da aceitação do cliente do Contrato de Cliente Microsoft

  • Artigo
  • 3 minutos para ler

Aplica-se a: Centro de Parceiros

Não se aplica a: Partner Center operado pela 21Vianet | Centro de Parceiros para Microsoft Cloud for US Government

O recurso Do Acordo é atualmente suportado pelo Partner Center apenas na nuvem pública da Microsoft.

Este artigo explica como pode recuperar a confirmação da aceitação do Contrato de Cliente Microsoft por parte de um cliente.

Pré-requisitos

  • Se estiver a utilizar o Partner Center .NET SDK, é necessária a versão 1.14 ou mais recente.

  • Credenciais descritas na autenticação do Partner Center. Este cenário suporta apenas a autenticação App+User.

  • Uma ID do cliente (customer-tenant-id). Se não souber a identificação do cliente, pode procurar no painel do Centro de Parceiros. Selecione CSP no menu Partner Center, seguido por Clientes. Selecione o cliente da lista de clientes e, em seguida, selecione Conta. Na página conta do cliente, procure o ID da Microsoft na secção Informação da Conta do Cliente . O ID da Microsoft é o mesmo que o ID do cliente (customer-tenant-id).

.NET

Para obter confirmação(s) de aceitação do cliente que foi previamente fornecida:

  • Utilize a recolha IAggregatePartner.Customers e ligue para o método ById com o identificador de clientes especificado.

  • Pegue na propriedade Do Contratos e filtre os resultados para Contrato de Cliente Microsoft, chamando o método ByAgreementType.

  • Ligue para o método Get ou GetAsync .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

var customerAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

Uma amostra completa pode ser encontrada na classe GetCustomerAgreements do projeto de aplicações de teste de consola .

Pedido de DESCANSO

Para recuperar a confirmação da aceitação do cliente que foi previamente fornecida:

  1. Crie um pedido DE REST para recuperar a coleção Contratos para o cliente.

  2. Utilize o parâmetro de consulta de acordosoo para estender os resultados apenas para o Contrato de Cliente Microsoft.

Solicitar sintaxe

Utilize a seguinte sintaxe de pedido:

Método URI do pedido
GET {baseURL}/v1/clientes/{cliente-inquilino-id}/agreements?agreementType={agreement-type} HTTP/1.1

Parâmetros URI

Pode utilizar os seguintes parâmetros URI com o seu pedido:

Nome Tipo Necessário Descrição
cliente-inquilino-id GUID Yes O valor é um CustomerTenantId formatado guid que lhe permite especificar um cliente.
tipo de acordo cadeia (de carateres) No Este parâmetro devolve todos os metadados do acordo. Utilize este parâmetro para estender a resposta de consulta ao tipo de acordo específico. Os valores suportados são:

MicrosoftCloudAgreement que apenas inclui metadados de acordo do tipo MicrosoftCloudAgreement.

MicrosoftCustomerAgreement que apenas inclui metadados de acordo do tipo MicrosoftCustomerAgreement.

* que devolve todos os metadados do acordo. (Não utilize * a menos que o seu código tenha a lógica necessária para lidar com tipos de acordo inesperados.)

Nota: Se o parâmetro URI não for especificado, a consulta predefine o MicrosoftCloudAgreement para retrocompatibilidade. A Microsoft pode introduzir metadados de acordo com novos tipos de acordo a qualquer momento.

Cabeçalhos do pedido

Para obter mais informações, consulte os cabeçalhos Partner Center REST.

Corpo do pedido

Nenhum.

Exemplo de pedido

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements?agreementType=MicrosoftCustomerAgreement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

Resposta do REST

Se for bem sucedido, este método devolve uma recolha de recursos do Acordo no organismo de resposta.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de estado HTTP que indica sucesso ou falha e informações adicionais de depuragem.

Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte os códigos de erro do Partner Center REST.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-26T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}