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

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

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

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

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

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

एपीआई संपर्क ईमेल को अपडेट करने के लिए यह तरीका अपनाएं:

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

Google Cloud Console खाता

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

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

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

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

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

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

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