Google Ads API'deki bir varlığın benzersiz tanımlayıcısına kaynak adı denir ve tahmin edilebilir biçime sahip bir dize olarak temsil edilir. Bir kaynak adının bileşen bileşenlerini biliyorsanız birçok Service nesnesinde bulunan yardımcı yöntemleri kullanarak kaynak adları oluşturabilirsiniz.
Hizmet yolu yöntemleri
API'deki belirli nesne türlerinin okunmasını veya değiştirilmesini işlemek üzere tasarlanmış tüm Hizmetler,resource_names oluşturmayı kolaylaştıran yardımcı yöntemlere sahiptir. Örneğin, bir Campaign nesnesi için kaynak adı oluşturmak:
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)
İstemci kitaplığının 10.0.0 sürümünden itibaren her hizmet, bir resource_name öğesini kendi segmentlerine ayrıştıran bir parse_*_path yöntemi de sunar. Örneğin:
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ı
İstemci kitaplığının 9.0.0 sürümünden itibaren hizmetlerdeki yol yardımcıları, kaynak adının birleşik segmentlerini oluşturur. Bileşik kimliğin farklı segmentleri, yöntemde ayrı parametreler olarak kabul edilir:
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
)
9.0.0'dan önceki sürümler
9.0.0 sürümünden önce hizmetlerdeki yol yardımcıları, bir kaynak adının birleşik segmentini oluşturmaz. Bu segmentlerin arayan tarafından sağlanması gerekir. İstemci kitaplığında bu konuda yardımcı olacak küçük bir yardımcı program vardır:
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
)