Udostępnij za pośrednictwem

Uzyskaj wszystkie informacje analityczne dotyczące 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 dotyczące odsprzedawców pośrednich dla klientów.

Warunki wstępne

Żądanie REST

Składnia żądania

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

Parametry identyfikatora URI

Parametr Typ Opis
partnerTenantId struna ID dzierżawy tego partnera, dla którego chcesz pobrać dane odsprzedawców pośrednich.
id struna Identyfikator odsprzedawcy pośredniego
nazwa struna Nazwa partnera, dla którego chcesz pobrać dane odsprzedawców pośrednich.
rynek struna Rynek partnera, dla którego chcesz pobrać dane odsprzedawców pośrednich.
dataUtworzeniaPierwszejSubskrypcji ciąg w formacie daty i godziny UTC Data utworzenia pierwszej subskrypcji, na podstawie której chcesz pobrać dane odsprzedawców pośrednich.
najnowszaDataUtworzeniaSubskrypcji ciąg w formacie daty i godziny UTC Data utworzenia najnowszej subskrypcji.
dataZakończeniaPierwszejSubskrypcji ciąg w formacie daty i godziny UTC Po raz pierwszy jakakolwiek subskrypcja została anulowana.
najpóźniejszaDataZakończeniaSubskrypcji ciąg w formacie daty i godziny UTC Najpóźniejsza data zakończenia subskrypcji.
dataPierwszegoZawieszeniaSubskrypcji ciąg znaków formatujący datę i czas w UTC Po raz pierwszy każda subskrypcja została zawieszona.
data zawieszenia ostatniej subskrypcji ciąg w formacie daty i godziny UTC Najpóźniejsza data wstrzymania subskrypcji.
dataPierwszejDezaktywacjiSubskrypcji ciąg w formacie daty i godziny UTC Po raz pierwszy jakakolwiek subskrypcja została odprowizowana.
data ostatniego dezaktywowania subskrypcji ciąg w formacie daty i godziny UTC Ostatnia data dezaktywacji subskrypcji.
liczbaSubskrypcji podwójny Liczba subskrypcji wszystkich odsprzedawców z wartością dodaną
liczba licencji podwójny Liczba licencji dla wszystkich odsprzedawców z wartością dodaną.
liczba pośrednich sprzedawców podwójny Liczba odsprzedawców pośrednich
Do góry struna 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.
pominąć Int Liczba wierszy do pominięcia w zapytaniu. Użyj tego parametru, aby przeglądać duże zestawy danych. Na przykład top=10000 and skip=0 pobiera pierwsze 10 000 wierszy danych, top=10000 and skip=10000 pobiera następne 10 000 wierszy danych itd.
filtr struna Filtr oraz parametr żądania zawierają jedno lub więcej wyrażeń filtrujących wiersze w odpowiedzi. Każda instrukcja zawiera pole i wartość skojarzoną z operatorami eq lub ne, a instrukcje mogą być łączone przy użyciu and lub or. Możesz określić następujące pola:

partnerTenantId
id
nazwa
rynek
dataPierwszejSubskrypcji
najbardziej aktualnaDataUtworzeniaSubskrypcji
data zakończenia pierwszej subskrypcji
latestSubscriptionEndDate
pierwszaDataZawieszeniaSubskrypcji
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))
poziom agregacji struna 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 nie jest obsługiwany bez aggregationLevel. aggregationLevel dotyczy wszystkich pól dat obecnych w aggregationLevel
orderby struna Instrukcja, która porządkuje wartości danych wynikowych dla każdej instalacji. Składnia jest ...&orderby=field[order],field [order],.... Parametr pola może być jednym z następujących ciągów:

"partnerTenantId"
"id"
imię
rynek
"dataPierwszegoUtworzeniaSubskrypcji"
dataUtworzeniaNajnowszejSubskrypcji
dataZakończeniaPierwszejSubskrypcji
"najnowszaDataZakonczeniaSubskrypcji"
dataPierwszegoZawieszeniaSubskrypcji
"latestSubscriptionSuspendedDate"
pierwszaDataDezaktywacjiSubskrypcji
"dataWyłączeniaNajnowszejSubskrypcji"
liczba subskrypcji
liczbaLicencji

Parametr kolejności jest opcjonalny i może być asc lub desc; w celu określenia kolejności rosnącej lub malejącej dla każdego pola. Wartość domyślna to asc.

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

partnerTenantId
identyfikator
nazwa
rynek
dataPierwszejRejestracjiSubskrypcji
dataUtworzeniaNajnowszejSubskrypcji
firstSubscriptionEndDate
latestSubscriptionEndDate
dataPierwszegoZawieszeniaSubskrypcji
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
data najnowszej dezaktywacji subskrypcji

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

indirectResellerCount
liczbaLicencji
liczba subskrypcji

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 Partnerów.

Treść żądania

Żaden.

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ę odsprzedawców pośrednich zasobów.

Kody sukcesów 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ż