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

Artigo
03/05/2024

Aplica-se a: Partner Center

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

No momento, o recurso Contrato é suportado pelo Partner Center apenas na nuvem pública da Microsoft.

Este artigo explica como você pode recuperar confirmações da aceitação de um cliente do Contrato de Cliente da Microsoft.

Pré-requisitos

Se você estiver usando o SDK do Partner Center .NET, a versão 1.14 ou mais recente será necessária.

Importante

A partir de junho de 2023, a versão 3.4.0 mais recente do SDK do Partner Center .NET foi arquivada. Você pode baixar a versão do SDK no GitHub, juntamente com um arquivo leiame que contém informações úteis.

Os parceiros são incentivados a continuar a usar as APIs REST do Partner Center.
Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte apenas à autenticação de aplicativo + de usuário.
Uma ID do cliente (customer-tenant-id). Se você não souber a ID do cliente, poderá procurá-la no Partner Center selecionando o espaço de trabalho Clientes, o cliente na lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).

.NET

Para recuperar confirmação(ões) de aceitação do cliente que foi fornecida anteriormente:

Use a coleção IAggregatePartner.Customers e chame o método ById com o identificador de cliente especificado.
Busque a propriedade Agreements e filtre os resultados para o Microsoft Customer Agreement chamando o método ByAgreementType.
Chame o método Get ou GetAsync .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

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

Um exemplo completo pode ser encontrado na classe GetCustomerAgreements do projeto de aplicativo de teste de console.

Solicitação REST

Para recuperar a confirmação de aceitação do cliente que foi fornecida anteriormente:

Crie uma solicitação REST para recuperar a coleção Agreements para o cliente.
Use o parâmetro de consulta agreementType para definir o escopo dos resultados somente para o Contrato de Cliente da Microsoft.

Sintaxe da solicitação

Use a seguinte sintaxe de solicitação:

Método	URI da solicitação
GET	{baseURL}/v1/customers/{customer-tenant-id}/agreements?agreementType={agreement-type} HTTP/1.1

Parâmetros do URI

Você pode usar os seguintes parâmetros de URI com sua solicitação:

Nome	Digitar	Obrigatória	Descrição
id de locatário do cliente	GUID	Sim	O valor é um CustomerTenantId formatado por GUID que permite especificar um cliente.
tipo de acordo	string	Não	Esse parâmetro retorna todos os metadados do contrato. Use esse parâmetro para definir o escopo da resposta da consulta para um tipo de contrato específico. Os valores suportados são: MicrosoftCloudAgreement que inclui apenas metadados de contrato do tipo MicrosoftCloudAgreement. MicrosoftCustomerAgreement que inclui apenas metadados de contrato do tipo MicrosoftCustomerAgreement. * que retorna todos os metadados do contrato. (Não use * a menos que seu código tenha a lógica necessária para lidar com tipos de contrato inesperados.) Nota: Se o parâmetro URI não for especificado, o padrão da consulta será MicrosoftCloudAgreement para compatibilidade com versões anteriores. A Microsoft pode introduzir metadados de contrato com novos tipos de contrato a qualquer momento.

Cabeçalhos da solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Nenhum.

Exemplo de solicitação

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: aaaa0000-bb11-2222-33cc-444444dddddd

Resposta REST

Se bem-sucedido, esse método retorna uma coleção de recursos de contrato no corpo da resposta.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e outras informações de depuração.

Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e outros parâmetros. Para obter a lista completa, confira Códigos de erro REST do Partner Center.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "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"
        }
    ]
}

Compartilhar via