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

Статья
09/27/2024

Применимо к:

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

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

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

Примечание.

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

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

Необходимые компоненты

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

Запрос REST

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

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

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

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

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

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

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

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

нет

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

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

Категория ограничений	Значение ограничения	Тип ограничения	Description
SeatConstraints	MinSeats	SubscriptionQuantity	Минимальные места, необходимые для того, чтобы клиент был иметь право на промо.
SeatConstraints	MaxSeats	SubscriptionQuantity	К акции можно применить максимальное количество мест.
AssetOwnershipLimits	MinAssets	LifetimeRedemptionCount	Минимальное количество раз, когда промоуция может применяться для клиента, обычно 0.
AssetOwnershipLimits	MaxAssets	LifetimeRedemptionCount	Максимальное количество раз, когда рекламные акции могут быть применены для клиента.
ДоступностьConstraints	isApplicable	FirstPurchase	Флаг, указывающий, должен ли он быть первым приобретением номера SKU продукта для получения промо.
ProductOwnershipConstraints	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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

Ответ REST

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

Коды успешного выполнения и ошибок в ответе

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

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

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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"
                }
            ]
        ]
    }
}

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