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 mutasi jenis objek tertentu di API memiliki metode bantuan untuk membuat nama resource. 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
nama resource menjadi kamus segmen individualnya (atau menampilkan kamus
kosong jika string tidak cocok dengan format yang diharapkan):
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 gabungan
Helper jalur pada layanan membuat segmen gabungan dari nama resource. Segmen yang berbeda dari ID gabungan diterima sebagai parameter individual dalam metode:
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
)