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 dotyczące analizy wyszukiwania dla swoich klientów.
Warunki wstępne
- Poświadczenia zgodnie z opisem w uwierzytelnianie w Centrum Partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń użytkownika.
Żądanie REST
Składnia żądania
Metoda | Identyfikator URI żądania |
---|---|
GET | {baseURL}/partner/v1/analytics/search HTTP/1.1 |
Parametry identyfikatora URI
Parametr | Typ | Opis |
---|---|---|
filter |
struna | Zwraca dane pasujące do warunku filtru. przykład : .../search?filter=field eq 'value' |
groupby |
struna | Obsługuje zarówno terminy, jak i daty. Logika zwarć w celu ograniczenia liczby zasobników. przykład : .../search?groupby=termField1,dateField1,termField2 |
poziom agregacji | struna | Parametr agregacji Level wymaga groupby . Parametr aggregationLevel ma zastosowanie do wszystkich pól daty znajdujących się w groupby . przykład : .../search?groupby=termField1,dateField1,termField2&aggregationLevel=day |
top |
struna | Limit strony to 10000. Przyjmuje dowolną wartość mniejszą niż 10000. przykład : .../search?top=100 |
skip |
struna | Liczba wierszy do pominięcia. przykład : .../search?top=100&skip=100 |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki Centrum Partnerskiego REST.
Treść żądania
Żaden.
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 sukcesu i błędów w odpowiedziach
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"
}
Zobacz też
- analiza Centrum partnerskiego — zasoby