Kaynak Adları

Google Ads API'deki bir varlığın benzersiz tanımlayıcısına kaynak adı verilir. ve öngörülebilir bir biçime sahip bir dize olarak temsil edilir. Biliyorsanız bileşenleri hakkında bilgi edinmek isterseniz birçok Service nesnesinde bulunan yardımcı yöntemleri kullanarak.

Hizmet yolu yöntemleri

Belirli türdeki verilerin okunmasını veya değiştirilmesini işlemek üzere tasarlanmış tüm Hizmetler API'deki nesnelerin, oluşturmayı kolaylaştıran yardımcı yöntemleri vardır resource_names [kaynak_adı]. Ö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 hizmetin bir bir resource_name öğesini kendi değerine ayıran eşlik eden parse_*_path yöntemi ayrı ayrı segmentler, ö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 hizmetlerde yol yardımcıları bir kaynak adının bileşik segmentlerini oluşturabilir. Oluşturulan farklı segmentler bileşik kimlik, 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 önce, hizmetlerdeki yol yardımcıları bir kaynak adının bileşik segmentidir. Bu segmentlerin, Google Analytics 4'teki arayan İ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
)