ID unik untuk entity di Google Ads API disebut nama resource, dan ditampilkan sebagai string dengan format yang dapat diprediksi. Jika Anda mengetahui komponen penyusun nama resource, Anda dapat membuat nama resource menggunakan metode helper yang ada di banyak objek Layanan.
Metode jalur layanan
Semua Layanan yang didesain untuk menangani pembacaan atau mutasi jenis objek tertentu di API memiliki metode helper untuk membuat resource_name. 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 menyusun resource_name menjadi segmen individualnya, 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 pada layanan membuat segmen komposit dari nama resource. Segmen ID gabungan yang berbeda 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
)