Google Ads API'deki bir öğenin benzersiz tanımlayıcısına kaynak adı denir ve bu tanımlayıcı, tahmin edilebilir bir biçime sahip bir dize olarak temsil edilir. 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'deki belirli nesne türlerini okumak veya değiştirmek için 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şturma:
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 hizmetin, resource_name değerini ayrı segmentlere ayıran bir parse_*_path yöntemi de vardır. Ö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ı bir kaynak adının birleşik segmentlerini oluşturur. Kompozit 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 bulunur:
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
)