Google Ads API में किसी इकाई के यूनीक आइडेंटिफ़ायर को रिसॉर्स का नाम कहा जाता है. इसे अनुमानित फ़ॉर्मैट वाली स्ट्रिंग के तौर पर दिखाया जाता है. अगर आपको किसी संसाधन के नाम के कॉम्पोनेंट के बारे में पता है, तो कई सेवा ऑब्जेक्ट पर मौजूद हेल्पर तरीकों का इस्तेमाल करके, संसाधन के नाम जनरेट किए जा सकते हैं.
सेवा पाथ के तरीके
एपीआई में खास तरह के ऑब्जेक्ट को पढ़ने या उनमें बदलाव करने के लिए डिज़ाइन की गई सभी सेवाओं में, हेल्पर तरीके होते हैं. इनकी मदद से, resource_names को आसानी से बनाया जा सकता है. उदाहरण के लिए, 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
)
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
)