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'de belirli nesne türlerinin okunmasını veya değiştirilmesini sağlamak için tasarlanan 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 parametresini bağımsız segmentlere ayıran bir parse_*_path yöntemi de bulunur. Ö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"]
Birleş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. Bileşik kimliğin farklı segmentleri, yöntemde bağımsız 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 önceki hizmetlerdeki yol yardımcıları, kaynak adının birleşik segmentini oluşturmaz. Bu segmentlerin arayan tarafından sağlanması gerekir. İstemci kitaplığı bu konuda yardımcı olabilecek küçük bir yardımcı program sunar:
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
)