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

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

संसाधन के नाम

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

Google Ads API में इस्तेमाल किए गए संसाधन के नाम, हैरारकी के हिसाब से होते हैं. साथ ही, Google Ads में इकाइयों का संगठन. करीब-करीब सभी संसाधन, उप-संसाधन हैं Customer में से देता है, जो इस तथ्य को दर्शाता है कि करीब हर एक API कॉल को वाला है. उदाहरण के लिए, कैंपेन, विज्ञापन ग्रुप, विज्ञापन, और कीवर्ड ये सभी रूट ग्राहक के संसाधन के उप-संसाधन हैं.

संसाधन	संसाधन नाम
ग्राहक	`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).

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

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

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

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

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

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

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

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

यह पहले से मौजूद कन्वर्ज़न ऐक्शन है, लेकिन इसके रिसॉर्स का नाम एक-दूसरे से मिलता-जुलता है उस खाते से लिंक करें जिसका इस्तेमाल करके उसे ऐक्सेस किया गया था.