शेयर किए गए उपनाम

Google Ads API का इस्तेमाल करते समय, कई जगहों पर ईमेल पतों का इस्तेमाल संपर्क और ऐक्सेस मैनेजमेंट के लिए किया जाता है. इनमें से सबसे ज़रूरी है:

• Google Ads API संपर्क ईमेल: यह ईमेल पता, Google Ads के यूज़र इंटरफ़ेस (यूआई) के एपीआई सेंटर में संपर्क के तौर पर दर्ज होता है.
• Google Cloud Console खाते का ईमेल पता: यह वह ईमेल है जिसे आपके OAuth 2.0 ऐप्लिकेशन के लिए इस्तेमाल किए गए Google Cloud Console खाते का एडमिन ऐक्सेस होता है.
• Google Ads मैनेजर खाते के ईमेल पते: इस ईमेल पते के पास उन मैनेजर Google Ads खातों के लिए एडमिन की अनुमतियां होती हैं जिन्हें आपने Google Ads API के ज़रिए ऐक्सेस किया है. अपने ऐप्लिकेशन के लिए रीफ़्रेश टोकन जनरेट करके, आम तौर पर अपने Google Ads API ऐप्लिकेशन की पुष्टि, इनमें से किसी एक ईमेल के ज़रिए की जाती है.

हम टीम के शेयर किए गए उपनामों का इस्तेमाल करने का सुझाव देते हैं, ताकि टीम के अलग-अलग सदस्यों के टीम बदलने या कंपनी छोड़ने पर भी इन खातों का ऐक्सेस बना रहे. इस गाइड के बाकी हिस्से में पहले सूची में दिए गए हर ईमेल के बारे में बताया गया है. साथ ही, इसमें बताया गया है कि किस तरह इसे अपडेट करके किसी उपयोगकर्ता के ईमेल पते के बजाय, शेयर की गई टीम का उपनाम इस्तेमाल किया जा सकता है.

Google Ads API संपर्क ईमेल

Google Ads API संपर्क ईमेल वह ईमेल पता होता है जिसे Google Ads API के लिए साइन अप करते समय दिया जाता है. आपको यह पक्का करना चाहिए कि आपके पास इस उपनाम का ऐक्सेस हो. साथ ही, इस पते पर भेजे गए ईमेल को नियमित तौर पर मॉनिटर करें. Google इस ईमेल पते का इस्तेमाल, एपीआई की समीक्षाओं, ऑडिट के अनुरोधों या प्रोडक्शन से जुड़ी आपातकालीन स्थितियों के समय आपकी टीम से संपर्क करने के लिए करता है. इस दौरान, इन पर तुरंत कार्रवाई करने की ज़रूरत होती है. संपर्क ईमेल के तौर पर, शेयर की गई टीम के उपनाम का इस्तेमाल करें, ताकि पूरी टीम को ये सूचनाएं मिलें.

API संपर्क ईमेल अपडेट करने के लिए इन चरणों का पालन करें:

• उस Google Ads मैनेजर खाते में साइन इन करें जिसका इस्तेमाल आपने Google Ads API के ऐक्सेस के लिए आवेदन करते समय किया था. यह वही खाता है जिसमें आपका डेवलपर टोकन मौजूद है.
• टूल और सेटिंग > एपीआई सेंटर पर जाएं.
• एपीआई संपर्क ईमेल सेक्शन में, ऐरो पर क्लिक करें.
• ईमेल पता अपडेट करें और सेव करें बटन पर क्लिक करें.

Google Cloud Console खाता

Google API कंसोल प्रोजेक्ट में आपके ऐप्लिकेशन के OAuth क्रेडेंशियल और Google Ads API के ऐक्सेस को कंट्रोल करने का अधिकार होता है. खाते का मालिक एक शेयर किया गया उपनाम बनाकर इस खाते का ऐक्सेस पक्का करें.

Google API कंसोल प्रोजेक्ट के मालिक को अपडेट करने के लिए, यह तरीका अपनाएं:

• Google API कंसोल में साइन इन करें.
• पेज के सबसे ऊपर बाएं कोने में मौजूद ड्रॉप-डाउन मेन्यू से अपना प्रोजेक्ट चुनें.
• बाएं मेन्यू में, आईएएम और एडमिन > आईएएम पर जाएं.
• ऐक्सेस दें बटन पर क्लिक करें.
• प्रिंसिपल जोड़ें सेक्शन में शेयर किया गया ईमेल पता डालें.
• मालिक की भूमिका असाइन करें.
• सेव करें बटन पर क्लिक करें. ऐक्सेस देने और वापस लेने के बारे में ज़्यादा जानने के लिए, क्लाउड से जुड़ा दस्तावेज़ देखें.

Google Ads प्रबंधक खाता

Google Ads API का इस्तेमाल करके, खाते मैनेज करने का एक आम तरीका यह है कि अपने सभी खातों को एक ही मैनेजर खाते से लिंक करें. साथ ही, सबसे ऊपर मौजूद मैनेजर खाते के क्रेडेंशियल का इस्तेमाल करके, सभी खातों को एपीआई कॉल करें. इस कॉन्फ़िगरेशन में:

• डेवलपर, Google Ads मैनेजर खाते का ऐक्सेस रखने वाले उपयोगकर्ता के क्रेडेंशियल का इस्तेमाल करके रीफ़्रेश टोकन जारी करता है.
• डेवलपर, login_customer_id हेडर को Google Ads मैनेजर खाते के ग्राहक आईडी के तौर पर और customer_id हेडर को उस खाते के ग्राहक आईडी के तौर पर सेट करता है जिससे एपीआई कॉल किए जाते हैं.

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