Udostępnij za pośrednictwem

Pobieranie wszystkich informacji analitycznych dotyczących odsprzedawców pośrednich

  • Artykuł

Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

Jak uzyskać wszystkie informacje analityczne odsprzedawców pośrednich dla klientów.

Wymagania wstępne

  • Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń użytkownika.

Żądanie REST

Składnia żądania

Method Identyfikator URI żądania
GET {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

Parametry identyfikatora URI

Parametr Type Opis
partnerTenantId string Identyfikator dzierżawy partnera, dla którego chcesz pobrać dane odsprzedawców pośrednich.
identyfikator string Identyfikator odsprzedawcy pośredniego
nazwa string Nazwa partnera, dla którego chcesz pobrać dane odsprzedawców pośrednich.
rynek string Rynek partnera, dla którego chcesz pobrać dane odsprzedawców pośrednich.
firstSubscriptionCreationDate ciąg w formacie daty i godziny UTC Data utworzenia pierwszej subskrypcji, na podstawie której chcesz pobrać dane odsprzedawców pośrednich.
latestSubscriptionCreationDate ciąg w formacie daty i godziny UTC Data utworzenia najnowszej subskrypcji.
firstSubscriptionEndDate ciąg w formacie daty i godziny UTC Po raz pierwszy subskrypcja została zakończona.
latestSubscriptionEndDate ciąg w formacie daty i godziny UTC Najpóźniejsza data zakończenia subskrypcji.
firstSubscriptionSuspendedDate ciąg w dacie UTC o godzinie Po raz pierwszy każda subskrypcja została zawieszona.
latestSubscriptionSuspendedDate ciąg w formacie daty i godziny UTC Najpóźniejsza data wstrzymania subskrypcji.
firstSubscriptionDeprovisionedDate ciąg w formacie daty i godziny UTC Po raz pierwszy anulowano aprowizowaną subskrypcję.
latestSubscriptionDeprovisionedDate ciąg w formacie daty i godziny UTC Najpóźniejsza data anulowania aprowizacji subskrypcji.
subscriptionCount double Liczba subskrypcji dla wszystkich odsprzedawców dodanych wartości
licenseCount double Liczba licencji dla wszystkich odsprzedawców dodanych wartości.
indirectResellerCount double Liczba odsprzedawców pośrednich
najpopularniejsze string Liczba wierszy danych do zwrócenia w żądaniu. Wartość maksymalna i wartość domyślna, jeśli nie zostanie określona, to 10 000. Jeśli w zapytaniu znajduje się więcej wierszy, treść odpowiedzi zawiera następny link, którego można użyć do żądania następnej strony danych.
skip int Liczba wierszy do pominięcia w zapytaniu. Użyj tego parametru, aby stronicować za pośrednictwem dużych zestawów danych. Na przykład top=10000 and skip=0 pobiera pierwsze 10 000 wierszy danych, top=10000 and skip=10000 pobiera kolejne 10 000 wierszy danych itd.
filtr string Parametr filtru żądania zawiera co najmniej jedną instrukcję, która filtruje wiersze w odpowiedzi. Każda instrukcja zawiera pole i wartość skojarzoną z operatorami eq lub ne , a instrukcje można łączyć przy użyciu polecenia and lub or. Możesz określić następujące pola:

partnerTenantId
id
Nazwa/nazwisko
rynek
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Przykład:
.../indirectresellers?filter=market eq 'US'

Przykład:
.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))
aggregationLevel string Określa zakres czasu, dla którego mają być pobierane agregowane dane. Może być jednym z następujących ciągów: "day", "week" lub "month". Jeśli nie określono, wartość domyślna to "dzień".

aggregationLevel program nie jest obsługiwany bez elementu aggregationLevel. aggregationLeveldotyczy wszystkich pól dat znajdujących się w obiekcieaggregationLevel
orderby string Instrukcja, która porządkuje wartości danych wynikowych dla każdej instalacji. Składnia jest następująca: ...&orderby=field[order],field [order],... Parametr pola może być jednym z następujących ciągów:

"partnerTenantId"
"id"
"name"
"rynek"
"firstSubscriptionCreationDate"
"latestSubscriptionCreationDate"
"firstSubscriptionEndDate"
"latestSubscriptionEndDate"
"firstSubscriptionSuspendedDate"
"latestSubscriptionSuspendedDate"
"firstSubscriptionDeprovisionedDate"
"latestSubscriptionDeprovisionedDate"
"subscriptionCount"
"licenseCount"

Parametr order jest opcjonalny i może być asc lub desc; aby określić kolejność rosnącą lub malejącą dla każdego pola. Wartość domyślna to asc.

Przykład:
...&orderby=market,subscriptionCount
grupowanie string Instrukcja, która stosuje agregację danych tylko do określonych pól. Możesz określić następujące pola:

partnerTenantId
Identyfikator
Nazwa/nazwisko
rynek
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Zwrócone wiersze danych zawierają pola określone w klauzuli groupby i następujące pola:

indirectResellerCount
licenseCount
subscriptionCount

Parametr groupby może być używany z parametrem aggregationLevel .

Przykład:
...&groupby=ageGroup,market&aggregationLevel=week

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Brak.

Przykład żądania

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/indirectresellers HTTP 1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

Odpowiedź REST

W przypadku powodzenia treść odpowiedzi zawiera kolekcję zasobów odsprzedawców pośrednich.

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.

Przykład odpowiedzi

{
    "partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "id": "1111111",
    "name": "RESELLER NAME",
    "market": "US",
    "firstSubscriptionCreationDate": "2016-10-18T19:16:25.107",
    "latestSubscriptionCreationDate": "2016-10-18T19:16:25.107",
    "firstSubscriptionEndDate": "2018-11-07T00:00:00",
    "latestSubscriptionEndDate": "2018-11-07T00:00:00",
    "firstSubscriptionSuspendedDate": "0001-01-01T00:00:00",
    "latestSubscriptionSuspendedDate": "0001-01-01T00:00:00",
    "firstSubscriptionDeprovisionedDate": "0001-01-01T00:00:00",
    "latestSubscriptionDeprovisionedEndDate": "0001-01-01T00:00:00",
    "subscriptionCount": 10,
    "licenseCount": 20
}

Zobacz też