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

Important :L'API Google Ads utilise Noms de ressources relatifs (et non les noms de ressources complets comme certaines autres API Google).

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).

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 le name comme dans d'autres API Google Cloud. De nombreuses entités Google Ads ont des noms eux-mêmes (campaign.Name, adGroup.Name, etc.). resourceName permet d'é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 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.