按 ID 获取促销

项目
09/28/2024

适用于

合作伙伴中心

相应的角色

管理员代理

注意

基于许可证的服务的新商业体验涵盖许多新功能，可供所有云解决方案提供商 (CSP) 使用。有关详细信息，请参阅新商业体验概述。

合作伙伴可以为给定的促销 ID 和国家/地区获取单个促销。此方法返回促销数据，忽略促销开始日期和结束日期。此方法主要用于对帐目的，以检索促销详细信息，即使在升级过期后也是如此。

先决条件

合作伙伴中心身份验证中所述的凭据。此方案支持使用独立应用和 App+User 凭据进行身份验证。
升级 ID 是表示特定提升的字符串集。
国家/地区表示客户国家/地区促销可供使用。国家/地区由两个字符的国家/地区代码表示。

REST 请求

请求语法

方法	请求 URI
GET	{baseURL}/v1/productpromotions/{promotion-id}？country={country-code HTTP/1.1

URI 参数

使用以下查询参数返回可用的促销。

名称	类型	必需	说明
promotion-id	string	Y	定义要检索的提升的字符串。
country	string	Y	一个两个字母国家/地区代码，用于确定哪些客户国家/地区促销可用。

请求标头

有关详细信息，请参阅合作伙伴中心 REST 标头。

请求正文

无

促销约束

促销约束现在由此 API 返回。请参阅以下响应中的示例。如果提升具有资格约束，则响应中会返回详细信息。此数据可用于了解客户是否有资格获得折扣。

约束类别	约束值	约束类型	说明
SeatConstraints	MinSeats	SubscriptionQuantity	客户有资格获得促销所需的最低席位。
SeatConstraints	MaxSeats	SubscriptionQuantity	促销可以应用于的最大席位。
AssetOwnershipLimits	MinAssets	LifetimeRedemptionCount	促销可以应用于客户的最小次数，通常为 0。
AssetOwnershipLimits	MaxAssets	LifetimeRedemptionCount	促销可应用于客户的最大次数。
EligibilityConstraints	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: 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"
                }
            ]
        ]
    }
}

通过