Pobieranie arkusza cen
W tym artykule wyjaśniono, jak uzyskać arkusz cen dla danego rynku i zobaczyć. Ta metoda obsługuje filtry, aby uzyskać historię według miesiąca.
Wymagania wstępne
- Poświadczenia, jak opisano w Uwierzytelnianiu interfejsu API partnera. Ten scenariusz obsługuje tylko uwierzytelnianie użytkownika i aplikacji. Sama aplikacja nie jest jeszcze obsługiwana. Partnerzy, którzy doświadczają błędu HTTP:400, powinni zapoznać się z dokumentacją uwierzytelniania interfejsu API partnera.
- Ten interfejs API obsługuje obecnie tylko dostęp użytkowników, gdzie partnerzy muszą należeć do jednej z następujących ról: Agent administracyjny lub Agent sprzedaży.
Szczegóły
- Bieżące dane zwracane są tylko dla zużycia i rezerwacji planu Azure, produktów licencjonowanych w nowym środowisku handlowym oraz produktów z witryny Marketplace.
- Bieżące ceny obejmują wszystkie mierniki i produkty dostępne w bieżącym miesiącu do daty wywołania interfejsu API. Poprzednie miesiące obejmują wszystkie mierniki i produkty dostępne dla danego miesiąca.
- Ceny liczników zużycia są wyrażane tylko w USD, a partnerzy powinni korzystać z API kursów walut obcych do obliczania kosztów w walutach lokalnych.
- Ceny liczników zużycia są szacowanymi cenami detalicznymi. Dostępne są rabaty partnerskie poprzez partner earned credit.
- Ceny systemu rezerwacji obejmują rabaty dla partnerów CSP. Szacowane ceny detaliczne rezerwacji można znaleźć w pobranych materiałach usług wspólnych rezerwacji na stronie "Ceny i oferty" w Centrum partnerów.
- Więcej informacji na temat cennika planu platformy Azure można znaleźć w dokumentacji cennika planu platformy Azure.
- Interfejsy API wyceny partnerów i kursów walut nie są częścią zestawu SDK Centrum Partnerów.
- Ta metoda zwraca cennik jako strumień plików. Strumień plików jest plikiem .csv lub skompresowaną wersją .csv zip. Poniżej przedstawiono szczegółowe informacje na temat żądania skompresowanych plików.
Żądanie REST
Składnia żądania
| Metoda | Identyfikator URI żądania |
|---|---|
| GET | https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value |
Wymagane parametry identyfikatora URI
Użyj następujących parametrów ścieżki, aby zażądać rynku i typu arkusza cen.
| Nazwisko | Typ | Wymagane | opis |
|---|---|---|---|
| Rynek | string | Tak | Dwuliterowy kod kraju/regionu dla żądanego rynku |
| Widok Arkusza Cen | string | Tak | Żądany typ arkusza cen, który może być azure_consumption, azure_reservations, updated_licensebased, marketplace lub software. |
Uwaga
Zaktualizowany widok cennika oparty na licencji jest obecnie dostępny tylko dla partnerów, którzy są częścią nowego środowiska handlowego Microsoft 365/Microsoft Dynamics 365 w wersji technicznej zapoznawczej.
Uwaga
Cennik oparty na licencjach dla końca sprzedaży jest obecnie dostępny tylko do pobrania za pośrednictwem interfejsu użytkownika Centrum partnerskiego.
Parametry filtru identyfikatora URI
Użyj następujących parametrów filtru.
| Nazwisko | Typ | Wymagane | opis |
|---|---|---|---|
| Linia czasu | string | Nie | Wartość domyślna to current, jeśli nie została przekazana. Możliwe wartości to historia, bieżąca i przyszłość. |
| Miesiąc | string | Nie | Wymagane tylko wtedy, gdy jest żądana historia; musi być zgodne z formatem RRRRMM dla arkusza cen, o który jest prośba. |
Uwaga
Przyszłe ustalanie cen nie jest wspierane dla Marketplace. Od 1 kwietnia 2022 r. partnerzy będą mogli wyświetlać historię cennika oprogramowania za pośrednictwem interfejsu API, począwszy od historii z marca 2022 r.
Nagłówki żądań
- Aby uzyskać dodatkowe informacje, zobacz Nagłówki partnera REST.
Oprócz powyższych nagłówków pliki cenowe można pobierać jako skompresowane, zmniejszając przepustowość i czas pobierania. Domyślnie pliki nie są kompresowane. Aby uzyskać skompresowane wersje plików, możesz uwzględnić poniższą wartość nagłówka. Należy pamiętać, że skompresowane arkusze są dostępne tylko od kwietnia 2020 r., wszystkie arkusze przed kwietniem 2020 r. są dostępne tylko jako nieskompresowane.
| Nagłówek | Typ wartości: | Wartość | opis |
|---|---|---|---|
| Accept-Encoding | string | wypuścić powietrze | Opcjonalny. Jeśli pominięty strumień plików nie jest skompresowany. |
Przykład żądania
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
Przykład wniosku dla nowego handlu
Uwaga
updatedlicensebased PriceSheetView jest obecnie dostępny tylko dla partnerów, którzy są częścią platformy Microsoft 365/Microsoft Dynamics 365 nowego środowiska handlowego w wersji 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
Odpowiedź REST
Jeśli ta metoda powiedzie się, ta metoda zwraca cennik jako strumień plików. Strumień plików jest plikiem .csv lub skompresowaną wersją .csv zip.
Przykład odpowiedzi dla nowego handlu
Uwaga
updatedlicensebased PriceSheetView jest obecnie dostępny tylko dla partnerów, którzy uczestniczą w technicznym podglądzie nowego modelu handlowego Microsoft 365/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 ==============
Kody powodzenia i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i inne informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów.
Jeśli nie oczekuje się żadnych zmian w nowej cenniku opartym na licencjach handlowych, nie zostanie zwrócony żaden przyszły cennik. Po przekazaniu przyszłości na osi czasu żądanej dla zaktualizowanego PriceSheetView opartego na licencji, partnerzy zobaczą następujący kod odpowiedzi API: 404 Nie znaleziono.