Получать акции

Статья
03/08/2025

<strong>Применимо к</strong>

Центр партнеров

Соответствующие роли

Агент по администрированию

Примечание.

Новый коммерческий опыт для услуг на основе лицензий включает множество новых функций и доступен для всех поставщиков облачных решений (ПОСТАВЩИКОВ). Для получения дополнительной информации см. обзор новых коммерческих возможностей.

Партнеры могут получить список активных рекламных акций для данного рынка (страны или региона) и сегмента. Этот метод возвращает доступные текущие акции на основе доступных дат начала и окончания акции.

Предварительные требования

Учетные данные, описанные в разделе о проверке подлинности Центра партнеров. Этот сценарий поддерживает проверку подлинности с использованием как автономных учетных данных приложения, так и учетных данных приложения и пользователя.
Сегмент представляет тип клиента, для которых включены рекламные акции. В настоящее время поддерживается только коммерческая версия.
Страна/регион обозначает страну или регион клиента, для которых доступны акции. Страна представлена двумя символьными кодами страны.

Запрос REST

[GET] /v1/промоакциипродуктов?country={country-code}&segment={segment}

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

Способ	URI запроса
GET	{baseURL}/v1/productpromotions?country={country-code}&segment={segment} HTTP/1.1

Параметр универсального кода ресурса

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

Имя.	Тип	Обязательно	Описание
сегмент	string	Y	Строка, определяющая, какие акции доступны для данного сегмента.
страна	string	Y	Двухбуквенный код страны, определяющий, в каких странах или регионах доступны промоакции для клиентов.

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

Для получения дополнительной информации см. раздел заголовки REST в Центре партнеров.

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

нет

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

GET https://api.partnercenter.microsoft.com/v1/productpromotions?country=US&segment=commercial HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

Ответ REST

В случае успешного выполнения этот метод возвращает список рекламных акций.

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

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

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

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT


{
    "totalCount": 2,
    "items": [
        {
            "id": "39NFJQT1PJQB:0001:39NFJQT1Q5KN",
            "name": "Visio Plan 1",
            "description": "Visio Plan 1",
            "startDate": "2021-09-23T00:00:00+00:00",
            "endDate": "2021-10-14T23:59:59+00:00",
            "properties": {
                "isAutoApplicable": true
            },
            "requiredProducts": [
                {
                    "productId": "CFQ7TTC0HD33",
                    "skuId": "0003",
                    "term": {
                        "duration": "P1Y",
                        "billingCycle": "Annual"
                    },
                    "pricingPolicies": [
                        {
                            "policyType": "PercentDiscount",
                            "value": "0.05"
                        }
                    ]
                }
            ]
        },
        {
            "id": "39NFJQT1PJQC:0001:39NFJQT1Q5KM",
            "name": "Vision Plan 1",
            "description": "Vision Plan 1",
            "startDate": "2021-09-23T00:00:00+00:00",
            "endDate": "2021-10-14T23:59:59+00:00",
            "properties": {
                "isAutoApplicable": true
            },
            "requiredProducts": [
                {
                    "productId": "CFQ7TTC0HD33",
                    "skuId": "0003",
                    "term": {
                        "duration": "P1Y",
                        "billingCycle": "Monthly"
                    },
                    "pricingPolicies": [
                        {
                            "policyType": "PercentDiscount",
                            "value": "0.167"
                        }
                    ]
                }
            ]
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

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