संसाधन के नाम

Google Ads API में किसी इकाई के यूनीक आइडेंटिफ़ायर को संसाधन का नाम कहा जाता है. इसे अनुमानित फ़ॉर्मैट वाली स्ट्रिंग के तौर पर दिखाया जाता है. अगर आपको किसी रिसॉर्स के नाम के कॉम्पोनेंट के बारे में पता है, तो फ़ॉर्मैट किए गए रिसॉर्स का नाम जनरेट करने के लिए, ResourceNames यूटिलिटी का इस्तेमाल किया जा सकता है.

ResourceNames क्लास

ResourceNames यूटिलिटी, किसी इकाई का संसाधन नाम तब बनाती है, जब आपको उस इकाई से जुड़े सभी आईडी पता हों. आईडी को सिर्फ़ अंकों वाली स्ट्रिंग के तौर पर पास करें. इनमें हाइफ़न नहीं होने चाहिए.

उदाहरण के लिए, कैंपेन के संसाधन का नाम इस फ़ॉर्मैट में होता है customers/{customer_id}/campaigns/{campaign_id}. अगर आपको ग्राहक आईडी और कैंपेन आईडी पता है, तो ResourceNames यूटिलिटी का इस्तेमाल करके, संसाधन का पूरा नाम इस तरह बनाया जा सकता है:

use Google::Ads::GoogleAds::V25::Utils::ResourceNames;

my $customer_id = "1234567890";
my $campaign_id = "9876543210";

# Generates: "customers/1234567890/campaigns/9876543210"
my $resource_name =
  Google::Ads::GoogleAds::V25::Utils::ResourceNames::campaign(
    $customer_id,
    $campaign_id
  );

ResourceNames यूटिलिटी, अन्य तरह के एलिमेंट के लिए भी इसी तरह के हेल्पर तरीके उपलब्ध कराती है. जैसे, ad_group(), customer(), और ad_group_criterion(). ध्यान दें कि ResourceNames को एपीआई के हर उस वर्शन के नेमस्पेस के लिए स्कोप किया जाता है जो काम करता है. जैसे, V25, जहां v25.1 जैसे एपीआई के माइनर वर्शन, अपने मेजर वर्शन मॉड्यूल V25 का इस्तेमाल करते हैं. इसलिए, अगर एपीआई के पुराने वर्शन का इस्तेमाल किया जा रहा है, तो V25 को अपने टारगेट एपीआई वर्शन से बदलें. इस्तेमाल किए जा सकने वाले हेल्पर मेथड की पूरी सूची देखने के लिए, ResourceNames.pm सोर्स फ़ाइल देखें.