Megosztás a következőn keresztül:

Ajánlati mátrix lekérése

  • Cikk

Ez a cikk azt ismerteti, hogyan kérhet le ajánlati mátrixot egy adott hónapra. Az ajánlati mátrix tartalmazza a termékek és termékváltozatok tulajdonságait és vásárlási szabályait. Ez a módszer támogatja a szűrőket, hogy hónap szerint lekérje az előzményeket.

Előfeltételek

  • Hitelesítő adatok a Partner API-hitelesítésben leírtak szerint. Ez a forgatókönyv csak az alkalmazásfelhasználói hitelesítést támogatja. A csak alkalmazás még nem támogatott. A http-hibát:400 hibát tapasztaló partnereknek a Partner API hitelesítési dokumentációjában kell tájékozódnia.
  • Ez az API jelenleg csak olyan felhasználói hozzáférést támogat, ahol a partnereknek a következő szerepkörök egyikében kell lenniük: globális Rendszergazda, Rendszergazda ügynök vagy értékesítési ügynök.

Részletek

  • A jelenlegi csak a frissített új kereskedelmi licencalapú termékek adatait adja vissza.
  • A jelenlegi díjszabás az aktuális hónapban az API meghívásáig elérhető termékeket tartalmazza. Az előző hónapok tartalmazzák a kijelölt hónap utolsó napjának dátumát.
  • Ez a metódus fájlstreamként adja vissza az adatokat. A fájlstream .csv fájl vagy a .csv tömörített zip-verziója. A tömörített fájlok kérésének részletei az alábbiakban találhatók.

REST-kérés

Kérés szintaxisa

Metódus Kérés URI-ja
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value

URI-szűrőparaméterek

Használja a következő szűrőparamétereket.

Név Típus Kötelező Leírás
Hónap karakterlánc Nem Meg kell felelnie az YYYYMM-nek a kért árlista esetében.

Kérésfejlécek

A fenti fejléceken kívül a díjszabási fájlok tömörítettként is lekérhetők, csökkentve a sávszélességet és a letöltési időt. Alapértelmezés szerint a fájlok nem lesznek tömörítve. A fájlok tömörített verzióinak lekéréséhez az alábbi fejlécértéket is megadhatja. Tudja meg, hogy a tömörített lapok csak 2020 áprilisától érhetők el, a 2020 áprilisa előtti lapok csak nem tömörítettként érhetők el.

Fejléc Érték típusa Érték Leírás
Accept-Encoding sztring Deflate Opcionális. Ha a kihagyott fájlstream nincs tömörítve.

Példa kérése

GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='202101')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

REST-válasz

Ha sikeres, ez a metódus egy ajánlati mátrixot ad vissza fájlstreamként. A fájlstream .csv fájl vagy a .csv tömörített zip-verziója.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Hibakódok című témakörben találja.

Példa válaszra

HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=updatedoffice.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT

"ProductTitle","ProductId","SkuId","SkuTitle","ProvisioningId","ProvisioningString","MinLicenses","MaxLicenses","AssetOwnershipLimit","AssetOwnershipLimitType","ProductSkuPreRequisites","ProductSkuConversion","Description","AllowedCountries" 
"Microsoft 365 Business Basic","CFQ7TTC0LH18","0001","Microsoft 365 Business Basic","3b555118-da6a-4418-894f-7df1e2096870","O365_BUSINESS_ESSENTIALS","1","300","2","ConcurrentCount","","CFQ7TTC0LDPB/0001,CFQ7TTC0LF8Q/0001","Best for businesses that need professional...","AD;AE;AF;AG;AI;AL;AM;AO..."
======= Truncated ==============

További lépések