Sdílet prostřednictvím

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. Zatím není podporované zaměření pouze na aplikace. 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 pouze přístup uživatelů, kde partneři musí být v jedné z následujících rolí: Agent pro správu 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. Datový proud souboru je buď .csv soubor, nebo komprimovaná verze souboru ZIP .csv. Podrobnosti o tom, jak vyžádat komprimované soubory, následují.

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ě těchto 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 vyfouknout Nepovinné. Pokud tento parametr vynecháte, stream souboru není komprimovaný.

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. Datový proud souboru je buď .csv soubor, nebo komprimovaná verze souboru ZIP .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 ==============

Související obsah