Noms de ressources

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(e)	customers/1234567890
Campagne	customers/1234567890/campaigns/8765432109
AdGroup	customers/1234567890/adGroups/54321098765
AdGroupAd	customers/1234567890/adGroupAds/54321098765~2109876543210

Important :L'API Google Ads utilise des noms de ressources relative (et non des noms de ressources relative comme certaines autres API Google).

ID de ressource

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 de la table précédente:

customers/1234567890/adGroupAds/54321098765~2109876543210

Il peut être décomposé en ID de ressource individuels (séparés par un ID de collection) comme suit:

Composants des noms de ressources
ID de ressource	numéro client: "1234567890" ID du groupe d'annonces: "54321098765" identifiant des annonces 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 référencer le client de l'annonce du groupe d'annonces (customers/1234567890) ou son groupe d'annonces (customers/1234567890/adGroupAds/54321098765).

Important :Les noms de ressources dans les corps de requête et de réponse JSON sont désignés par le champ resourceName, et non par le champ name, comme dans certaines autres API Google Cloud. De nombreuses entités Google Ads possèdent elles-mêmes des attributs de nom (campaign.Name, adGroup.Name, etc.). Nous utilisons donc resourceName pour éviter les conflits avec les noms d'objets existants.

Identifiants des objets partagés

La plupart des objets de l'API sont associés à un seul client Google Ads spécifique. Cependant, certains types d'objets peuvent être partagés entre plusieurs comptes. En pratique, il s'agit de listes de mots clés à exclure ou d'actions de conversion multicompte généralement créées par des administrateurs, puis partagées avec de nombreux comptes client.

Les noms de ressources des objets de ce type diffèrent selon le compte auquel vous envoyez un appel d'API.

Exemple: Actions de conversion multicompte

Supposons que le compte administrateur 987-654-3210 partage une action de conversion multicompte avec l'un de ses comptes client clients 123-456-7890:

Si vous appelez l'API au compte administrateur pour mettre à jour la période d'analyse de l'action de conversion, par exemple, vous référencerez l'objet partagé sous le nom de ressource customers/9876543210/conversionActions/257733534.

Si vous appelez l'API sur le compte client pour activer l'action de conversion partagée, celle-ci sera référencée sous le 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 lié au compte utilisé pour y accéder.