Имена ресурсов

Уникальный идентификатор сущности в API Google Ads называется именем ресурса и представлен в виде строки с предсказуемым форматом. Зная компоненты имени ресурса, вы можете сгенерировать его с помощью вспомогательных методов, присутствующих во многих объектах Service.

Методы пути обслуживания

Все сервисы, предназначенные для чтения или изменения определённых типов объектов в API, имеют вспомогательные методы для создания resource_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 , который разбивает resource_name на отдельные сегменты, например:

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"]

Составные имена ресурсов

Вспомогательные функции Path Helpers для сервисов формируют составные сегменты имени ресурса. Различные сегменты составного идентификатора принимаются в качестве отдельных параметров метода:

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
)