ID unik untuk entity di Google Ads API disebut nama resource, dan direpresentasikan sebagai string dengan format yang dapat diprediksi. Jika mengetahui komponen penyusun nama resource, Anda dapat membuat nama resource menggunakan metode bantuan yang ada di banyak objek Layanan.
Metode jalur layanan
Semua Layanan yang dirancang untuk menangani pembacaan atau perubahan jenis objek tertentu di API memiliki metode bantuan untuk membuat resource_names. Misalnya,
Anda dapat membuat nama resource untuk objek 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)
Setiap layanan juga memiliki metode parse_*_path yang menyertainya yang mendekonstruksi resource_name menjadi segmennya masing-masing, misalnya:
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"]
Nama resource komposit
Helper jalur di layanan membuat segmen gabungan dari nama resource. Berbagai segmen ID gabungan diterima sebagai parameter individual dalam metode:
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
)