Získání ceníku
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. 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ě se vracejí data pouze pro spotřebu plánů Azure a rezervace, licencované produkty v novém komerčním 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 volá rozhraní API. 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ď soubor .csv, nebo jeho verze komprimovaná do souboru zip. 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 | Typ | Požadováno | Popis |
|---|---|---|---|
| Trh | řetězec | Ano | Dvoumísmenný kód země/oblasti pro požadovaný trh |
| Zobrazení ceníku | řetězec | Ano | Typ požadovaného ceníku, který může být azure_consumption, azure_reservations, aktualizacelicensebased, marketplace nebo software. |
Poznámka:
Aktualizovaný PriceSheetView založený na licencích je aktuálně k dispozici pouze partnerům, kteří jsou součástí technického preview nové obchodní zkušenosti Microsoft 365/Microsoft Dynamics 365.
Poznámka:
Ceník licencí na konci prodeje je k dispozici pouze ke stažení prostřednictvím uživatelského rozhraní Partnerského centra.
Parametry filtru identifikátoru URI
Použijte následující parametry filtru.
| Name | Typ | Požadováno | Popis |
|---|---|---|---|
| Časová osa | string | Ne | Výchozí hodnota je aktuální, pokud není předána. Možné hodnoty jsou historie, aktuální a budoucí. |
| Měsíc | řetězec | Ne | Vyžaduje se pouze v případě, že je požadována historie, musí dodržovat YYYYMM pro požadovaný ceník. |
Poznámka:
Plánování cen do budoucna není pro Marketplace podporováno. Od 1. dubna 2022 budou partneři moci zobrazit historii ceníku softwaru prostřednictvím rozhraní API od března 2022.
Hlavičky žádosti
Kromě výše uvedených hlaviček lze cenové soubory stáhnout v komprimovaném formátu, což zmenšuje šířku pásma a dobu 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 | řetězec | vyfouknout | Nepovinné. Pokud je 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ý obchod
Poznámka:
Aktualizovaný nástroj PriceSheetView založený na licencích je aktuálně k dispozici pouze partnerům, kteří jsou součástí technického preview nového obchodního prostředí Microsoft 365/Microsoft Dynamics 365.
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 seznam cen jako datový proud souboru. Datový proud souboru je buď .csv soubor, nebo komprimovaná ZIP verze souboru .csv.
Příklad odpovědi pro nový obchod
Poznámka:
Aktualizovaný pohled na ceník založený na licencích je aktuálně dostupný pouze partnerům, kteří jsou součástí technického náhledu nové obchodní zkušenosti s Microsoft 365 nebo Microsoft Dynamics 365.
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 neočekávají žádné změny v novém ceníku pro budoucí komerční licence, nebude vrácen žádný budoucí ceník. Při předávání budoucích dat do časové osy, požadované pro aktualizovaný pohled na ceník založený na licenci, se partnerům zobrazí následující kód odpovědi rozhraní API: 404 - Nenalezeno.