Obtener revendedores indirectos de un clienteGet indirect resellers of a customer

Se aplica aApplies To

  • Centro de partnersPartner Center

Cómo obtener una lista de los revendedores indirectos que tienen una relación con un cliente especificado.How to get a list of the indirect resellers that have a relationship with a specified 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 recuperar una lista de los revendedores indirectos con los que el cliente especificado tiene una relación, primero obtenga una interfaz para las operaciones de recopilación de clientes para el cliente específico de la propiedad [partnerOperations. customers/dotnet/API/Microsoft.Store.partnercenter.ipartner.Relationships) proporcionando el identificador de cliente para identificar al cliente.To retrieve a list of indirect resellers with whom the specified customer has a relationship, first get an interface to customer collection operations for the specific customer from the [partnerOperations.Customers/dotnet/api/microsoft.store.partnercenter.ipartner.relationships) property by providing the customer ID to identify the customer. A continuación, llame al método [Relationships. Get/dotnet/API/Microsoft.Store.partnercenter.Relationships.icustomerrelationshipcollection.Get) o [Get _ Async/dotnet/API/Microsoft.Store.partnercenter.Relationships.icustomerrelationshipcollection.GetAsync) para obtener la lista de revendedores indirectos.Then call the [Relationships.Get/dotnet/api/microsoft.store.partnercenter.relationships.icustomerrelationshipcollection.get) or [Get_Async/dotnet/api/microsoft.store.partnercenter.relationships.icustomerrelationshipcollection.getasync) method to get the list of indirect resellers.

// IAggregatePartner partnerOperations;
// string customerId;

 var indirectResellers = partnerOperations.Customers[customerId].Relationships.Get();

Ejemplo: Console test appproyectode aplicación de prueba de consola: clasede ejemplos del SDK del centro de Partners: GetIndirectResellersOfCustomer.CSSample: Console test appProject: Partner Center SDK Samples Class: GetIndirectResellersOfCustomer.cs

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET {baseurl}/v1/customers/{customer-ID}/Relationships http/1.1{baseURL}/v1/customers/{customer-id}/relationships HTTP/1.1

Parámetro de URIURI parameter

Use el siguiente parámetro de ruta de acceso para identificar al cliente.Use the following path parameter to identify the customer.

NombreName TipoType ObligatorioRequired DescripciónDescription
customer-idcustomer-id stringstring Yes Cadena con formato de GUID que identifica al cliente.A GUID formatted string that identifies the customer.

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

Ninguno.None.

Ejemplo de solicitudRequest example

GET https://api.partnercenter.microsoft.com/v1/customers/c501c3c4-d776-40ef-9ecf-9cefb59442c1/relationships HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c9251710-5a30-4cd3-891a-c42d550af9a8
MS-CorrelationId: a96f326c-a392-44f4-bcfe-43152a756ba8
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Respuesta RESTREST response

Si se realiza correctamente, el cuerpo de la respuesta contiene una colección de recursos de PartnerRelationship para identificar a los revendedores.If successful, the response body contains a collection of PartnerRelationship resources to identify the resellers.

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 obtener la lista completa, consulte códigos de error del centro de Partners.For the full list, see Partner Center error codes.

Ejemplo de respuestaResponse example

HTTP/1.1 200 OK
Content-Length: 264
Content-Type: application/json; charset=utf-8
MS-CorrelationId: a96f326c-a392-44f4-bcfe-43152a756ba8
MS-RequestId: c9251710-5a30-4cd3-891a-c42d550af9a8
MS-CV: plJP3ufU0UqXMeuh.0
MS-ServerId: 020021921
Date: Fri, 07 Apr 2017 23:42:11 GMT

{
    "totalCount": 1,
    "items": [{
            "id": "484e548c-f5f3-4528-93a9-c16c6373cb59",
            "name": "First Up Consultants",
            "relationshipType": "is_indirect_cloud_solution_provider_of",
            "mpnId": "4847383",
            "attributes": {
                "objectType": "PartnerRelationship"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}