Obtenir toutes les informations analytiques sur la recherche

Article
07/18/2024

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

Comment obtenir toutes les informations d’analyse de recherche pour vos clients.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend uniquement en charge l’authentification avec les informations d’identification de l’utilisateur.

Demande REST

Syntaxe de la requête

Méthode	URI de demande
GET	{baseURL}/partner/v1/analytics/search HTTP/1.1

Paramètres d’URI

Paramètre	Type	Description
`filter`	string	Retourne des données correspondant à la condition de filtre. Exemple: `.../search?filter=field eq 'value'`
`groupby`	string	Prend en charge les termes et les dates. Logique de court-circuit pour limiter le nombre de compartiments. Exemple: `.../search?groupby=termField1,dateField1,termField2`
aggregationLevel	string	Le paramètre aggregationLevel nécessite un `groupby`. Le `aggregationLevel` paramètre s’applique à tous les champs de date présents dans le `groupby`. Exemple: `.../search?groupby=termField1,dateField1,termField2&aggregationLevel=day`
`top`	string	La limite de page est de 1 0000. Prend une valeur inférieure à 1 0000. Exemple: `.../search?top=100`
`skip`	string	Nombre de lignes à ignorer. Exemple: `.../search?top=100&skip=100`

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la demande

Aucune.

Exemple de requête

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

Réponse REST

En cas de réussite, le corps de la réponse contient une collection de ressources de recherche .

Codes d’erreur et de réussite de la réponse

Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et des informations de débogage supplémentaires. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur.

Exemple de réponse

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

Voir aussi

Analytique de l’Espace partenaires - Ressources

Partager via