संसाधन के नाम

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

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 API, इन चीज़ों का इस्तेमाल करता है मिलते-जुलते संसाधन के नाम (न कि पूरा संसाधन नाम जैसे कि अन्य Google API).

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

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

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

customers/1234567890/adGroupAds/54321098765~2109876543210

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

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

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

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

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

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

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

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

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

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

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

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