Получение повышения по идентификатору

Статья
03/07/2025

Применимо к

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

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

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

Примечание.

Новые торговые решения для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщиков облачных решений (CSP). Дополнительные сведения см. в обзоре новых коммерческих возможностей.

Партнеры могут получить одну акцию для указанного идентификатора и страны/региона. Этот метод возвращает данные о повышении, игнорируя даты начала и окончания продвижения. Этот метод используется в первую очередь для целей сверки, чтобы получить сведения об акции, даже после истечения ее срока действия.

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

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

Запрос REST

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

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

Параметр URI

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

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

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

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

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

нет

Рекламные ограничения

Ограничения рекламы теперь предоставляются этим API. См. примеры в приведенном ниже ответе. Если у акции есть ограничения на участие, сведения об этом возвращаются в ответе. Эти данные можно использовать для понимания того, относится ли клиент к скидке.

Категория ограничений	Значение ограничения	Тип ограничения	Описание
ОграниченияНаМеста	MinSeats	Количество подписок	Минимальные места, необходимые для того, чтобы клиент был иметь право на промо.
Ограничения сидений	MaxSeats	Количество подписок	Максимальное количество мест, к которым может быть применена акция.
Ограничения на владение активами	MinAssets	Общее количество погашений за всё время	Минимальное количество раз, когда промоуция может применяться для клиента, обычно 0.
Лимиты Владения Активами	MaxAssets	КоличествоПожизненныхПогашений	Максимальное количество раз, когда рекламные акции могут быть применены для клиента.
Ограничения по допустимости	Применимо	Первая покупка	Флаг, указывающий, должно ли это быть первым приобретением продукта по номеру SKU заказчика для получения промо.
ОграниченияНаПравоСобственностиНаПродукт	bigId	Н/П	Указанные предложения, которыми клиент уже должен владеть для участия в акции (номер SKU продукта).

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

GET https://api.partnercenter.microsoft.com/v1/productpromotions/CFQ7TTC0HD33:0003:CFQ7TTC0K59M?country=US 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, 24 Apr 2023 20:42:26 GMT

 
{
    "id": "39NFJQT1SNC7:0001:39NFJQT1Q5KM",
    "name": "TEST Promotion May 2023 - Microsoft 365 F3",
    "description": "TEST Promotion May 2023 - Microsoft 365 F3",
    "startDate": "2023-05-03T00:00:00+00:00",
    "endDate": "9999-01-01T00:00:00+00:00",
    "properties": {
        "isAutoApplicable": true
    },
    "requiredProducts": [
        {
            "productId": "CFQ7TTC0LH05",
            "skuId": "0001",
            "term": {
                "duration": "P1Y",
                "billingCycle": "Annual"
            },
            "pricingPolicies": [
                {
                    "policyType": "PercentDiscount",
                    "value": "0.5"
                }
            ]
        }
    ],
    "promotionConstraints": { 
        "seatConstraints": [
            {
                "minSeats": 10,
                "maxSeats": 100,
                "type": "SubscriptionQuantity"
            }
        ],
        "assetOwnershipLimits": [
            {
                "minAssets": 0,
                "maxAssets": 3,
                "type": "LifetimeRedemptionCount"
            }
        ],
        "eligibilityConstraints": [
            {
                "isApplicable": true,
                "type": "FirstPurchase"
            }
        ],
        "productOwnershipConstraints": [
            [
                {
                    "bigId": "CFQ7TTC0MBMD/0002"
                }
            ]
        ]
    }
}

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