Získání ceníku

  • Článek

Tento článek vysvětluje, jak získat ceník pro daný trh a zobrazit. 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 využití plánů Azure a rezervace, licencované (nové komerční prostředí) a produkty Marketplace.
  • Aktuální ceny zahrnují všechny měřiče a produkty dostupné během aktuálního měsíce k datu, kdy se rozhraní API volá. Předchozí měsíce zahrnují všechny měřiče a produkty dostupné pro daný měsíc.
  • Ceny měřiče spotřeby jsou pouze v USD, partneři používají k výpočtu nákladů na místní měnu rozhraní API směnných kurzů.
  • Ceny měřiče spotřeby jsou odhadované maloobchodní ceny. Slevy za partnery jsou dostupné prostřednictvím kreditu získaného partnerem.
  • Ceny měřičů rezervací zahrnují slevy partnerů CSP. Odhadované maloobchodní ceny rezervací najdete ve sdílených službách ke stažení rezervací na stránce Ceny a nabídky v Partnerském centru.
  • Další informace o cenách plánů Azure najdete v dokumentaci k cenovým cenovým plánům Azure.
  • Rozhraní API pro ceny partnerů a devizové kurzy nejsou součástí sady SDK Partnerského centra.
  • Tato metoda vrátí ceník jako datový proud souborů. Datový proud souboru je buď .csv soubor, nebo komprimovaná verze souboru ZIP .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/pricesheets(Market='{market}',PricesheetView='{view}')/$value

Požadované parametry identifikátoru URI

K vyžádání požadovaného trhu a typu ceníku použijte následující parametry cesty.

Name Type Požadováno Popis
Trh string Ano Dvoumísmenný kód země/oblasti pro požadovaný trh
Zobrazení ceníku string Ano Typ požadovaného ceníku, který může být azure_consumption, azure_reservations, aktualizacelicensebased, marketplace nebo software.

Poznámka:

updatedlicensebased PriceSheetView je aktuálně k dispozici pouze partnerům, kteří jsou součástí Microsoftu 365 nebo Microsoft Dynamics 365 new commerce experience Technical Preview.

Poznámka:

Ceník softwaru bude k dispozici prostřednictvím rozhraní API od 1. dubna 2022.

Parametry filtru identifikátoru URI

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

Name Type Požadováno Popis
Časová osa string No Výchozí hodnota je aktuální, pokud není předána. Možné hodnoty jsou historie, aktuální a budoucí.
Month string No Vyžaduje se pouze v případě, že je požadována historie, musí dodržovat YYYYMM pro požadovaný ceník.

Poznámka:

Budoucí ceny se pro Marketplace nepodporují. Od 1. dubna 2022 budou partneři moci zobrazit historii ceníku softwaru prostřednictvím rozhraní API od března 2022.

Záhlaví žádosti

  • Další informace najdete v hlavičce REST partnera.

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 záhlaví. 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í komprimovaný.

Příklad požadavku

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='ad',PricesheetView='azure_consumption')/$value?timeline=history&month=201909 HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com

Příklad požadavku na nové obchodování

Poznámka:

updatedlicensebased PriceSheetView je aktuálně k dispozici pouze partnerům, kteří jsou součástí Microsoftu 365 nebo Microsoft Dynamics 365 new commerce experience Technical Preview.

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202101 HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

Odpověď REST

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

Příklad odpovědi pro nový obchod

Poznámka:

updatedlicensebased PriceSheetView je aktuálně k dispozici pouze partnerům, kteří jsou součástí Microsoftu 365 nebo Microsoft Dynamics 365 new commerce experience Technical Preview.

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

"ProductTitle","ProductId","SkuId","SkuTitle","Publisher","SkuDescription","UnitOfMeasure","TermDuration","BillingPlan","Market","Currency","UnitPrice","PricingTierRangeMin","PricingTierRangeMax","EffectiveStartDate","EffectiveEndDate","Tags","ERP Price"
"Advanced Communications","CFQ7TTC0HDK0","0001","Advanced Communications","Microsoft Corporation","Advanced meetings, calling, workflow integration, and management tools for IT.","","P1Y","Annual","US","USD","115.2","","","2/1/2019 12:00:00 AM","2/4/2021 8:35:31 PM","License","144"
======= Truncated ==============

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.

Pokud se u nového komerčního licenčního ceníku na základě budoucích cen neočekávají žádné změny, nebude vrácen žádný budoucí ceník. Při předávání budoucnosti na časovou osu požadovanou pro updatedlicensebased PriceSheetView se partnerům zobrazí následující kód odpovědi rozhraní API: 404 Nenalezena.

Další kroky