Получите список предложений по переходу на полную версию после окончания пробного периода

Статья
03/07/2025

Как получить список предложений о конверсии пробного режима.

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

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

C#

Чтобы получить список доступных пробных преобразований, начните с метода IAggregatePartner.Customers.ByIdс идентификатором клиента, чтобы его идентифицировать. Затем получите интерфейс для операций подписки, вызвав метод Subscriptions.ById с идентификатором пробной подписки. Затем используйте свойство преобразования для получения интерфейса доступных операций с преобразованиями, а затем вызовите метод Get или GetAsync для получения коллекции доступных предложений преобразования.

// IAggregatePartner partnerOperations;
// string customerId;
// string subscriptionId;

// Get the available conversions.
var conversions =
    partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId).Conversions.Get();

ЗАПРОС REST

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

Метод	URI запроса
GET	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/conversions HTTP/1.1

Параметр URI

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

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

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

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

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

Нет.

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

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/conversions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e17f5bc6-24bf-4cbe-b632-d7fc6cec3058
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

ответ REST

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

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

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

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

HTTP/1.1 200 OK
Content-Length: 305
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e17f5bc6-24bf-4cbe-b632-d7fc6cec3058
MS-CV: feJByqU1X0ObaTQr.0
MS-ServerId: 030011719
Date: Thu, 15 Jun 2017 23:10:01 GMT

 {
    "totalCount": 1,
    "items": [{
            "offerId": "C0BD2E08-11AC-4836-BDC7-3712E744922F",
            "targetOfferId": "031C9E47-4802-4248-838E-778FB1D2CC05",
            "orderId": "D51A052E-043C-4A2A-AA37-2BB938CEF6C1",
            "quantity": 25,
            "billingCycle": "monthly",
            "attributes": {
                "objectType": "Conversion"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

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