Pobieranie wszystkich informacji analitycznych dotyczących poleceń
Dotyczy: Centrum partnerskie | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA
Jak uzyskać wszystkie informacje analityczne dotyczące poleceń 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/referrals HTTP/1.1 |
Parametry identyfikatora URI
| Parametr | Type | Opis |
|---|---|---|
| filtr | string | Zwraca dane pasujące do warunku filtru. Przykład: .../referrals?filter=field eq 'value' |
| grupowanie | string | Obsługuje zarówno terminy, jak i daty. Logika zwarć w celu ograniczenia liczby zasobników. Przykład: .../referrals?groupby=termField1,dateField1,termField2 |
| aggregationLevel | string | Parametr aggregationLevel wymaga grupy. Parametr aggregationLevel ma zastosowanie do wszystkich pól dat znajdujących się w grupie. Przykład: .../referrals?groupby=termField1,dateField1,termField2&aggregationLevel=day |
| najpopularniejsze | string | Limit strony to 10000. Przyjmuje dowolną wartość mniejszą niż 10000. Przykład: .../referrals?top=100 |
| skip | string | Liczba wierszy do pominięcia. Przykład: .../referrals?top=100&skip=100 |
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/referrals 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 Polecenia .
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
{
"id": "112310",
"status": "Accepted",
"customerMarket": "US",
"customerName": "Best Customer Ever",
"customerOrgSize": "10to50employees",
"acceptedDate": "2018-02-07T23:43:19",
"acknowledgedDate": "2018-02-07T23:40:50",
"archivedDate": null,
"declinedDate": null,
"expiredDate": null,
"lostDate": null,
"missedDate": null,
"createdDate": "2018-02-04T23:08:59",
"skippedDate": null,
"wonDate": null,
"partnerMarket": "US"
}