Partager via


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

Récupère toutes les offres d’un partenaire à l’aide de l’ID client.

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

Paramètres URI

Nom Dans Obligatoire Type Description
customerId
path True

string

ID du client

version
path True

string

offer_category_id
query

string

Identificateur de catégorie d’offre. Paramter facultatif. Filtre les offres par catégorie lorsqu’elles sont fournies

offset
query

integer

int32

Décalage de page. Paramètre facultatif

size
query

integer

int32

Taille de la page. Paramètre facultatif

En-tête de la demande

Nom Obligatoire Type Description
Authorization True

string

Jeton du porteur d’autorisation

ms-correlationid

string

Utilisé pour le suivi des demandes en interne. Si un ms-correlationid n’est pas fourni, le serveur en génère un nouveau pour chaque requête

MS-CV

string

Utilisé pour le suivi des demandes en interne. Si un MS-CV n’est pas fourni, le serveur en génère un nouveau pour chaque requête

ms-requestid

string

Utilisé pour l’idempotency des requêtes. Si un ms-requestid n’est pas fourni, le serveur en génère un nouveau pour chaque requête

Réponses

Nom Type Description
200 OK

ResourceCollection[Contracts.V1.Models.Offer]

La demande a réussi. Les informations sur les offres du partenaire demandées sont retournées dans le corps de la réponse.

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

Définitions

Nom 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

Nom Type Description
id

string

name

string

type

string

unit

string

Contracts.V1.Models.Offer

Nom Type 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

Nom Type Description
attestationType

string

enforceAttestation

boolean

Contracts.V1.Models.OfferCategory

Nom Type Description
attributes

ResourceAttributes

country

string

id

string

links

ResourceLinks

locale

string

name

string

rank

integer

Nom Type Description
learnMore

Link

next

Link

previous

Link

self

Link

Nom Type Description
body

string

headers

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

method

string

uri

string

ResourceAttributes

Nom Type Description
etag

string

objectType

string

ResourceCollection[Contracts.V1.Models.Offer]

Nom Type Description
attributes

ResourceAttributes

items

Contracts.V1.Models.Offer[]

links

ResourceLinks

totalCount

integer

Nom Type Description
next

Link

previous

Link

self

Link

SupportedBillingCycles

Nom Type Description
annual

string

monthly

string

none

string

one_time

string

triennial

string

unknown

string

SupportedCatalogTypes

Nom Type Description
live

string

sandbox

string

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

Nom Type Description
key

string

value

string