Udostępnij za pośrednictwem

Uzyskiwanie macierzy ofert

  • Artykuł

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 jednostek 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. Uwierzytelnianie samej aplikacji nie jest jeszcze obsługiwane. 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

  • Bieżący zwraca dane tylko dla zaktualizowanych nowych produktów opartych na licencjach handlowych.
  • 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 żądaniu skompresowanych plików są zgodne.

Żądanie REST

Składnia żądania

Method Identyfikator URI żądania
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 Type Wymagania opis
Month string Nie Musi być zgodna z RRRRM dla żądanego arkusza cen.

Nagłówki żądań

  • Aby uzyskać więcej informacji, zobacz Nagłówki REST partnera.

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

Powiązana zawartość