Получить партнеров клиента

Статья
12/13/2024

применимо к: Центр партнеров

Как получить список косвенных торговых посредников или косвенных поставщиков, имеющих связь с указанным клиентом.

Необходимые условия

Активно регистрироваться в программе CSP в качестве косвенного поставщика или косвенного торгового посредника.
Учетные данные, как описано в аутентификации Партнерского центра. Этот сценарий поддерживает проверку подлинности только с учетными данными app+User.
Идентификатор клиента (customer-tenant-id). Если вы не знаете идентификатор клиента, его можно найти в Центре партнеров. Выберите рабочую область клиентов на домашней странице Центра партнеров. Выберите клиента в списке клиентов, а затем выберите Учетная запись. На странице "Учетная запись клиента" найдите идентификатор Microsoft в разделе данных учетной записи клиента. Идентификатор Майкрософт совпадает с идентификатором клиента (customer-tenant-id).

C#

Чтобы получить список косвенных торговых посредников или косвенных поставщиков, с которыми у указанного клиента есть отношения, сначала получите интерфейс к операциям сбора клиентов для конкретного клиента из свойства partnerOperations.Customers путем предоставления идентификатора клиента для идентификации клиента. Затем вызовите метод Relationships.Get или Get_Async, чтобы получить список косвенных торговых посредников.

// IAggregatePartner partnerOperations;
// string customerId;

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

Запрос REST

Ниже приведены сведения о запросе и ответе REST.

Синтаксис запроса

Метод	URI запроса
ПОЛУЧИТЬ	{baseURL}/v1/customers/{customer-id}/relationships HTTP/1.1

Параметр URI

Используйте следующий параметр пути для идентификации клиента.

Имя	Тип	Обязательно	Описание
идентификатор клиента	струна	Да	Отформатированная строка GUID, которая идентифицирует клиента.

Заголовки запросов

Дополнительные сведения см. в заголовках REST Центра партнеров.

Текст запроса

Нет.

Пример запроса

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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

ответ REST

В случае успешного выполнения текст ответа содержит коллекцию ресурсов PartnerRelationship для идентификации дистрибьюторов.

Коды успешных ответов и ошибок

Каждый ответ содержит код состояния HTTP, указывающий на успешность или сбой и дополнительные сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и дополнительных параметров. Полный список см. в Центре партнеров коды ошибок.

Пример ответа

HTTP/1.1 200 OK
Content-Length: 264
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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": "aaaa0000-aa11-2222-33cc-444444bbbbbb",
            "name": "First Up Consultants",
            "relationshipType": "is_indirect_cloud_solution_provider_of",
            "mpnId": "4847383",
            "attributes": {
                "objectType": "PartnerRelationship"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Поделиться через