Noms de ressources

L'identifiant unique d'une entité dans l'API Google Ads est appelé nom de ressource. Il est représenté sous la forme d'une chaîne avec un format prévisible. Si vous connaissez les composants d'un nom de ressource, vous pouvez utiliser PathLookupUtil pour générer le nom de ressource final.

PathLookupUtil

L'utilitaire PathLookupUtil construit le nom de ressource d'une entité lorsque vous fournissez tous les ID pertinents associés à cette entité. Par exemple, le nom de ressource d'une campagne utilise le format customers/{customer_id}/campaigns/{campaign_id}. Par conséquent, si vous connaissez l'ID client et l'ID de campagne, vous pouvez utiliser client.path pour construire le nom complet de la ressource :

require 'google/ads/google_ads'

client = Google::Ads::GoogleAds::GoogleAdsClient.new
customer_id = '1234567890'
campaign_id = '9876543210'

# Generates: "customers/1234567890/campaigns/9876543210"
campaign_resource_name = client.path.campaign(customer_id, campaign_id)

Entités acceptées

Vous pouvez également utiliser d'autres noms d'entités sur client.path, qui acceptent différents ID en fonction de la hiérarchie du nom de ressource :

  • Campagne : client.path.campaign(customer_id, campaign_id)
  • Groupe d'annonces : client.path.ad_group(customer_id, ad_group_id)
  • Annonce du groupe d'annonces : client.path.ad_group_ad(customer_id, ad_group_id, ad_id)