Udostępnij za pośrednictwem


Uzyskaj macierz ofert

W tym artykule wyjaśniono, jak uzyskać macierz ofert dla danego miesiąca. Macierz ofert zawiera właściwości i reguły zakupu dla produktów i kodów SKU. 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żytkownika i aplikacji. Obsługa wyłącznie aplikacji nie jest jeszcze wspierana. 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: Agent administracyjny lub Agent sprzedaży.

Szczegóły

  • Obecnie zwracane są dane tylko dla produktów opartych na licencjach nowego modelu handlowego, które zostały zaktualizowane.
  • Bieżące ceny obejmują produkty dostępne w bieżącym miesiącu do daty wywołania interfejsu API. Poprzednie miesiące zawierają datę od ostatniego dnia wybranego miesiąca.
  • Ta metoda zwraca dane jako strumień plików. Strumień plików jest plikiem .csv lub skompresowaną wersją .csv zip. Szczegółowe informacje o tym, jak zażądać skompresowanych plików, znajdują się poniżej.

Żądanie REST

Składnia żądania

Metoda Żądanie URI
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value

Parametry filtru identyfikatora URI

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

Nazwisko Typ Wymagane opis
Miesiąc string Nie Musi być zgodna z RRRRM dla żądanego arkusza cen.

Nagłówki żądań

Oprócz tych 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ć następującą 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 rozprężyć Opcjonalny. W przypadku pominięcia strumień plików nie jest kompresowany.

Przykład żądania

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

Odpowiedź REST

W przypadku powodzenia ta metoda zwraca macierz ofert jako strumień plików. Strumień plików jest plikiem .csv lub skompresowaną wersją .csv zip.

Kody sukcesu i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów.

Przykład odpowiedzi

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 ==============