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

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

संसाधन के नाम

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

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

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

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

संसाधन के आईडी

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

कलेक्शन आईडी

"customers"

"adGroupAds"

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

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

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

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

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

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

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

संसाधन के नामों और खाते की हैरारकी के बीच संबंध दिखाने वाला डायग्राम.

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

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

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