नाम की हैरारकी
Google Ads API में इस्तेमाल किए गए संसाधन के नाम, क्रमबद्ध होते हैं. ये Google Ads में मौजूद इकाइयों के संगठन को दिखाते हैं. लगभग सभी संसाधन, Customer संसाधन के उप-संसाधन होते हैं. इससे पता चलता है कि लगभग हर एपीआई कॉल को किसी खास Google Ads खाते को टारगेट करना होता है. उदाहरण के लिए, कैंपेन, विज्ञापन ग्रुप, विज्ञापन, और कीवर्ड, सभी रूट कस्टमर रिसॉर्स के सब-रिसॉर्स हैं.
| संसाधन | संसाधन नाम |
|---|---|
| ग्राहक | customers/1234567890
|
| कैंपेन | customers/1234567890/campaigns/8765432109
|
| विज्ञापन समूह | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
रिसॉर्स के आईडी
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.
यह वही कन्वर्ज़न ऐक्शन है. हालांकि, इसका संसाधन नाम उस खाते के हिसाब से होता है जिसका इस्तेमाल इसे ऐक्सेस करने के लिए किया जाता है.