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