ID unik untuk entitas di Google Ads API disebut nama resource, dan direpresentasikan sebagai string dengan format yang dapat diprediksi. Jika mengetahui komponen konstituen dari nama resource, Anda dapat membuat nama resource menggunakan metode helper yang ada di banyak objek Service.
Metode jalur layanan
Semua Layanan yang didesain untuk menangani pembacaan atau mutasi jenis objek tertentu pada API memiliki metode helper untuk memudahkan pembuatan resource_name. 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 library klien versi 10.0.0, setiap layanan juga memiliki
metode parse_*_path pendamping yang membongkar resource_name ke dalam
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 gabungan
Mulai library klien versi 9.0.0, helper jalur pada layanan akan membuat segmen gabungan nama resource. Segmen yang berbeda dari ID gabungan diterima sebagai parameter individual dalam metode ini:
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 pada 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
)