Manage orders - Gets a product promotion by id.

按 ID 获取促销详细信息。

GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}?country={country}

URI 参数

名称 必需 类型 说明
id
path True

string

升级 ID。

version
path True

string

country
query

string

国家/地区代码。

请求头

名称 必需 类型 说明
Authorization True

string

授权持有者令牌

ms-correlationid

string

用于在内部跟踪请求。 如果未提供 ms-correlationid,则服务器将为每个请求生成一个新请求

MS-CV

string

用于在内部跟踪请求。 如果未提供 MS-CV,服务器将为每个请求生成一个新请求

ms-requestid

string

用于请求的幂等性。 如果未提供 ms-requestid,服务器将为每个请求生成一个新请求

响应

名称 类型 说明
200 OK

Contracts.V1.Models.ProductPromotion

请求成功。 响应正文将包含促销详细信息。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

400 Bad Request

输入缺失或无效。 响应正文将提供错误详细信息。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

401 Unauthorized

请求未通过身份验证。 客户端需要首先通过合作伙伴 API 服务进行身份验证。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

403 Forbidden

请求已经过身份验证,但被拒绝,因为调用方无权调用该请求。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

404 Not Found

找不到资源或未与给定输入参数一起使用。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

500 Internal Server Error

合作伙伴 API 服务或其某个依赖项未能满足请求。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

定义

名称 说明
Contracts.V1.Models.ProductPromotion
Contracts.V1.Models.ProductPromotionPricingPolicy
Contracts.V1.Models.ProductPromotionProperties
Contracts.V1.Models.ProductPromotionRequiredProduct
Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotion

名称 类型 说明
description

string

endDate

string

id

string

name

string

properties

Contracts.V1.Models.ProductPromotionProperties

requiredProducts

Contracts.V1.Models.ProductPromotionRequiredProduct[]

startDate

string

Contracts.V1.Models.ProductPromotionPricingPolicy

名称 类型 说明
policyType

string

value

string

Contracts.V1.Models.ProductPromotionProperties

名称 类型 说明
isAutoApplicable

boolean

Contracts.V1.Models.ProductPromotionRequiredProduct

名称 类型 说明
pricingPolicies

Contracts.V1.Models.ProductPromotionPricingPolicy[]

productId

string

skuId

string

term

Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotionTerm

名称 类型 说明
billingCycle

string

duration

string