Share via


Alle zoekanalysegegevens ophalen

van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Hoe u alle zoekanalysegegevens voor uw klanten kunt ophalen.

Voorwaarden

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag-URI
GET {baseURL}/partner/v1/analytics/search HTTP/1.1

URI-parameters

Parameter Type Beschrijving
filter snaar Retourneert gegevens die overeenkomen met de filtervoorwaarde.
voorbeeld:
.../search?filter=field eq 'value'
groupby string Ondersteunt zowel termen als datums. Kortsluitingslogica om het aantal buckets te beperken.
voorbeeld:
.../search?groupby=termField1,dateField1,termField2
aggregatieniveau string Voor de parameter aggregationLevel is een groupbyvereist. De parameter aggregationLevel is van toepassing op alle datumvelden die aanwezig zijn in de groupby.
voorbeeld:
.../search?groupby=termField1,dateField1,termField2&aggregationLevel=day
top tekenreeks De paginalimiet is 10000. Neemt een waarde kleiner dan 10000.
voorbeeld:
.../search?top=100
skip snaar Het aantal rijen dat moet worden overgeslagen.
voorbeeld:
.../search?top=100&skip=100

Aanvraag-headers

Zie Partnercentrum REST-headersvoor meer informatie.

Verzoekinhoud

Geen.

Voorbeeldverzoek

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

REST-antwoord

Als dit lukt, bevat de hoofdtekst van het antwoord een verzameling Zoek bronnen.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die succes of falen aangeeft en extra informatie voor foutopsporing biedt. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Foutcodesvoor de volledige lijst.

Voorbeeld van antwoord

{
  "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"
}

Zie ook