Nomes de recursos

O identificador exclusivo de uma entidade na API Google Ads é chamado de nome de recurso e é representado como uma string com um formato previsível. Se você souber os componentes de um nome de recurso, use PathLookupUtil para gerar o nome final.

PathLookupUtil

O utilitário PathLookupUtil cria o nome do recurso de uma entidade quando você fornece todos os IDs relevantes relacionados a ela. Por exemplo, um nome de recurso de campanha usa o formato customers/{customer_id}/campaigns/{campaign_id}. Portanto, se você souber o ID do cliente e o ID da campanha, poderá usar client.path para construir o nome completo do recurso:

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)

Entidades compatíveis

Você também pode usar outros nomes de entidades em client.path, que aceitam IDs diferentes dependendo da hierarquia do nome do recurso:

  • Campanha:client.path.campaign(customer_id, campaign_id)
  • Grupo de anúncios:client.path.ad_group(customer_id, ad_group_id)
  • Anúncio do grupo de anúncios:client.path.ad_group_ad(customer_id, ad_group_id, ad_id)