Noms de ressources

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
numéro client:
"1234567890"
ID du groupe d'annonces:
"54321098765"
identifiant de l'annonce du groupe d'annonces:
"2109876543210"
ID de collection
"customers"
"adGroupAds"

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:

Diagramme illustrant la relation entre les noms de ressources et les hiérarchies de comptes

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.