संसाधन के नाम

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

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 API, रिलेटिव रिसॉर्स नेम का इस्तेमाल करता है. यह कुछ अन्य Google API की तरह, पूरे रिसॉर्स नेम का इस्तेमाल नहीं करता.

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

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

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

customers/1234567890/adGroupAds/54321098765~2109876543210

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

संसाधन के नाम के कॉम्पोनेंट
रिसॉर्स आईडी	ग्राहक आईडी: "1234567890" विज्ञापन ग्रुप का आईडी: "54321098765" विज्ञापन ग्रुप का विज्ञापन आईडी: "2109876543210"
कलेक्शन आईडी	"customers" "adGroupAds"

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

अहम जानकारी: JSON अनुरोध और रिस्पॉन्स बॉडी में संसाधन के नामों को resourceName फ़ील्ड से रेफ़र किया जाता है, न कि Google Cloud के कुछ अन्य एपीआई की तरह name फ़ील्ड से. Google Ads की कई इकाइयों के पास नाम एट्रिब्यूट (campaign.Name, adGroup.Name वगैरह) होते हैं. इसलिए, मौजूदा ऑब्जेक्ट के नामों से मेल न खाने के लिए, resourceName का इस्तेमाल किया जाता है.

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

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

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

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

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

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

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

यह वही कन्वर्ज़न ऐक्शन है, लेकिन इसका संसाधन का नाम, उसे ऐक्सेस करने के लिए इस्तेमाल किए गए खाते के हिसाब से होता है.