按 ID 获取促销

  • 项目

适用于

  • 合作伙伴中心

相应的角色

  • 全局管理员
  • 管理员代理

注意

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

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

必备条件

  • 合作伙伴中心身份验证中所述的凭据。 此方案支持使用独立应用和 App+用户凭据进行身份验证。

  • 促销 ID 是表示特定提升的字符串集。

  • 国家/地区表示客户国家/地区促销可供使用。 国家/地区由两个字符的国家/地区代码表示。

REST 请求

请求语法

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

URI 参数

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

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

请求标头

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

请求正文

无

请求示例

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 Sep 2021 20:42:26 GMT

 
        {
            "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"
                        }
                    ]
                }
            ]
        }