चेतावनी: आप एपीआई के REST इंटरफ़ेस के बारे में दस्तावेज़ देख रहे हैं. हमारी ज़्यादातर आधिकारिक क्लाइंट लाइब्रेरी, gRPC का इस्तेमाल करती हैं. ज़्यादा जानकारी के लिए, REST के बारे में जानकारी देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

संसाधन के नाम

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

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

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

संसाधन के नाम के कॉम्पोनेंट

रिसॉर्स आईडी

ग्राहक आईडी:	`"1234567890"`
विज्ञापन ग्रुप का आईडी:	`"54321098765"`
विज्ञापन ग्रुप का विज्ञापन आईडी:	`"2109876543210"`

कलेक्शन आईडी

"customers"

"adGroupAds"

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

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

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

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

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

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

डायग्राम, खाते की हैरारकी के साथ संसाधन के नामों का संबंध दिखाता है.

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

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

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