Search Analytics
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La liste des méthodes associées à cette ressource est présentée au bas de la page.
Représentations de la ressource
Aucune donnée persistante n'est associée à cette ressource.
Méthodes
- query
interroger vos données de trafic de recherche à l'aide de filtres et de paramètres que vous définissez ; Cette méthode renvoie zéro ou plusieurs lignes regroupées en fonction des clés de ligne (dimensions) que vous définissez. Vous devez définir une plage de dates d'un ou plusieurs jours.
Lorsque "date" est l'une des dimensions, les jours sans données sont omis de la liste des résultats. Pour savoir quels jours comportent des données, lancez une requête sans filtres regroupés par date pour la plage de dates qui vous intéresse.
Les résultats sont triés par nombre de clics dans l'ordre décroissant. Si deux lignes ont le même nombre de clics, elles sont triées de manière arbitraire.
Consultez l'exemple Python pour appeler cette méthode.
L'API est limitée par des limitations internes de la Search Console et ne garantit pas de renvoyer toutes les
les lignes de données,
mais plutôt les premières.
Voir les limites relatives à la quantité de données disponible
Exemple de requête POST JSON:
POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query?key={MY_API_KEY}
{
"startDate": "2015-04-01",
"endDate": "2015-05-01",
"dimensions": ["country","device"]
}
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/08/29 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2024/08/29 (UTC)."],[[["The Search Analytics API allows you to query your website's search traffic data with custom filters and parameters, returning results grouped by specified dimensions."],["You can define date ranges for your queries, but the API might not return all data rows due to internal limitations, prioritizing top results instead."],["Results are sorted by click count in descending order, with arbitrary sorting for rows with identical click counts, and days without data are omitted from the result list."],["When querying with \"date\" as a dimension, you can identify days with data by performing a filter-less query grouped by date for the desired date range."],["The API offers a \"query\" method to retrieve search traffic data and provides a Python sample for utilizing this method."]]],[]]
