Hiérarchie des noms
Les noms de ressources utilisés dans l'API Google Ads sont hiérarchiques et reflètent l'organisation des entités dans Google Ads. 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 Google Ads 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.
| Ressource | Nom de la ressource |
|---|---|
| Client | customers/1234567890
|
| Priorité de la | customers/1234567890/campaigns/8765432109
|
| AdGroup | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
ID de ressources
Les entités Google Ads (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 eux-mêmes peuvent 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 ressource AdGroupAd du tableau précédent:
customers/1234567890/adGroupAds/54321098765~2109876543210
Il peut être décomposé en ID de ressource individuel (séparés par ID de collection) comme suit:
| Composants du nom de ressource | |||||||
|---|---|---|---|---|---|---|---|
| ID de ressources |
|
||||||
| ID de collection |
|
||||||
L'analyse des ID individuels vous permet de générer de nouveaux noms de ressources pour faire référence au client de l'annonce du groupe d'annonces (customers/1234567890) ou à son groupe d'annonces (customers/1234567890/adGroupAds/54321098765).
Identifiants des objets partagés
La plupart des objets de l'API sont associés à un seul client Google Ads spécifique. Toutefois, certains types d'objets peuvent être partagés entre plusieurs comptes. En pratique, il s'agit, par exemple, de listes de mots clés à exclure ou d'actions de conversion multicompte, qui sont généralement créées par les administrateurs, puis partagées avec de nombreux comptes client.
Les noms de ressources des objets de ce type diffèrent selon le compte vers lequel vous envoyez un appel d'API.
Exemple: Actions de conversion multicompte
Supposons que nous ayons un compte administrateur 987-654-3210 qui partage une action de conversion multicompte avec l'un de ses comptes client client 123-456-7890:
Si vous effectuez un appel d'API vers le compte administrateur pour mettre à jour la période d'analyse de l'action de conversion, par exemple, l'objet partagé sera référencé sous le nom de ressource customers/9876543210/conversionActions/257733534.
Si vous effectuez un appel d'API vers le compte client pour activer l'utilisation de l'action de conversion partagée, celui-ci sera référencé à l'aide du nom de ressource suivant : customers/1234567890/conversionActions/257733534.
Il s'agit de la même action de conversion sous-jacente, mais son nom de ressource dépend du compte utilisé pour y accéder.