Google Ads 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)
हर सेवा के साथ एक parse_*_path तरीका भी होता है. यह किसी संसाधन के नाम को उसके अलग-अलग सेगमेंट के डिक्शनरी में बदलता है. अगर स्ट्रिंग, उम्मीद के मुताबिक फ़ॉर्मैट से मेल नहीं खाती है, तो यह एक खाली डिक्शनरी दिखाता है:
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"]
कंपोज़िट संसाधन के नाम
सेवाओं पर पाथ हेल्पर, संसाधन के नाम के कंपोज़िट सेगमेंट बनाते हैं. कंपोज़िट आईडी के अलग-अलग सेगमेंट को इस तरीके में अलग-अलग पैरामीटर के तौर पर स्वीकार किया जाता है:
from google.ads.googleads.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 these 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
)