Obtener el perfil de empresa del clienteGet a customer's company profile

Se aplica aApplies To

  • Centro de partnersPartner Center
  • Centro de partners operado por 21VianetPartner Center operated by 21Vianet
  • Centro de partners para Microsoft Cloud AlemaniaPartner Center for Microsoft Cloud Germany
  • Centro de partners para Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Obtiene el perfil de empresa de un cliente.Gets the company profile of a customer.

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, busca el Id. de Microsoft en la sección Información de la cuenta del 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 obtener el perfil de empresa de un cliente, llame al método colección iaggregatepartner. customers. ById con el identificador de cliente para identificar al cliente.To get the company profile for a customer, call the IAggregatePartner.Customers.ById method with the customer ID to identify the customer. A continuación, obtenga la interfaz ICustomerProfileCollection del cliente desde la propiedad profiles para tener acceso a su propiedad Company.Then get the customer's ICustomerProfileCollection interface from the Profiles property, in order to access its Company property. A continuación, obtenga la interfaz ICustomerReadonlyProfile de la propiedad ICustomerProfileCollection. Company y llame a los métodos get () o GetAsync () .Next, get the ICustomerReadonlyProfile interface from the ICustomerProfileCollection.Company property, and call its Get() or GetAsync() methods.

// IAggregatePartner partnerOperations;
// string customerId;

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

Ejemplo: descargar el SDK del centro de Partners.Sample: Download the Partner Center SDK. Proyecto: PartnerSdk. FeatureSamples ( clase): GetCustomerCompanyProfile.CSProject: PartnerSdk.FeatureSamples Class: GetCustomerCompanyProfile.cs

JavaJava

Los partners suelen usar el SDK de Java del Centro de partners para administrar los recursos del Centro de partners.The Partner Center Java SDK is commonly used by partners to manage their Partner Center resources. Se trata de un proyecto de código abierto que mantiene la comunidad de partners.It's an open-source project maintained by the partner community. Dado que este módulo lo mantiene la comunidad de partners, Microsoft no lo admite oficialmente.Since this module is maintained by the partner community, it isn't officially supported by Microsoft. Puedes obtener ayuda de la comunidad o abrir una incidencia en GitHub si se produce un problema.You can get help from the community or open an issue on GitHub if you experience a problem.

Para obtener el perfil de empresa de un cliente, llame a la función colección iaggregatepartner. getCustomers (). byId con el identificador de cliente para identificar al cliente.To get the company profile for a customer, call the IAggregatePartner.getCustomers().byId function with the customer identifier to identify the customer. A continuación, obtenga la interfaz de ICustomerProfileCollection del cliente de la función [getProfiles] para tener acceso a la propiedad de la empresa.Then get the customer's ICustomerProfileCollection interface from the [getProfiles] function, in order to access its Company property. A continuación, obtenga la interfaz ICustomerReadonlyProfile de la función ICustomerProfileCollection. getCompany y llame a la función Get .Next, get the ICustomerReadonlyProfile interface from the ICustomerProfileCollection.getCompany function, and call the get function.

// IAggregatePartner partnerOperations;
// String customerId;

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

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET {baseURL}/v1/customers/{customer-tenant-id}/profiles/company HTTP/1.1{baseURL}/v1/customers/{customer-tenant-id}/profiles/company HTTP/1.1

Parámetro de URIURI parameter

Use el siguiente parámetro de consulta para obtener el perfil de la empresa.Use the following query parameter to get the company profile.

NombreName TipoType ObligatorioRequired DescripciónDescription
customer-tenant-idcustomer-tenant-id guidguid YY 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.

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

NoneNone

Ejemplo de solicitudRequest example

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

Respuesta RESTREST response

Si es correcto, este método devuelve información en el cuerpo de la respuesta.If successful, this method returns information 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 ver la lista completa, consulte los códigos de error de REST del centro de Partners.For the full list, see Partner Center REST Error Codes.

Ejemplo de respuestaResponse example

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"
    }
}