Alle analysegegevens van zoeken ophalen

Artikel
06/19/2023

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud for US Government

Hoe u alle zoekanalysegegevens voor uw klanten kunt ophalen.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met alleen gebruikersreferenties.

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameters

Parameter	Type	Beschrijving
filter	tekenreeks	Retourneert gegevens die overeenkomen met de filtervoorwaarde. Voorbeeld: `.../search?filter=field eq 'value'`
groupby	tekenreeks	Ondersteunt zowel termen als datums. Kortsluitingslogica om het aantal buckets te beperken. Voorbeeld: `.../search?groupby=termField1,dateField1,termField2`
aggregationLevel	tekenreeks	Voor de parameter aggregationLevel is een groupby vereist. 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 elke waarde kleiner dan 10000. Voorbeeld: `.../search?top=100`
skip	tekenreeks	Aantal rijen dat u wilt overslaan. Voorbeeld: `.../search?top=100&skip=100`

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen.

Voorbeeld van aanvraag

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 antwoordtekst een verzameling zoekresources .

Geslaagde respons- en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die een geslaagde of mislukte status aangeeft en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor 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

Partnercentrum Analytics - Bronnen

Delen via