Delen via


Manage orders - Gets a product promotion by id.

Hiermee haalt u promotiedetails op id op.

GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}?country={country}

URI-parameters

Name In Vereist Type Description
id
path True

string

De promotie-id.

version
path True

string

country
query

string

Het landnummer.

Aanvraagkoptekst

Name Vereist Type Description
Authorization True

string

Bearer-token voor autorisatie

ms-correlationid

string

Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen ms-correlationid is opgegeven, genereert de server een nieuwe voor elke aanvraag

MS-CV

string

Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen MS-CV is opgegeven, genereert de server een nieuwe voor elke aanvraag

ms-requestid

string

Wordt gebruikt voor idempotentie van aanvragen. Als er geen ms-requestid is opgegeven, genereert de server een nieuwe voor elke aanvraag

Antwoorden

Name Type Description
200 OK

Contracts.V1.Models.ProductPromotion

De aanvraag is geslaagd. De hoofdtekst van het antwoord bevat de details van de promotie.

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

400 Bad Request

Er is een ontbrekende of ongeldige invoer. De hoofdtekst van het antwoord bevat de foutdetails.

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

401 Unauthorized

De aanvraag is niet geverifieerd. De client moet eerst worden geverifieerd met de partner-API-service.

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

403 Forbidden

De aanvraag is geverifieerd, maar is geweigerd omdat de beller niet over de rechten beschikt om deze aan te roepen.

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

404 Not Found

De resource is niet gevonden of niet beschikbaar met de opgegeven invoerparameters.

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

500 Internal Server Error

De partner-API-service of een van de bijbehorende afhankelijkheden kan niet voldoen aan de aanvraag.

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

Definities

Name Description
Contracts.V1.Models.ProductPromotion
Contracts.V1.Models.ProductPromotionPricingPolicy
Contracts.V1.Models.ProductPromotionProperties
Contracts.V1.Models.ProductPromotionRequiredProduct
Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotion

Name Type Description
description

string

endDate

string

id

string

name

string

properties

Contracts.V1.Models.ProductPromotionProperties

requiredProducts

Contracts.V1.Models.ProductPromotionRequiredProduct[]

startDate

string

Contracts.V1.Models.ProductPromotionPricingPolicy

Name Type Description
policyType

string

value

string

Contracts.V1.Models.ProductPromotionProperties

Name Type Description
isAutoApplicable

boolean

Contracts.V1.Models.ProductPromotionRequiredProduct

Name Type Description
pricingPolicies

Contracts.V1.Models.ProductPromotionPricingPolicy[]

productId

string

skuId

string

term

Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotionTerm

Name Type Description
billingCycle

string

duration

string