Manage orders - Get a list of offers for a market

使用国家/地区和区域设置信息检索合作伙伴的所有产品/服务。

GET https://api.partnercenter.microsoft.com/v{version}/offers
GET https://api.partnercenter.microsoft.com/v{version}/offers?country={country}&offer_category_id={offer_category_id}&offset={offset}&size={size}

URI 参数

名称 必需 类型 说明
version
path True

string

country
query

string

国家/地区信息。 国家/地区的两个字母表示形式

offer_category_id
query

string

产品/服务类别标识符。 可选参数。 提供时按类别筛选产品/服务

offset
query

integer

int32

页面偏移量。 可选参数

size
query

integer

int32

页面大小。 可选参数

请求头

名称 必需 类型 说明
Authorization True

string

授权持有者令牌

ms-correlationid

string

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

MS-CV

string

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

ms-requestid

string

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

响应

名称 类型 说明
200 OK

ResourceCollection[Contracts.V1.Models.Offer]

请求成功。 请求的合作伙伴的产品/服务信息在响应正文中返回。

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

定义

名称 说明
Contracts.V1.Models.Enums.OfferProduct
Contracts.V1.Models.Offer
Contracts.V1.Models.OfferAttestationProperties
Contracts.V1.Models.OfferCategory
Contracts.V1.Models.OfferLinks
Link
ResourceAttributes
ResourceCollection[Contracts.V1.Models.Offer]
ResourceLinks
SupportedBillingCycles
SupportedCatalogTypes
System.Collections.Generic.KeyValuePair[System.String,System.String]

Contracts.V1.Models.Enums.OfferProduct

名称 类型 说明
id

string

name

string

type

string

unit

string

Contracts.V1.Models.Offer

名称 类型 说明
acquisitionType enum:
  • purchase
  • referral
actions

string[]

additionalProperties

object

attestationProperties

Contracts.V1.Models.OfferAttestationProperties

attributes

ResourceAttributes

billing enum:
  • license
  • none
  • usage
category

Contracts.V1.Models.OfferCategory

conversionTargetOffers

string[]

country

string

description

string

hasAddOns

boolean

id

string

isAddOn

boolean

isAutoRenewable

boolean

isAvailableForPurchase

boolean

isInternal

boolean

isMicrosoftProduct

boolean

isTrial

boolean

limit

integer

limitUnitOfMeasure

string

links

Contracts.V1.Models.OfferLinks

locale

string

maximumQuantity

integer

minimumQuantity

integer

name

string

orderService

string

prerequisiteOffers

string[]

product

Contracts.V1.Models.Enums.OfferProduct

providerId

string

providerLocationId

string

providerName

string

rank

integer

reselleeQualifications

string[]

resellerQualifications

string[]

salesGroupId

string

supportedBillingCycles

SupportedBillingCycles[]

supportedCatalogTypes

SupportedCatalogTypes[]

term

integer

termUnitOfMeasure

string

unitType

string

upgradeTargetOffers

string[]

uri

string

Contracts.V1.Models.OfferAttestationProperties

名称 类型 说明
attestationType

string

enforceAttestation

boolean

Contracts.V1.Models.OfferCategory

名称 类型 说明
attributes

ResourceAttributes

country

string

id

string

links

ResourceLinks

locale

string

name

string

rank

integer

名称 类型 说明
learnMore

Link

next

Link

previous

Link

self

Link

名称 类型 说明
body

string

headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

名称 类型 说明
etag

string

objectType

string

ResourceCollection[Contracts.V1.Models.Offer]

名称 类型 说明
attributes

ResourceAttributes

items

Contracts.V1.Models.Offer[]

links

ResourceLinks

totalCount

integer

名称 类型 说明
next

Link

previous

Link

self

Link

SupportedBillingCycles

说明
annual
monthly
none
one_time
triennial
unknown

SupportedCatalogTypes

说明
live
sandbox

System.Collections.Generic.KeyValuePair[System.String,System.String]

名称 类型 说明
key

string

value

string