Obter o perfil da empresa de um cliente

Artigo
07/25/2024

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 à API Obter Perfil da Empresa do Cliente não retornará os atributos a seguir de volta na resposta se o parceiro não tiver acesso DAP ou GDAP no locatário do cliente.

CompanyProfileAddress
CompanyProfileEmail
CustomDomain Pelo menos uma das seguintes funções GDAP é necessária para obter o e-mail CompanyProfileAddress e CompanyProfile.

Administrador Global
Gravador de diretório
Leitor global

Pelo menos uma das seguintes funções GDAP é necessária para obter o CustomDomain.

Administrador do Domínio
Leitores de Diretório
Administrador Global
Leitor global
Administrador de Identidade Híbrida

Para saber mais sobre as funções, consulte Funções internas da Microsoft.

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 software livre mantido pela comunidade de parceiros e não tem suporte oficial da 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ória	Descrição
id de locatário do cliente	guid	Y	O valor é um customer-tenant-id formatado em GUID que permite que o revendedor filtre os resultados de um determinado cliente que pertence ao revendedor.

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/aaaabbbb-0000-cccc-1111-dddd2222eeee/profiles/company HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0b6f039c-e4b5-4b9e-bdac-b39077bb60da
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Resposta REST

Se for bem-sucedido, esse método retornará 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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 0b6f039c-e4b5-4b9e-bdac-b39077bb60da
MS-CV: /e74N8OrkE29ycwZ.0
MS-ServerId: 101112202
Date: Wed, 04 Jan 2017 19:48:51 GMT

{
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "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/aaaabbbb-0000-cccc-1111-dddd2222eeee/profiles/company",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "CustomerCompanyProfile"
    }
}

Compartilhar via