Google API को ऐक्सेस करने वाले सभी ऐप्लिकेशन को यह पुष्टि करनी होगी कि वे Google API सेवाओं की उपयोगकर्ता के डेटा से जुड़ी नीति के मुताबिक, अपनी पहचान और मकसद को सटीक तरीके से दिखाते हैं. आपको और Google के शेयर किए गए उपयोगकर्ताओं को सुरक्षित रखने के लिए, Google को आपकी ऐसी स्क्रीन जहां OAuth के लिए सहमति दी जाती है और ऐप्लिकेशन की पुष्टि करनी पड़ सकती है.
अगर आपका ऐप्लिकेशन यहां दी गई सभी शर्तें पूरी करता है, तो उसकी पुष्टि करना ज़रूरी है:
- Google API Console में, आपके ऐप्लिकेशन का कॉन्फ़िगरेशन, बाहरी उपयोगकर्ता टाइप और पब्लिश किया गया स्टेटस के लिए सेट किया गया हो. इसका मतलब है कि आपका ऐप्लिकेशन प्रोडक्शन मोड में है और Google खाते का इस्तेमाल करने वाले किसी भी व्यक्ति के लिए उपलब्ध है.
- आपको OAuth के लिए सहमति देने वाली स्क्रीन पर, अपने ऐप्लिकेशन का लोगो या डिसप्ले नेम दिखाना है.
अपने ऐप्लिकेशन के ब्रैंड की जानकारी की पुष्टि करने से, इस बात की संभावना बढ़ जाती है कि उपयोगकर्ता आपके ब्रैंड को पहचानें और आपके ऐप्लिकेशन को ऐक्सेस दें. ब्रैंड की जानकारी की पुष्टि करने से, बाद में ऐक्सेस वापस लेने की संभावना भी कम हो जाती है. ऐसा तब होता है, जब कोई उपयोगकर्ता या Google Workspace एडमिन, खाते का ऐक्सेस रखने वाले तीसरे पक्ष के ऐप्लिकेशन और सेवाओं की समीक्षा करता है. ब्रैंड की पुष्टि करें बटन पर क्लिक करने के बाद, ब्रैंड की पुष्टि की प्रक्रिया में आम तौर पर कुछ मिनट लगते हैं. कुछ मामलों में, जहां नतीजे का अपने-आप पता नहीं लगाया जा सकता, वहां आपके ऐप्लिकेशन की मैन्युअल तरीके से समीक्षा की जा सकती है. इसमें आम तौर पर, दो से तीन कामकाजी दिन लगते हैं.
अगर आपके ऐप्लिकेशन की ब्रैंडिंग की जानकारी की पुष्टि नहीं होती है, तो हो सकता है कि उपयोगकर्ता आपके ऐप्लिकेशन पर भरोसा न करें और उसे अपना डेटा ऐक्सेस करने की अनुमति न दें. इससे, आपको उपयोगकर्ताओं से कम अनुमतियां मिलेंगी और बाद में ज़्यादा अनुमतियां रद्द की जा सकती हैं.
ऐसी स्क्रीन जहां OAuth के लिए सहमति दी जाती है
सहमति वाली स्क्रीन से उपयोगकर्ताओं को यह पता चलता है कि उनके डेटा को ऐक्सेस करने का अनुरोध कौन कर रहा है. साथ ही, यह भी पता चलता है कि आपका ऐप्लिकेशन उनकी ओर से किस तरह का डेटा ऐक्सेस करना चाहता है. इस बारे में, पहली इमेज के बॉक्स 2 में बताया गया है.
जब आपके ऐप्लिकेशन की ब्रैंड की पुष्टि की प्रक्रिया पूरी हो जाती है और उसे मंज़ूरी मिल जाती है, तो अनुमति देने वाले खाते को आपके ऐप्लिकेशन की पहचान और उपयोगकर्ता के डेटा से जुड़ी नीतियों को साफ़ तौर पर समझने में मदद मिलती है. इस जानकारी से, इस बात की संभावना बढ़ जाती है कि खाता मालिक आपके अनुरोधों को अनुमति दे और ऐक्सेस बनाए रखे. ऐसा तब होता है, जब वह अपने Google खाते के पेज पर, ऐक्सेस वापस लेने की संभावना की समीक्षा करता है. Cloud Console में OAuth ब्रैंडिंग पेज पर कॉन्फ़िगर किया गया कॉन्टेंट, इन कॉम्पोनेंट में अपने-आप भर जाता है:
- आपके ऐप्लिकेशन का नाम और लोगो (जैसा कि पहली इमेज के बॉक्स 1 में दिखाया गया है)
- उपयोगकर्ता सहायता के लिए आपका ईमेल पता, जो आपके ऐप्लिकेशन का नाम चुनने के बाद दिखता है (इमेज 1 का बॉक्स 2)
- आपकी निजता नीति और सेवा की शर्तों के लिंक (इमेज 1 का बॉक्स 3)
अनुमति वाले डोमेन
ब्रैंड की पुष्टि की प्रक्रिया के तहत, Google को उन सभी डोमेन की पुष्टि करनी होती है जो किसी ऐप्लिकेशन की OAuth सहमति वाली स्क्रीन और क्रेडेंशियल से जुड़े होते हैं. हम आपसे डोमेन के उस कॉम्पोनेंट की पुष्टि करने के लिए कहते हैं जो किसी पब्लिक सफ़िक्स पर रजिस्ट्रेशन के लिए उपलब्ध है: "टॉप प्राइवेट डोमेन." उदाहरण के लिए, https://sub.example.com/product के ऐप्लिकेशन होम पेज के साथ कॉन्फ़िगर की गई OAuth सहमति स्क्रीन, खाता मालिक से example.com डोमेन के मालिकाना हक की पुष्टि करने के लिए कहती है.
OAuth के लिए सहमति देने की स्क्रीन वाले एडिटर के अनुमति वाले डोमेन सेक्शन में, वे टॉप प्राइवेट डोमेन शामिल होने चाहिए जिनका इस्तेमाल ऐप्लिकेशन डोमेन सेक्शन के यूआरआई में किया जाता है. इन डोमेन में ऐप्लिकेशन का होम पेज, निजता नीति, और सेवा की शर्तें शामिल हैं. अनुमति वाले डोमेन सेक्शन में, आपके "वेब ऐप्लिकेशन" OAuth ऐप्लिकेशन टाइप में अनुमति वाले रीडायरेक्ट यूआरआई या JavaScript ऑरिजिन भी शामिल होने चाहिए.
Google Search Console का इस्तेमाल करके, अनुमति वाले डोमेन के मालिकाना हक की पुष्टि करें. किसी डोमेन के लिए, मालिक की अनुमतियों वाला Google खाता, उस API Console प्रोजेक्ट से जुड़ा होना चाहिए जो अनुमति वाले डोमेन का इस्तेमाल करता है. Google Search Console में डोमेन की पुष्टि करने के बारे में ज़्यादा जानकारी के लिए, अपनी साइट के मालिकाना हक की पुष्टि करना लेख पढ़ें.
पुष्टि की प्रक्रिया शुरू करने से पहले की जाने वाली तैयारी
डेटा का ऐक्सेस पाने के लिए, Google API का इस्तेमाल करने वाले सभी ऐप्लिकेशन को ब्रैंड की पुष्टि करने के लिए, ये चरण पूरे करने होंगे:
- पुष्टि करें कि आपका ऐप्लिकेशन, पुष्टि करने की ज़रूरी शर्तों के अपवाद सेक्शन में दिए गए किसी भी मामले में शामिल न हो.
- पक्का करें कि आपका ऐप्लिकेशन, उससे जुड़े एपीआई या प्रॉडक्ट की ब्रैंडिंग से जुड़ी ज़रूरी शर्तों का पालन करता हो. उदाहरण के लिए, Google साइन-इन के स्कोप के लिए, ब्रैंडिंग के दिशा-निर्देश देखें.
- Google Search Console में जाकर, अपने प्रोजेक्ट के अनुमति वाले डोमेन के मालिकाना हक की पुष्टि करें. ऐसे Google खाते का इस्तेमाल करें जो आपके API Console प्रोजेक्ट से मालिक या एडिटर के तौर पर जुड़ा हो.
- पक्का करें कि OAuth के लिए सहमति देने वाली स्क्रीन पर मौजूद ब्रैंडिंग की सारी जानकारी, ऐप्लिकेशन की पहचान को सटीक तरीके से दिखाती हो. जैसे, ऐप्लिकेशन का नाम, सहायता पाने के लिए ईमेल पता, होम पेज का यूआरआई, निजता नीति का यूआरआई वगैरह.
ऐप्लिकेशन के होम पेज से जुड़ी ज़रूरी शर्तें
पक्का करें कि आपका होम पेज इन ज़रूरी शर्तों को पूरा करता हो:
- आपकी साइट का होम पेज सार्वजनिक तौर पर ऐक्सेस किया जा सकता हो. ऐसा न हो कि इसे सिर्फ़ वे लोग ऐक्सेस कर पाएं जिन्होंने आपकी साइट पर लॉग इन किया है.
- यह साफ़ तौर पर पता चलना चाहिए कि आपका होम पेज, समीक्षा के लिए सबमिट किए गए ऐप्लिकेशन के लिए कितना काम का है.
- Google Play Store पर आपके ऐप्लिकेशन की लिस्टिंग या उसके Facebook पेज के लिंक, ऐप्लिकेशन के मान्य होम पेज नहीं माने जाते.
ऐप्लिकेशन की निजता नीति के लिंक से जुड़ी ज़रूरी शर्तें
पक्का करें कि आपके ऐप्लिकेशन की निजता नीति इन ज़रूरी शर्तों के मुताबिक हो:
- निजता नीति, उपयोगकर्ताओं को दिखनी चाहिए. साथ ही, इसे आपके ऐप्लिकेशन के होम पेज वाले डोमेन पर ही होस्ट किया जाना चाहिए. इसके अलावा, इसे Google API Console की ऐसी स्क्रीन से लिंक किया जाना चाहिए जहां OAuth के लिए सहमति दी जाती है. ध्यान दें कि होम पेज पर, ऐप्लिकेशन के फ़ंक्शन की जानकारी के साथ-साथ, निजता नीति और सेवा की शर्तों के लिंक भी शामिल होने चाहिए. हालांकि, सेवा की शर्तों के लिंक शामिल करना ज़रूरी नहीं है.
- निजता नीति में यह बताना ज़रूरी है कि आपका ऐप्लिकेशन, Google उपयोगकर्ता के डेटा को कैसे ऐक्सेस, इस्तेमाल, सेव या शेयर करता है. आपको Google उपयोगकर्ता के डेटा का इस्तेमाल, सिर्फ़ उन कामों के लिए करना चाहिए जिनके बारे में आपने अपनी पब्लिश की गई निजता नीति में जानकारी दी है.
ब्रैंड की पुष्टि के लिए, अपना ऐप्लिकेशन सबमिट करने का तरीका
Google Cloud Console प्रोजेक्ट, आपके सभी Cloud Console संसाधनों को व्यवस्थित करता है. किसी प्रोजेक्ट में, उससे जुड़े Google खातों का एक सेट होता है. इन खातों के पास प्रोजेक्ट से जुड़े काम करने की अनुमति होती है. साथ ही, इसमें चालू किए गए एपीआई का एक सेट और उन एपीआई के लिए बिलिंग, पुष्टि, और निगरानी की सेटिंग होती हैं. उदाहरण के लिए, किसी प्रोजेक्ट में एक या उससे ज़्यादा OAuth क्लाइंट हो सकते हैं. साथ ही, उन क्लाइंट के इस्तेमाल के लिए एपीआई कॉन्फ़िगर किए जा सकते हैं. इसके अलावा, OAuth के लिए सहमति देने वाली स्क्रीन को कॉन्फ़िगर किया जा सकता है. यह स्क्रीन, उपयोगकर्ताओं को आपके ऐप्लिकेशन को ऐक्सेस करने की अनुमति देने से पहले दिखती है.
अगर आपका कोई OAuth क्लाइंट प्रोडक्शन के लिए तैयार नहीं है, तो हमारा सुझाव है कि आप उसे उस प्रोजेक्ट से मिटा दें जिसके लिए पुष्टि का अनुरोध किया जा रहा है. क्लाइंट पेज में जाकर, ऐसा किया जा सकता है.
पुष्टि कराने के लिए, यह तरीका अपनाएं:
- पक्का करें कि आपका ऐप्लिकेशन, Google API की सेवा की शर्तों और Google API सेवाओं की उपयोगकर्ता के डेटा से जुड़ी नीति का पालन करता हो.
- अपने Cloud Console में, प्रोजेक्ट से जुड़े खातों के मालिक और एडिटर की भूमिकाओं को अप-टू-डेट रखें. साथ ही, OAuth की सहमति वाली स्क्रीन पर, उपयोगकर्ता की सहायता के लिए ईमेल पता और डेवलपर की संपर्क जानकारी को भी अप-टू-डेट रखें. इससे यह पक्का होता है कि आपकी टीम के सही सदस्यों को किसी भी नई ज़रूरी शर्त की सूचना मिले.
- Cloud Console OAuth ब्रैंडिंग पेज पर जाएं.
- प्रोजेक्ट सिलेक्टर बटन पर क्लिक करें.
इसके बाद, आपको इनमें से चुनें डायलॉग बॉक्स दिखेगा. इसमें अपना प्रोजेक्ट चुनें. अगर आपको अपना प्रोजेक्ट नहीं मिल रहा है, लेकिन आपको अपना प्रोजेक्ट आईडी पता है, तो अपने ब्राउज़र में इस फ़ॉर्मैट में यूआरएल बनाया जा सकता है:
https://console.developers.google.com/auth/branding?project=[PROJECT_ID]
[PROJECT_ID] को उस प्रोजेक्ट आईडी से बदलें जिसका आपको इस्तेमाल करना है.
ब्रैंडिंग पेज पर, अपने ऐप्लिकेशन की ब्रैंडिंग की जानकारी दें. इसमें ऐप्लिकेशन का नाम, लोगो, डेवलपर की संपर्क जानकारी, और काम के लिंक शामिल हैं. आपके किए गए सभी बदलाव, ड्राफ़्ट ब्रैंडिंग के तौर पर सेव हो जाते हैं.
समीक्षा की प्रोसेस शुरू करने के लिए, ब्रैंडिंग की पुष्टि करें बटन पर क्लिक करें. आम तौर पर, अपने-आप होने वाली समीक्षा कुछ मिनटों में पूरी हो जाती है.
आकलन पूरा होने के बाद, स्टेटस देखें. अगर बदलावों को मंज़ूरी मिल जाती है, तो स्टेटस बदलकर पब्लिश करने के लिए तैयार हो जाता है. अगर अपने-आप होने वाली पुष्टि की सुविधा काम नहीं करती है, तो आपको पता लगाई गई समस्याएं दिखेंगी. इसके बाद, उन्हें ठीक किया जा सकता है या मैन्युअल समीक्षा का अनुरोध किया जा सकता है.
नई ब्रैंडिंग को लाइव करने के लिए, ब्रैंडिंग पब्लिश करें बटन पर क्लिक करें.
अगर आपके ऐप्लिकेशन को संवेदनशील या प्रतिबंधित दायरों के लिए भी पुष्टि की ज़रूरत है, तो OAuth पुष्टि केंद्र पर जाएं. यहां आपको डेटा ऐक्सेस करने की स्थिति को ट्रैक करने और मांगी गई कोई भी अतिरिक्त जानकारी देने की सुविधा मिलती है. जैसे, डेमो वीडियो. ध्यान दें कि डेटा ऐक्सेस करने की पुष्टि का अनुरोध करने से पहले, आपके पास ब्रैंडिंग की पब्लिश की गई स्थिति होनी चाहिए.
दायरे जोड़ें या हटाएं बटन का इस्तेमाल करके, अपने ऐप्लिकेशन के लिए अनुरोध किए गए सभी दायरे बताएं. Google साइन-इन के लिए ज़रूरी दायरों का शुरुआती सेट, संवेदनशील नहीं माने जाने वाले दायरे सेक्शन में पहले से भरा होता है. जोड़े गए स्कोप को सामान्य, संवेदनशील या प्रतिबंधित के तौर पर बांटा जाता है.
अपने ऐप्लिकेशन में मौजूद सुविधाओं से जुड़े दस्तावेज़ों के ज़्यादा से ज़्यादा तीन लिंक दें.
इसके बाद के चरणों में, अपने ऐप्लिकेशन के बारे में मांगी गई कोई भी अतिरिक्त जानकारी दें.
ब्रैंडिंग पब्लिश करने या डेटा ऐक्सेस करने का अनुरोध सबमिट करने के बाद, Google की भरोसा और सुरक्षा टीम, ईमेल के ज़रिए आपसे संपर्क कर सकती है. इस ईमेल में, आपसे कोई अतिरिक्त जानकारी मांगी जा सकती है या आपको कुछ ज़रूरी कदम उठाने के लिए कहा जा सकता है. ज़्यादा जानकारी के अनुरोधों के लिए, डेवलपर की संपर्क जानकारी सेक्शन में अपने ईमेल पते और OAuth के लिए सहमति देने वाली स्क्रीन पर सहायता ईमेल देखें. अपने प्रोजेक्ट की समीक्षा की मौजूदा स्थिति की पुष्टि करने के लिए, प्रोजेक्ट के ब्रैंडिंग या पुष्टि केंद्र वाले पेज भी देखे जा सकते हैं. इसमें यह भी शामिल है कि आपके जवाब का इंतज़ार करते समय, समीक्षा की प्रोसेस रोकी गई है या नहीं.
पुष्टि की ज़रूरी शर्तों के अपवाद
अगर आपके ऐप्लिकेशन का इस्तेमाल, यहां दिए गए सेक्शन में बताई गई किसी भी स्थिति में किया जाएगा, तो आपको उसे समीक्षा के लिए सबमिट करने की ज़रूरत नहीं है.
निजी इस्तेमाल के लिए
इसका एक उदाहरण यह है कि अगर आपके ऐप्लिकेशन का इस्तेमाल सिर्फ़ आप करते हैं या आपके ऐप्लिकेशन का इस्तेमाल सिर्फ़ कुछ लोग करते हैं और वे सभी लोग आपको व्यक्तिगत तौर पर जानते हैं. ऐसा हो सकता है कि आपको और आपके कुछ उपयोगकर्ताओं को पुष्टि नहीं किए गए ऐप्लिकेशन की स्क्रीन पर आगे बढ़ने और अपने निजी खातों को ऐप्लिकेशन का ऐक्सेस देने में कोई परेशानी न हो.
डेवलपमेंट, टेस्टिंग या स्टेजिंग टियर में इस्तेमाल किए गए प्रोजेक्ट
Google OAuth 2.0 की नीतियों का पालन करने के लिए, हमारा सुझाव है कि आप टेस्टिंग और प्रोडक्शन एनवायरमेंट के लिए अलग-अलग प्रोजेक्ट बनाएं. हमारा सुझाव है कि आप अपने ऐप्लिकेशन को पुष्टि के लिए सिर्फ़ तब सबमिट करें, जब आपको अपना ऐप्लिकेशन Google खाते का इस्तेमाल करने वाले सभी उपयोगकर्ताओं के लिए उपलब्ध कराना हो. इसलिए, अगर आपका ऐप्लिकेशन डेवलपमेंट, टेस्टिंग या स्टेजिंग फ़ेज़ में है, तो पुष्टि करने की ज़रूरत नहीं है.
अगर आपका ऐप्लिकेशन डेवलपमेंट या टेस्टिंग के फ़ेज़ में है, तो पब्लिश करने की स्थिति को टेस्टिंग की डिफ़ॉल्ट सेटिंग में छोड़ा जा सकता है. इस सेटिंग का मतलब है कि आपका ऐप्लिकेशन अब भी डेवलपमेंट मोड में है. यह सिर्फ़ उन उपयोगकर्ताओं के लिए उपलब्ध है जिन्हें आपने टेस्ट करने वाले उपयोगकर्ताओं की सूची में जोड़ा है. आपको उन Google खातों की सूची मैनेज करनी होगी जो आपके ऐप्लिकेशन को डेवलप करने या उसकी जांच करने में शामिल हैं.
सिर्फ़ सेवा के मालिकाना हक वाला डेटा
अगर आपका ऐप्लिकेशन सिर्फ़ अपने डेटा को ऐक्सेस करने के लिए सेवा खाते का इस्तेमाल करता है और वह उपयोगकर्ता के किसी भी डेटा (Google खाते से लिंक किया गया) को ऐक्सेस नहीं करता है, तो आपको पुष्टि के लिए सबमिट करने की ज़रूरत नहीं है.
सेवा खातों के बारे में जानने के लिए, Google Cloud के दस्तावेज़ में सेवा खाते देखें. सेवा खाते का इस्तेमाल करने के तरीके जानने के लिए, सर्वर से सर्वर ऐप्लिकेशन के लिए OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.
सिर्फ़ अंदरूनी इस्तेमाल के लिए
इसका मतलब है कि ऐप्लिकेशन का इस्तेमाल सिर्फ़ आपके Google Workspace या Cloud Identity संगठन के लोग करते हैं. प्रोजेक्ट पर संगठन का मालिकाना हक होना चाहिए. साथ ही, उस स्क्रीन को कॉन्फ़िगर करना ज़रूरी है जहां OAuth के लिए सहमति दी जाती है. ऐसा संगठन के अंदर के उपयोगकर्ता टाइप के लिए करना ज़रूरी है. इस मामले में, आपके ऐप्लिकेशन को संगठन के एडमिन से अनुमति लेनी पड़ सकती है. ज़्यादा जानकारी के लिए, Google Workspace के लिए ध्यान देने वाली अन्य बातें लेख पढ़ें.
- सार्वजनिक और संगठन के अंदर इस्तेमाल होने वाले ऐप्लिकेशन के बारे में ज़्यादा जानें.
- अक्सर पूछे जाने वाले सवालों में, अपने ऐप्लिकेशन को संगठन के अंदर इस्तेमाल के लिए मार्क करने का तरीका जानें मैं अपने ऐप्लिकेशन को संगठन के अंदर इस्तेमाल के लिए कैसे मार्क करूं?
पूरे डोमेन के लिए इंस्टॉल करना
अगर आपको अपने ऐप्लिकेशन को सिर्फ़ Google Workspace या Cloud Identity संगठन के उपयोगकर्ताओं के लिए उपलब्ध कराना है और हमेशा पूरे डोमेन के लिए इंस्टॉल करने की सुविधा का इस्तेमाल करना है, तो आपके ऐप्लिकेशन को ब्रैंड की पुष्टि कराने की ज़रूरत नहीं होगी. हालांकि, अगर आपका ऐप्लिकेशन प्रतिबंधित या संवेदनशील स्कोप का इस्तेमाल करता है, तो ऐप्लिकेशन की पुष्टि करना ज़रूरी है. ऐसा इसलिए है, क्योंकि पूरे डोमेन के लिए इंस्टॉल करने पर, डोमेन एडमिन तीसरे पक्ष और संगठन के ऐप्लिकेशन को आपके उपयोगकर्ताओं के डेटा का ऐक्सेस दे सकता है. संगठन के एडमिन ही ऐसे खाते होते हैं जो ऐप्लिकेशन को अनुमति वाली सूची में जोड़ सकते हैं, ताकि उनके डोमेन में इसका इस्तेमाल किया जा सके.
अपने ऐप्लिकेशन को पूरे डोमेन में इंस्टॉल करने का तरीका जानने के लिए, अक्सर पूछे जाने वाले सवालों की सूची में जाएं. इसके लिए, मेरे ऐप्लिकेशन में ऐसे उपयोगकर्ता हैं जिनके पास किसी दूसरे Google Workspace डोमेन के काम से जुड़े खाते हैं पर जाएं.