Поделиться через


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

string

monthly

string

none

string

one_time

string

triennial

string

unknown

string

SupportedCatalogTypes

Имя Тип Описание
live

string

sandbox

string

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

Имя Тип Описание
key

string

value

string