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 lehetőség még nem támogatott. Azoknak a partnereknek, akik HTTP-hibát:400 tapasztalnak, a Partner API hitelesítési dokumentációjában kell tájékozódniuk.
  • 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: Rendszergazdai ü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 egy .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.

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 húr Nem A kért árlistának YYYYMM formátumú dátumot kell tartalmaznia.

Kérelemfejlécek

Ezen fejlécek mellett 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 a következő fejlécértéket kell megadnia. 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éktípus Érték Leírás
Elfogadja a kódolást karakterlánc csökkent Opcionális. Ha nincs megadva, a fájlstream nem lesz 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 egy .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 ==============

Kapcsolódó tartalom