Google Ads API'deki bir öğenin benzersiz tanımlayıcısına kaynak adı denir ve bu ad, tahmin edilebilir bir biçime sahip bir dize olarak gösterilir. Bir kaynak adının bileşenlerini biliyorsanız birçok hizmet nesnesinde bulunan yardımcı yöntemleri kullanarak kaynak adları oluşturabilirsiniz.
Hizmet yolu yöntemleri
API'de belirli nesne türlerinin okunmasını veya değiştirilmesini işlemek için tasarlanmış tüm hizmetlerde kaynak adları oluşturmaya yardımcı olan yöntemler bulunur. Örneğin, bir Campaign nesnesi için
kaynak adı oluşturabilirsiniz:
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)
Her hizmetin, bir kaynak adını ayrı ayrı segmentlerinden oluşan bir sözlüğe ayıran (veya dize beklenen biçimle eşleşmiyorsa boş bir sözlük döndüren) eşlik eden bir parse_*_path yöntemi de vardır:
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"]
Bileşik kaynak adları
Hizmetlerdeki yol yardımcıları, kaynak adının bileşik segmentlerini oluşturur. Birleşik kimliğin farklı segmentleri, yöntemde ayrı parametreler olarak kabul edilir:
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
)