Udostępnij za pośrednictwem

Pobieranie arkusza cen

  • Artykuł

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 zgodnie z opisem w temacie Uwierzytelnianie interfejsu API partnera. Ten scenariusz obsługuje tylko uwierzytelnianie użytkowników aplikacji. Tylko 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, w których partnerzy muszą należeć do jednej z następujących ról: Globalne Administracja, agent Administracja lub agent sprzedaży.

Szczegóły

  • Bieżący zwraca dane tylko dla użycia i rezerwacji planu platformy Azure, licencjonowanego (nowego środowiska handlowego) i 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 mierników zużycia są dostępne tylko w USD, a partnerzy używają interfejsu API kursy walut obcych do obliczania kosztów walut lokalnych.
  • Ceny mierników zużycia są szacowane ceny detaliczne. Rabaty partnerów są dostępne za pośrednictwem środków uzyskanych przez partnerów.
  • Ceny mierników rezerwacji obejmują rabaty dla partnerów CSP. Szacowane ceny detaliczne rezerwacji można znaleźć na stronie "Cennik i oferty" w Centrum partnerskim.
  • Więcej informacji na temat cennika planu platformy Azure można znaleźć w dokumentacji cennika planu platformy Azure.
  • Interfejsy API cen partnerów i walut nie są częścią zestawu SDK Centrum partnerskiego.
  • 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

Method 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 Type Wymagania opis
Rynek string Tak Dwuliterowy kod kraju/regionu dla żądanego rynku
PricesheetView string Tak Żądany typ arkusza cen, który może być azure_consumption, azure_reservations, zaktualizowanylicensebased, marketplace lub oprogramowanie.

Uwaga

updatedlicensebased PriceSheetView jest obecnie dostępny tylko dla partnerów, którzy są częścią platformy Microsoft 365/Microsoft Dynamics 365 — wersja zapoznawcza techniczna.

Uwaga

Cennik oprogramowania będzie dostępny za pośrednictwem interfejsu API od 1 kwietnia 2022 r.

Parametry filtru identyfikatora URI

Użyj następujących parametrów filtru.

Nazwisko Type Wymagania opis
Oś 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ść.
Month string Nie Wymagana tylko w przypadku żądania historii musi być zgodna z RRRR W przypadku żądanego arkusza cen.

Uwaga

Przyszłe ceny nie są obsługiwane w witrynie 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ć więcej informacji, zobacz Nagłówki REST partnera.

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 Deflate 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 żądania 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 — wersja zapoznawcza techniczna.

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 są częścią platformy Microsoft 365/Microsoft Dynamics 365 — wersja zapoznawcza techniczna.

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 ma żadnych zmian w nowej licencji handlowej opartej na przyszłej cenniku, nie zostanie zwrócony żaden przyszły cennik. Po przekazaniu przyszłości do osi czasu żądanej dla zaktualizowanej licencjibased PriceSheetView partnerzy zobaczą następujący kod odpowiedzi interfejsu API: 404 Nie znaleziono.

Następne kroki