다음을 통해 공유


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 매개 변수

Name In(다음 안에) 필수 형식 Description
version
path True

string

country
query

string

국가 정보입니다. 국가의 두 글자 표현

offer_category_id
query

string

제품 범주 식별자입니다. 선택적 매개 변수입니다. 제공된 경우 범주별 필터 제공

offset
query

integer

int32

페이지 오프셋입니다. 선택적 매개 변수

size
query

integer

int32

페이지 크기입니다. 선택적 매개 변수

요청 헤더

Name 필수 형식 Description
Authorization True

string

권한 부여 전달자 토큰

ms-correlationid

string

내부적으로 요청을 추적하는 데 사용됩니다. ms-correlationid가 제공되지 않으면 서버는 각 요청에 대해 새 상관 관계를 생성합니다.

MS-CV

string

내부적으로 요청을 추적하는 데 사용됩니다. MS-CV 제공되지 않으면 서버는 각 요청에 대해 새 MS-CV 생성합니다.

ms-requestid

string

요청의 idempotency에 사용됩니다. ms-requestid가 제공되지 않으면 서버는 각 요청에 대해 새 요청을 생성합니다.

응답

Name 형식 Description
200 OK

ResourceCollection[Contracts.V1.Models.Offer]

요청이 성공했습니다. 요청된 파트너의 제품 정보가 응답 본문에 반환됩니다.

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

정의

Name Description
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

Name 형식 Description
id

string

name

string

type

string

unit

string

Contracts.V1.Models.Offer

Name 형식 Description
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

Name 형식 Description
attestationType

string

enforceAttestation

boolean

Contracts.V1.Models.OfferCategory

Name 형식 Description
attributes

ResourceAttributes

country

string

id

string

links

ResourceLinks

locale

string

name

string

rank

integer

Name 형식 Description
learnMore

Link

next

Link

previous

Link

self

Link

Name 형식 Description
body

string

headers

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

method

string

uri

string

ResourceAttributes

Name 형식 Description
etag

string

objectType

string

ResourceCollection[Contracts.V1.Models.Offer]

Name 형식 Description
attributes

ResourceAttributes

items

Contracts.V1.Models.Offer[]

links

ResourceLinks

totalCount

integer

Name 형식 Description
next

Link

previous

Link

self

Link

SupportedBillingCycles

Name 형식 Description
annual

string

monthly

string

none

string

one_time

string

triennial

string

unknown

string

SupportedCatalogTypes

Name 형식 Description
live

string

sandbox

string

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

Name 형식 Description
key

string

value

string