संसाधन के नाम

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 तरीका भी दिया गया होता है. यह संसाधन_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
)