Získání matice nabídek

  • Článek

Tento článek vysvětluje, jak získat matici nabídek pro daný měsíc. Matice nabídek obsahuje vlastnosti a pravidla nákupu pro produkty a skladové položky. Tato metoda podporuje filtry pro získání historie po měsíci.

Požadavky

  • Přihlašovací údaje, jak je popsáno v ověřování rozhraní Partner API. Tento scénář podporuje pouze ověřování uživatelů aplikace. Aplikace zatím není podporovaná. Partneři, kteří mají chybu HTTP:400 , by se měli podívat do dokumentace k ověřování rozhraní Partner API.
  • Toto rozhraní API v současné době podporuje přístup uživatelů pouze v případě, že partneři musí být v jedné z následujících rolí: globální Správa, Správa agent nebo prodejní agent.

Detaily

  • Aktuální vrací data pouze pro aktualizované produkty založené na obchodních licencích.
  • Aktuální ceny zahrnují produkty dostupné během aktuálního měsíce k datu, kdy se rozhraní API volá. Předchozí měsíce zahrnují datum od posledního dne vybraného měsíce.
  • Tato metoda vrací data jako datový proud souboru. Stream souboru je buď soubor .csv, nebo komprimovaná verze souboru ZIP souboru .csv. Podrobnosti o tom, jak vyžádat komprimované soubory, najdete níže.

Požadavek REST

Syntaxe požadavku

metoda Identifikátor URI žádosti
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value

Parametry filtru identifikátoru URI

Použijte následující parametry filtru.

Name Type Požadováno Popis
Month string No Musí dodržovat YYYYMM pro požadovaný ceník.

Záhlaví žádosti

Kromě výše uvedených hlaviček se cenové soubory dají načíst jako komprimované snížení šířky pásma a doby stahování. Ve výchozím nastavení nejsou soubory komprimované. Pokud chcete získat komprimované verze souborů, můžete zahrnout následující hodnotu hlavičky. Uvědomte si, že komprimované listy jsou k dispozici pouze od dubna 2020, všechny listy před dubnem 2020 jsou k dispozici pouze tak, jak nejsou komprimované.

Hlavička Typ hodnoty Hodnota Popis
Accept-Encoding string Deflaci Nepovinné. Pokud není vynechán datový proud souboru, není komprimován.

Příklad požadavku

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

Odpověď REST

V případě úspěchu vrátí tato metoda matici nabídky jako datový proud souboru. Stream souboru je buď soubor .csv, nebo komprimovaná verze souboru ZIP souboru .csv.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi

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 ==============

Další kroky