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 memudahkan pembuatan
resource_names. Misalnya, 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)
Mulai dari library klien versi 10.0.0, setiap layanan juga memiliki
metode parse_*_path yang menyertainya yang mendekonstruksi resource_name menjadi
setiap segmennya, 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
Mulai library klien versi 9.0.0, helper jalur di layanan membuat segmen gabungan dari nama resource. Berbagai segmen ID komposit 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
)
Versi sebelum 9.0.0
Sebelum versi 9.0.0, helper jalur di layanan tidak membuat segmen gabungan dari nama resource. Segmen tersebut harus disediakan oleh pemanggil. Library klien memiliki utilitas kecil untuk membantu hal ini:
from google.ads.google_ads.client import GoogleAdsClient
from google.ads.google_ads.util import ResourceName
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"
composite_id = ResourceName.format_composite(ad_group_id, criterion_id)
resource_name = ad_group_criterion_service.ad_group_criterion_path(
customer_id, composite_id
)