Hiérarchie des noms
Les noms de ressources utilisés dans l'API Google Ads sont hiérarchiques et reflètent la
organisation d'entités au sein de Google Ads. Presque toutes les ressources sont des sous-ressources
des Customer
qui reflète le fait que presque tous les appels d'API doivent cibler
un compte Google Ads spécifique. (campagnes, groupes d'annonces, annonces et mots clés, par exemple)
sont toutes des sous-ressources d'une ressource de client racine.
Ressource | Nom de la ressource |
---|---|
Client | customers/1234567890
|
Campagne | 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 ressource dans l'API. Toutefois, il est important de noter que la ressource peuvent avoir une ressource numérique unique d'identifiants qui identifient chaque objet de la hiérarchie. Dans ce cas, il peut être utile d'analyser le nom de 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
Ces ID peuvent être décomposés en ID de ressource individuels (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 dériver de nouveaux noms de ressources à référencer
le 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 compte Google Ads spécifique. client. Toutefois, certains types d'objets peuvent être partagés plusieurs comptes. En pratique, il s'agit, par exemple, de mots clés à exclure de mots clés ou multi-comptes actions de conversion qui sont généralement créés par les responsables, puis partagés avec de nombreux comptes clients.
Les noms de ressources des objets de ce type varient vers lequel vous envoyez un appel d'API.
Exemple: Actions de conversion multicompte
Supposons que nous avons un compte administrateur 987-654-3210
qui partage un compte multicompte
action de conversion avec l'un de ses comptes client 123-456-7890
:
Vous pouvez effectuer un appel d'API vers le compte administrateur pour mettre à jour la conversion, par exemple.
la période d'analyse de l'action doit faire référence à l'objet partagé à l'aide du nom de ressource:
customers/9876543210/conversionActions/257733534
Vous effectuez un appel d'API vers le compte client pour activer l'utilisation du
l'action de conversion la référence à l'aide du nom de ressource:
customers/1234567890/conversionActions/257733534
Il s'agit de la même action de conversion sous-jacente, mais son nom de ressource est relatif. au compte utilisé pour y accéder.