Pobieranie wszystkich informacji analitycznych dotyczących wyszukiwania
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 analizy wyszukiwania 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/search HTTP/1.1 |
Parametry identyfikatora URI
| Parametr | Type | opis |
|---|---|---|
filter |
string | Zwraca dane pasujące do warunku filtru. Przykład: .../search?filter=field eq 'value' |
groupby |
string | Obsługuje zarówno terminy, jak i daty. Logika zwarć w celu ograniczenia liczby zasobników. Przykład: .../search?groupby=termField1,dateField1,termField2 |
| aggregationLevel | string | Parametr aggregationLevel wymaga parametru groupby. Parametr aggregationLevel ma zastosowanie do wszystkich pól daty znajdujących się w obiekcie groupby. Przykład: .../search?groupby=termField1,dateField1,termField2&aggregationLevel=day |
top |
string | Limit strony to 10000. Przyjmuje dowolną wartość mniejszą niż 10000. Przykład: .../search?top=100 |
skip |
string | Liczba wierszy do pominięcia. Przykład: .../search?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/search 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 wyszukiwania .
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 inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów.
Przykład odpowiedzi
{
"companyName": "my company",
"contactButtonClicked": false,
"keywordCountry": null,
"detailsViewed": true,
"keywordIndustryFocus": null,
"mpnId": 2604568,
"partnerMarket": "CN",
"keywordProduct": null,
"referralSubmitted": false,
"searchDate": "2018-05-30",
"keywordSearchText": " my company"
}