সম্পদের নাম

Google Ads API-এ একটি সত্তার অনন্য শনাক্তকারীকে রিসোর্স নাম বলা হয় এবং এটি একটি অনুমানযোগ্য ফর্ম্যাট সহ একটি স্ট্রিং হিসাবে উপস্থাপন করা হয়। আপনি যদি একটি সংস্থান নামের উপাদান উপাদানগুলি জানেন, আপনি অনেক পরিষেবা বস্তুতে উপস্থিত সহায়ক পদ্ধতি ব্যবহার করে সম্পদের নাম তৈরি করতে পারেন।

পরিষেবা পাথ পদ্ধতি

API-এ নির্দিষ্ট ধরনের অবজেক্ট রিডিং বা মিউটেশন পরিচালনা করার জন্য ডিজাইন করা সমস্ত পরিষেবাতে রিসোর্স_নাম তৈরি করা সহজ করার জন্য সহায়ক পদ্ধতি রয়েছে। উদাহরণস্বরূপ একটি Campaign বস্তুর জন্য একটি সম্পদ নাম তৈরি করা:

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)

ক্লায়েন্ট লাইব্রেরির 10.0.0 সংস্করণ থেকে শুরু করে, প্রতিটি পরিষেবাতে একটি সহগামী parse_*_path পদ্ধতি রয়েছে যা একটি resource_name তার পৃথক অংশে বিনির্মাণ করে, উদাহরণস্বরূপ:

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"]

যৌগিক সম্পদের নাম

ক্লায়েন্ট লাইব্রেরির সংস্করণ 9.0.0 দিয়ে শুরু করে, পরিষেবাগুলিতে পথ সাহায্যকারীরা একটি সংস্থান নামের যৌগিক অংশগুলি তৈরি করে। যৌগিক আইডির বিভিন্ন বিভাগগুলি পদ্ধতিতে পৃথক পরামিতি হিসাবে গৃহীত হয়:

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
)

মূল পয়েন্ট: নতুন পাথ হেল্পারগুলি শুধুমাত্র google-ads-python লাইব্রেরির 9.0.0 এবং উচ্চতর সংস্করণে উপলব্ধ।

9.0.0 এর আগের সংস্করণ

সংস্করণ 9.0.0-এর আগে, পরিষেবাগুলিতে পাথ সাহায্যকারীরা কোনও সংস্থান নামের যৌগিক অংশ তৈরি করে না। সেই অংশগুলি কলকারীর দ্বারা সরবরাহ করা প্রয়োজন৷ এতে সাহায্য করার জন্য ক্লায়েন্ট লাইব্রেরির একটি ছোট ইউটিলিটি রয়েছে:

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
)

মূল পয়েন্ট: ক্লায়েন্ট লাইব্রেরির 10.0.0 সংস্করণে util.ResourceName সহায়কটিকে সরানো হয়েছে কারণ সমস্ত পরিষেবা ক্লায়েন্টের পাথ পদ্ধতি রয়েছে যা কম্পোজিট আইডি সমর্থন করে।