Уникальный идентификатор объекта в Google Ads API называется именем ресурса и представляет собой строку предсказуемого формата. Если вы знаете составные компоненты имени ресурса, вы можете создавать имена ресурсов, используя вспомогательные методы, присутствующие во многих объектах службы.
Методы пути службы
Все службы, предназначенные для чтения или изменения определенных типов объектов в API, имеют вспомогательные методы для создания resources_names. Например, вы можете создать имя ресурса для объекта 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)
Каждая служба также имеет сопутствующий метод parse_*_path , который разбирает имя_ресурса на отдельные сегменты, например:
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"]
Составные имена ресурсов
Помощники пути в службах создают составные сегменты имени ресурса. Различные сегменты составного идентификатора принимаются в качестве отдельных параметров метода:
from google.ads.google_ads.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 the above 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
)