संसाधन के नाम

नाम की हैरारकी

Google Ads API में इस्तेमाल किए गए रिसॉर्स के नाम, हैरारकी होते हैं और Google Ads में इकाइयों के संगठन की डुप्लीकेट कॉपी बनाते हैं. तकरीबन सभी संसाधन, Customer संसाधन के उप-संसाधन हैं. इससे पता चलता है कि करीब-करीब हर एपीआई कॉल को किसी खास Google Ads खाते को टारगेट करना होता है. उदाहरण के लिए, कैंपेन, विज्ञापन ग्रुप, विज्ञापन, और कीवर्ड सभी रूट ग्राहक संसाधन के उप-संसाधन हैं.

रिसॉर्स के आईडी

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

उदाहरण के लिए, पिछली टेबल में दिए गए AdGroupAd संसाधन के नाम की जांच करें:

customers/1234567890/adGroupAds/54321098765~2109876543210

इसे अलग-अलग रिसॉर्स आईडी (कलेक्शन आईडी से अलग करके) में बांटा जा सकता है, जैसे कि:

अलग-अलग आईडी पार्स करके, विज्ञापन ग्रुप के विज्ञापन के ग्राहक (customers/1234567890) या उसके विज्ञापन ग्रुप (customers/1234567890/adGroupAds/54321098765) के रेफ़रंस के लिए, रिसॉर्स के नए नाम हासिल किए जा सकते हैं.

शेयर किए गए ऑब्जेक्ट के आइडेंटिफ़ायर

एपीआई में मौजूद ज़्यादातर ऑब्जेक्ट, किसी एक ही Google Ads ग्राहक से जुड़े होते हैं. हालांकि, कुछ ऑब्जेक्ट टाइप को कई खातों के बीच शेयर किया जा सकता है. व्यावहारिक तौर पर, ये नेगेटिव कीवर्ड सूचियां या कई खातों में होने वाले कन्वर्ज़न ऐक्शन जैसी चीज़ें होती हैं, जिन्हें आम तौर पर मैनेजर बनाते हैं और फिर उन्हें कई क्लाइंट खातों के साथ शेयर किया जाता है.

इस तरह के ऑब्जेक्ट के संसाधन नाम इस बात के आधार पर अलग-अलग होंगे कि आप किस खाते में एपीआई कॉल भेज रहे हैं.

उदाहरण: कई खातों में होने वाले कन्वर्ज़न ऐक्शन

मान लें कि हमारे पास 987-654-3210 मैनेजर खाता है, जो अपने किसी क्लाइंट ग्राहक खाते 123-456-7890 के साथ कई खातों में होने वाले कन्वर्ज़न ऐक्शन शेयर करता है:

उदाहरण के लिए, मैनेजर खाते को एपीआई कॉल करने से, कन्वर्ज़न ऐक्शन की लुकबैक विंडो अपडेट करने पर, रिसॉर्स के नाम का इस्तेमाल करके शेयर किए गए ऑब्जेक्ट का रेफ़रंस मिलेगा: customers/9876543210/conversionActions/257733534.

शेयर किए गए कन्वर्ज़न ऐक्शन का इस्तेमाल करने के लिए ऑप्ट-इन करने के लिए, क्लाइंट खाते में एपीआई कॉल करने पर, यहां रिसॉर्स के नाम का इस्तेमाल किया जाएगा: customers/1234567890/conversionActions/257733534.

यह पहले से मौजूद कन्वर्ज़न ऐक्शन है, लेकिन इसके रिसॉर्स का नाम उस खाते से मिलता-जुलता है जिसका इस्तेमाल करके इसे ऐक्सेस किया जाता है.