La nouvelle API Search Ads 360 Reporting est désormais disponible. Rejoignez le groupe Google searchads-api-announcements pour vous tenir informé des améliorations et versions à venir.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Hiérarchie des noms
Les noms de ressources utilisés dans l'API Search Ads 360 Reporting sont hiérarchiques et reflètent l'organisation des entités dans Search Ads 360. Presque toutes les ressources sont des sous-ressources de la ressource Customer, ce qui reflète le fait que presque tous les appels d'API doivent cibler un compte Search Ads 360 spécifique. Par exemple, les campagnes, les groupes d'annonces, les annonces et les mots clés sont tous des sous-ressources d'une ressource client racine.
Les entités de l'API Search Ads 360 Reporting (clients, campagnes, etc.) sont désignées par leur nom de ressource dans l'API. Toutefois, il est important de noter que les noms de ressources peuvent eux-mêmes avoir des ID de ressource numériques uniques qui identifient chaque objet de la hiérarchie. Dans ce cas, il peut être utile d'analyser le nom de la ressource pour extraire ces ID de ressource et en assembler un nouveau.
Par exemple, examinez le nom de la ressource AdGroupAd dans le tableau précédent:
Vous pouvez le décomposer en ID de ressource individuels (séparés par des ID de collection) comme suit:
Composants du nom de la ressource
ID de ressource
numéro client:
"1234567890"
ID du groupe d'annonces:
"54321098765"
ID de l'annonce du groupe d'annonces:
"2109876543210"
ID de collection
"customers"
"adGroupAds"
L'analyse des ID individuels vous permet d'obtenir de nouveaux noms de ressources pour faire référence au client de l'annonce du groupe d'annonces (customers/1234567890) ou au groupe d'annonces (customers/1234567890/adGroupAds/54321098765).
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 2025/09/26 (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 2025/09/26 (UTC)."],[],["The Search Ads 360 Reporting API uses a hierarchical structure for resource names, with most resources being sub-resources of the `Customer`. Each resource has a unique numerical ID within its resource name. Resource names are relative and can be parsed to extract these IDs. These IDs allow for the derivation of new resource names, referencing parent entities, like the customer or ad group. The `resourceName` field, not `name`, is used in JSON bodies.\n"]]