Google Ads की ज़्यादातर इकाइयां, getId() तरीके को एक्सपोज़ करती हैं. इससे उनके आइडेंटिफ़ायर की जानकारी मिलती है. ज़्यादातर मामलों में आईडी की ज़रूरत नहीं होती. हालांकि, ये तब काम आ सकते हैं, जब
- रिपोर्ट के साथ काम करना
- आईडी, रिपोर्ट की लाइन को Google Ads की असल इकाई से लिंक करने का एक अच्छा तरीका है.
- किसी बाहरी डेटास्टोर के साथ मैपिंग बनाए रखना
- ऐसा हो सकता है कि आपके डेटाबेस में, आईडी के आधार पर जानकारी पहले से ही सेव हो.
- परफ़ॉर्मेंस को बेहतर बनाने के लिए
आईडी से फ़ेच करना, अन्य तरीकों की तुलना में ज़्यादा तेज़ होता है. किसी एक इकाई को फ़ेच करने का कोड भी थोड़ा आसान है:
let campaigns = AdsApp.campaigns() .withIds([678678]) .get(); // versus let campaigns = AdsApp.campaigns() .withCondition("Name='My Campaign'") .get();
यूनीकनेस
कैंपेन आईडी और विज्ञापन ग्रुप आईडी यूनीक होते हैं: किन्हीं दो कैंपेन या विज्ञापन ग्रुप का आईडी एक जैसा नहीं होगा. हालांकि, विज्ञापनों और कीवर्ड के आईडी कंपोज़िट होते हैं: किसी कीवर्ड का यूनीक आइडेंटिफ़ायर, उसके विज्ञापन ग्रुप आईडी और कीवर्ड आईडी का कॉम्बिनेशन होता है.
इसी तरह, किसी विज्ञापन का यूनीक आइडेंटिफ़ायर, उसके विज्ञापन ग्रुप आईडी और विज्ञापन आईडी का कॉम्बिनेशन होता है. इसका असर selector.withIds() को कॉल करने के तरीके पर पड़ता है.
कैंपेन और विज्ञापन ग्रुप के लिए, selector.withIds() को संख्याओं के कलेक्शन की ज़रूरत होती है:
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
हालांकि, विज्ञापनों और कीवर्ड के लिए, selector.withIds() को दो एलिमेंट वाले अरे की ज़रूरत होती है. इसमें पहला एलिमेंट, विज्ञापन ग्रुप आईडी होता है. नीचे दिया गया स्निपेट, किसी विज्ञापन ग्रुप से तीन कीवर्ड को वापस लाता है:
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
विज्ञापन फ़ेच करते समय भी यही तरीका लागू होता है.
अस्थायी आईडी
कई कार्रवाइयों वाले बदलाव के अनुरोध के साथ काम करते समय, आपको कभी-कभी संसाधनों को एक-दूसरे से लिंक करने के लिए, अस्थायी आईडी का इस्तेमाल करना होगा. ऐसा इसलिए, क्योंकि एपीआई से मिली जानकारी मिलने तक, संसाधनों के पूरे नाम उपलब्ध नहीं होंगे. अस्थायी आईडी, -1 से शुरू होने वाली नेगेटिव संख्याएं होनी चाहिए. साथ ही, इन्हें एक ही म्यूटेट रिक्वेस्ट में दोहराया नहीं जा सकता. अस्थायी आईडी का असरदार तरीके से इस्तेमाल करने के लिए, आपको कुछ कोड लिखना होगा. इससे यह पक्का किया जा सकेगा कि डुप्लीकेट अस्थायी आईडी न बनें:
let nextId = -1;
function getNextTempId() {
const ret = nextId;
nextId -= 1;
return ret;
}
getNextTempId को किए जाने वाले हर कॉल के बाद, पिछले नंबर से एक कम नंबर दिखेगा. सभी अस्थायी आईडी नेगेटिव होने चाहिए. इसलिए, -1 से शुरू करें.
अस्थायी आईडी, अलग-अलग जॉब या बदलाव के अनुरोधों के लिए याद नहीं रखे जाते. बदलाव के पिछले अनुरोध में बनाए गए संसाधन का रेफ़रंस देने के लिए, उसके संसाधन का असल नाम इस्तेमाल करें.