Ottenere tutte le informazioni sull'analisi della ricerca

Articolo
07/18/2024

Si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

Come ottenere tutte le informazioni di analisi della ricerca per i clienti.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta solo l'autenticazione con credenziali utente.

Richiesta REST

Sintassi della richiesta

metodo	URI della richiesta
GET	{baseURL}/partner/v1/analytics/search HTTP/1.1

Parametri URI

Parametro	Tipo	Descrzione
`filter`	stringa	Restituisce i dati corrispondenti alla condizione di filtro. Esempio: `.../search?filter=field eq 'value'`
`groupby`	string	Supporta sia termini che date. Logica di corto circuito per limitare il numero di bucket. Esempio: `.../search?groupby=termField1,dateField1,termField2`
aggregationLevel	string	Il parametro aggregationLevel richiede un oggetto `groupby`. Il `aggregationLevel` parametro si applica a tutti i campi di data presenti in `groupby`. Esempio: `.../search?groupby=termField1,dateField1,termField2&aggregationLevel=day`
`top`	string	Il limite di pagina è 10000. Accetta qualsiasi valore minore di 10000. Esempio: `.../search?top=100`
`skip`	string	Numero di righe da ignorare. Esempio: `.../search?top=100&skip=100`

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Corpo della richiesta

Nessuno.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, il corpo della risposta contiene una raccolta di risorse di ricerca .

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e informazioni di debug aggiuntive. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore.

Risposta di esempio

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

Vedi anche

Analisi del Centro per i partner - Risorse

Condividi tramite