Manage orders - Get a list of offers for a market (by customer)

Usługa:

Partner Center Rest

Wersja interfejsu API:

v1

Pobiera wszystkie oferty partnera przy użyciu identyfikatora klienta.

GET https://api.partnercenter.microsoft.com/v{version}/customers/{customerId}/offers

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
customerId	path	True	string	Identyfikator klienta
version	path	True	string
offer_category_id	query		string	Identyfikator kategorii oferty. Opcjonalny parametr. Filtry oferty według kategorii po podaniu
offset	query		integer int32	Przesunięcie strony. Opcjonalny parametr
size	query		integer int32	Rozmiar strony. Opcjonalny parametr

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Authorization	True	string	Token elementu nośnego autoryzacji
ms-correlationid		string	Służy do śledzenia żądań wewnętrznie. Jeśli nie podano identyfikatora ms-correlationid, serwer wygeneruje nowy dla każdego żądania
MS-CV		string	Służy do śledzenia żądań wewnętrznie. Jeśli nie podano MS-CV, serwer wygeneruje nowy dla każdego żądania
ms-requestid		string	Służy do idempotentności żądań. Jeśli nie podano identyfikatora ms-requestid, serwer wygeneruje nowy dla każdego żądania

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ResourceCollection[Contracts.V1.Models.Offer]	Żądanie zakończyło się pomyślnie. Żądane informacje o ofertach partnera są zwracane w treści odpowiedzi. Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definicje

Nazwa	Opis
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

Nazwa	Typ	Opis
id	string
name	string
type	string
unit	string

Contracts.V1.Models.Offer

Nazwa	Typ	Opis
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

Nazwa	Typ	Opis
attestationType	string
enforceAttestation	boolean

Contracts.V1.Models.OfferCategory

Nazwa	Typ	Opis
attributes	ResourceAttributes
country	string
id	string
links	ResourceLinks
locale	string
name	string
rank	integer

Contracts.V1.Models.OfferLinks

Nazwa	Typ	Opis
learnMore	Link
next	Link
previous	Link
self	Link

Link

Nazwa	Typ	Opis
body	string
headers	System.Collections.Generic.KeyValuePair[System.String,System.String][]
method	string
uri	string

ResourceAttributes

Nazwa	Typ	Opis
etag	string
objectType	string

ResourceCollection[Contracts.V1.Models.Offer]

Nazwa	Typ	Opis
attributes	ResourceAttributes
items	Contracts.V1.Models.Offer[]
links	ResourceLinks
totalCount	integer

ResourceLinks

Nazwa	Typ	Opis
next	Link
previous	Link
self	Link

SupportedBillingCycles

Nazwa	Typ	Opis
annual	string
monthly	string
none	string
one_time	string
triennial	string
unknown	string

SupportedCatalogTypes

Nazwa	Typ	Opis
live	string
sandbox	string

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

Nazwa	Typ	Opis
key	string
value	string