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 constituintes de um nome de recurso, poderá gerar nomes de recursos usando métodos auxiliares presentes em muitos objetos de serviço.
Métodos de caminho de serviço
Todos os serviços projetados para processar a leitura ou mutação de tipos específicos de objetos na
API têm métodos auxiliares para construir nomes de recursos. Por exemplo, é possível
criar um nome de recurso para um objeto Campaign:
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
customer_id = "7892134783"
campaign_id = "1234567890"
campaign_service = client.get_service("CampaignService")
resource_name = campaign_service.campaign_path(customer_id, campaign_id)
Cada serviço também tem um método parse_*_path que desestrutura um nome de recurso em um dicionário de segmentos individuais ou retorna um dicionário vazio se a string não corresponder ao formato esperado:
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
resource_name = "customers/7892134783/campaigns/1234567890"
campaign_service = client.get_service("CampaignService")
segments = campaign_service.parse_campaign_path(resource_name)
customer_id = segments["customer_id"]
campaign_id = segments["campaign_id"]
Nomes de recursos compostos
Os assistentes de caminho nos serviços criam segmentos compostos de um nome de recurso. Os diferentes segmentos do ID composto são aceitos como parâmetros individuais no método:
from google.ads.googleads.client import GoogleAdsClient
customer_id = "0987654321"
ad_group_id = "1234567890"
criterion_id = "74932"
client = GoogleAdsClient.load_from_storage()
ad_group_criterion_service = client.get_service("AdGroupCriterionService")
# An AdGroupCriterion resource name that uses these IDs looks like this:
# "customers/0987654321/adGroupCriteria/1234567890~74932"
resource_name = ad_group_criterion_service.ad_group_criterion_path(
customer_id, ad_group_id, criterion_id
)