Obter o perfil da empresa de um cliente

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government

Obtém o perfil da empresa de um cliente.

Pré-requisitos

• Credenciais, conforme descrito em Autenticação do Partner Center. Este cenário dá suporte somente à autenticação com credenciais 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. Selecione o espaço de trabalho Clientes na página inicial do Partner Center. Selecione o cliente na lista Cliente e, em seguida, selecione Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Detalhes da Conta do Cliente. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).

Importante

A chamada da API Get Customer Company Profile não retornará os seguintes atributos na resposta se o parceiro não tiver acesso DAP no locatário do cliente. Caso contrário, ele retornará todos os atributos listados no exemplo de resposta.

• CompanyProfileAddress
• CompanyProfileEmail
• Domíniopersonalizado

C#

Para obter o perfil da empresa para um cliente, chame o método IAggregatePartner.Customers.ById com o ID do cliente para identificar o cliente. Em seguida, obtenha a interface ICustomerProfileCollection do cliente da propriedade Profiles para acessar sua propriedade Company. Em seguida, obtenha a interface ICustomerReadonlyProfile da propriedade ICustomerProfileCollection.Company e chame seus métodos Get() ou GetAsync().

// IAggregatePartner partnerOperations;
// string customerId;

var companyProfile = partnerOperations.Customers.ById(customerId).Profiles.Company.Get();

Exemplo: Baixe o SDK do Partner Center. Projeto: PartnerSdk.FeatureSamples Classe: GetCustomerCompanyProfile.cs

Java

O SDK Java do Partner Center pode ser usado para gerenciar recursos do Partner Center. É um projeto de código aberto mantido pela comunidade de parceiros e não é oficialmente suportado pela Microsoft. Caso se depare com um problema, você pode obter ajuda da comunidade ou abrir um problema no GitHub.

Para obter o perfil da empresa de um cliente, chame a função IAggregatePartner.getCustomers().byId com o identificador do cliente para identificar o cliente. Em seguida, obtenha a interface ICustomerProfileCollection do cliente da função [getProfiles] para acessar sua propriedade Company. Em seguida, obtenha a interface ICustomerReadonlyProfile da função ICustomerProfileCollection.getCompany e chame a função get.

// IAggregatePartner partnerOperations;
// String customerId;

CustomerCompanyProfile companyProfile = partnerOperations.getCustomers().byId(customerId).getProfiles().getCompany().get();

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
GET	{baseURL} /v1/clientes / {cliente-tenant-id} / perfis/da empresa HTTP/1.1

Parâmetro do URI

Use o parâmetro de consulta a seguir para obter o perfil da empresa.

Nome	Digitar	Obrigatório	Descrição
id de locatário do cliente	guid	Y	O valor é um ID de cliente-locatário formatado por GUID que permite ao revendedor filtrar os resultados de um determinado cliente que pertence ao revendedor.

Cabeçalhos de 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/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/profiles/company HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0b6f039c-e4b5-4b9e-bdac-b39077bb60da
MS-CorrelationId: ffa9174c-dbcb-47de-b70d-10e640a7f1b4
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Resposta REST

Se bem-sucedido, esse método retorna informações 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 êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 488
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ffa9174c-dbcb-47de-b70d-10e640a7f1b4
MS-RequestId: 0b6f039c-e4b5-4b9e-bdac-b39077bb60da
MS-CV: /e74N8OrkE29ycwZ.0
MS-ServerId: 101112202
Date: Wed, 04 Jan 2017 19:48:51 GMT

{
    "tenantId": "4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04",
    "domain": "dtdemocspcustomer005.onmicrosoft.com",
    "companyName": "DT Demo CSP Customer 005",
    "address": {
        "country": "US",
        "region": "WA",
        "city": "Redmond ",
        "addressLine1": "1 Microsoft Way",
        "postalCode": "98052",
        "phoneNumber": "4155551212"
    },
    "email": "daniel@hotmail.com.tw",
    "links": {
        "self": {
            "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/profiles/company",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "CustomerCompanyProfile"
    }
}