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 au 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 d'une ressource de campagne utilise le format customers/{customer_id}/campaigns/{campaign_id}. Par conséquent, si vous connaissez le numéro client et l'ID de la 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 compatibles

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