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