ID unik untuk entitas di Google Ads API disebut resource dan direpresentasikan sebagai string dengan format yang dapat diprediksi. Jika Anda tahu komponen konstituen nama resource, Anda bisa membuat nama resource menggunakan metode helper yang ada di banyak objek Service.
Metode jalur layanan
Semua Layanan yang dirancang untuk menangani pembacaan atau mutasi jenis
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 library klien versi 10.0.0, setiap layanan juga memiliki
metode parse_*_path yang menyertainya yang membongkar resource_name ke
segmen individual, 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 di layanan membuat segmen gabungan dari nama sumber daya. Segmen yang berbeda dari 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
)
Versi sebelum 9.0.0
Sebelum versi 9.0.0, helper jalur pada layanan tidak membangun segmen gabungan dari nama resource. Segmen tersebut harus disediakan oleh penelepon. 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
)