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

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

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

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

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

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

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

संपर्क करने के लिए इस्तेमाल होने वाले ईमेल पते को अपडेट करने और यह पक्का करने के लिए कि आपकी पूरी टीम को ये सूचनाएं मिलें, अपने Google Cloud प्रोजेक्ट में टीम के शेयर किए गए ईमेल उपनाम को मालिक या एडिटर की भूमिका दें. साथ ही, उस ईमेल उपनाम पर भेजे गए ईमेल पर नियमित तौर पर नज़र रखें.

Google Cloud Console खाता

Google Cloud Console प्रोजेक्ट में, आपके ऐप्लिकेशन के OAuth क्रेडेंशियल होते हैं. साथ ही, इसमें Google Ads API के ऐक्सेस को कंट्रोल करने की सुविधा होती है. इस प्रोजेक्ट का ऐक्सेस देने के लिए, टीम के शेयर किए गए किसी उपनाम को मालिक या एडिटर की भूमिका असाइन करें.

Google Cloud प्रोजेक्ट के मालिक के तौर पर, शेयर किया गया कोई उपनाम जोड़ने के लिए, यह तरीका अपनाएं:

1. Google Cloud Console में साइन इन करें.
2. पेज पर सबसे ऊपर मौजूद प्रोजेक्ट सिलेक्टर से अपना प्रोजेक्ट चुनें.
3. नेविगेशन मेन्यू में, IAM और एडमिन > IAM पर जाएं.
4. ऐक्सेस दें पर क्लिक करें.
5. मुख्य खाते जोड़ें सेक्शन में, मुख्य खाते वाले नए फ़ील्ड में शेयर किया गया ईमेल पता डालें.
6. भूमिकाएं असाइन करें सेक्शन में, कोई भूमिका चुनें पर क्लिक करें. इसके बाद, बेसिक > मालिक (या बेसिक > एडिटर) को चुनें.
7. सेव करें पर क्लिक करें. अगर आपने अपने Google Cloud संगठन से बाहर के किसी ईमेल पते (या संगठन के बिना किसी प्रोजेक्ट) को मालिक की भूमिका दी है, तो Google Cloud, शेयर किए गए ईमेल उपनाम पर न्योते का ईमेल भेजता है. भूमिका लागू होने से पहले, इस न्योते को स्वीकार करना ज़रूरी है. ऐक्सेस देने और वापस लेने के बारे में ज़्यादा जानने के लिए, Cloud का दस्तावेज़ देखें.

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

Google Ads API का इस्तेमाल करके खातों को मैनेज करने का एक सामान्य तरीका यह है कि अपने सभी खातों को एक सामान्य मैनेजर खाते से लिंक करें. इसके बाद, सबसे ऊपर मौजूद मैनेजर खाते के क्रेडेंशियल का इस्तेमाल करके, सभी खातों को एपीआई कॉल करें. इस कॉन्फ़िगरेशन में, डेवलपर login-customer-id अनुरोध का हेडर (या login_customer_id क्लाइंट लाइब्रेरी कॉन्फ़िगरेशन सेटिंग) को Google Ads मैनेजर खाते के 10 अंकों वाले ग्राहक आईडी (बिना हाइफ़न के) पर सेट करता है. साथ ही, टारगेट customer_id को उस ऑपरेटिंग खाते पर सेट करता है जिससे एपीआई कॉल किए जाते हैं.

सुझाव: सेवा खाते का इस्तेमाल करें

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

विकल्प: शेयर किए गए दूसरे ईमेल पते का इस्तेमाल करना

अगर आपके इंटिग्रेशन में सेवा खाते का इस्तेमाल नहीं किया जा सकता और इसके बजाय, एक उपयोगकर्ता की पुष्टि करने वाले वर्कफ़्लो का इस्तेमाल किया जाता है, तो Google Ads मैनेजर खाते का ऐक्सेस रखने वाला उपयोगकर्ता, OAuth 2.0 रीफ़्रेश टोकन जारी करता है.

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

उपयोगकर्ता के क्रेडेंशियल का इस्तेमाल करते समय, इस स्थिति से बचने के लिए:

1. इस Google Ads मैनेजर खाते को सही ऐक्सेस लेवल के साथ मैनेज करने के लिए, शेयर किए गए दूसरे ईमेल पते को न्योता भेजें. यह ज़रूरी है कि यह ईमेल पता, किसी ऐसे चालू Google खाते से जुड़ा हो जिसमें पासकी की मदद से पुष्टि करने की सुविधा चालू हो.
2. शेयर किए गए दूसरे ईमेल पते का इस्तेमाल करके न्योता स्वीकार करें.
3. एपीआई कॉल करने के लिए, OAuth रीफ़्रेश टोकन जारी करने के लिए, शेयर किए गए इस दूसरे ईमेल पते का इस्तेमाल करें.