साइन-इन

Google साइन-इन एपीआई के बंद होने के बाद, हम 2026 में Games v1 SDK को हटा रहे हैं. फ़रवरी 2025 के बाद, Google Play पर ऐसे गेम पब्लिश नहीं किए जा सकेंगे जो Games v1 SDK के साथ हाल ही में इंटिग्रेट किए गए हैं. हमारा सुझाव है कि आप इसके बजाय, Games v2 SDK का इस्तेमाल करें.
हालांकि, पिछले गेम के v1 के साथ इंटिग्रेट किए गए मौजूदा टाइटल, कुछ सालों तक काम करते रहेंगे. फिर भी हमारा सुझाव है कि आप जून 2025 से v2 पर माइग्रेट कर लें.
यह गाइड, Play की गेम सेवाओं के v1 एसडीके का इस्तेमाल करने के लिए है. एसडीके टूल के नए वर्शन के बारे में जानकारी पाने के लिए, v2 का दस्तावेज़ देखें.

Play की गेम सेवाओं में साइन इन करने से, आपको खिलाड़ी की गेमिंग आइडेंटिटी मिलती है. यह Android पर गेम खेलने वाले लोगों के लिए, प्लैटफ़ॉर्म-लेवल की गेमिंग आइडेंटिटी होती है. इस पहचान से, आपके गेम और उसे खेलने वाले व्यक्ति के बीच संबंध बनाने में मदद मिलती है. खिलाड़ी, साइन इन करने के लिए इस आइडेंटिटी का इस्तेमाल करने में ज़्यादा दिलचस्पी दिखाते हैं. ऐसा इसलिए, क्योंकि यह आइडेंटिटी, केंद्रीकृत अन्य सिस्टम की तुलना में ज़्यादा भरोसेमंद है.

इसके अलावा, साइन-इन करने पर आपको एक मज़बूत और लगातार काम करने वाला आइडेंटिफ़ायर मिलता है. इसका इस्तेमाल, क्लाउड सेव सिस्टम के लिए कुंजी के तौर पर किया जा सकता है. क्लाउड सेव की सुविधा बहुत काम की है. इससे खिलाड़ियों को ये काम करने में मदद मिलती है:

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

Play Games Services की पहचान को, क्लाउड में सेव करने की सुविधा के लिए इस्तेमाल किया जा सकता है. इसके अलावा, सेव किए गए गेम की सेवा का इस्तेमाल मुफ़्त में किया जा सकता है.

Play Games की सेवाओं (पीजीएस) में, अपने-आप साइन इन होने की सुविधा काम करती है. इससे, गेम के खिलाड़ी बिना किसी रुकावट के साइन इन कर पाते हैं. साथ ही, इसमें मैन्युअल तरीके से साइन इन करने की सुविधा भी मिलती है. इसके लिए, उन्हें सिर्फ़ एक बार क्लिक करना होता है. इस दस्तावेज़ में, साइन इन करने के इन अलग-अलग तरीकों के बारे में बताया गया है.

खिलाड़ियों को अपने गेम में साइन इन कराने के लिए, साइन इन करने का यह तरीका अपनाएं:

गेम शुरू होने के दौरान, अपने-आप साइन-इन होने की सुविधा आज़माएं. इससे, खिलाड़ी अपने-आप साइन इन हो जाएगा.
अगर अपने-आप साइन इन होने की सुविधा काम नहीं करती है और उपयोगकर्ता का डिवाइस ऑनलाइन है, तो मैन्युअल तरीके से साइन इन करें.
अगर मैन्युअल तरीके से साइन इन करने का अनुरोध अस्वीकार कर दिया जाता है, तो उपयोगकर्ता की पसंद को याद रखें और उसे फिर से मैन्युअल तरीके से साइन इन करने का विकल्प न दिखाएं. हालांकि, स्टार्टअप पर अपने-आप साइन इन होने की सुविधा का इस्तेमाल जारी रखें.

इसके अलावा, आपको यह भी पक्का करना होगा कि उपयोगकर्ता, Play Games की सेवाओं वाले खाते से आपके गेम में साइन इन कर पाएं. इसके लिए, एक खास बटन उपलब्ध कराएं, जिसे आसानी से ढूंढा जा सके.

अपने-आप साइन-इन होने की सुविधा की मदद से, लोग बिना किसी रुकावट के आपके गेम में साइन इन कर सकते हैं. यह सुविधा अपने-आप काम करती है! अगर आपका गेम, उपयोगकर्ता से साइन इन करने का अनुरोध करता है और Google Play Games ऐप्लिकेशन में, अपने-आप साइन इन करने की सेटिंग चालू है, तो आपको उपयोगकर्ता के PGS आइडेंटिटी क्रेडेंशियल मिलेंगे. साथ ही, उपयोगकर्ता को PGS में साइन इन करने का विकल्प दिखेगा.

अपने-आप साइन-इन होने की सुविधा को उपयोगकर्ता कंट्रोल कर सकते हैं. उपयोगकर्ताओं के पास यह विकल्प होता है कि वे सभी गेम में अपने-आप साइन इन होने की सुविधा चालू करें या हर बार साइन इन करने का विकल्प चुनें.

अपने-आप साइन इन होने की सुविधा

अगर कोई उपयोगकर्ता गेम में अपने-आप साइन इन नहीं होता है, तो उससे मैन्युअल तरीके से साइन इन करने के लिए कहा जा सकता है. उपयोगकर्ता, आपके गेम के सबसे ऊपर दिखने वाले डायलॉग बॉक्स से एक क्लिक में साइन इन कर सकते हैं.

मैन्युअल तरीके से साइन इन करना

सही तरीके से साइन-इन करने के लिए, PGS पॉप-अप की अनुमति दें

PGS का इस्तेमाल करते समय, उपयोगकर्ताओं को यह पता होना चाहिए कि वे साइन इन हैं. ऐसा PGS में साइन-इन करने की सुविधा दिखाकर किया जाता है.

साइन-इन करने की सुविधा दिखाने के लिए, गेम शुरू होने के दौरान GamesClient क्लास के setViewForPopups() तरीके को कॉल करें. इससे उपयोगकर्ताओं को सही अनुभव मिलता है.

OAuth के दायरे और PGS

PGS, OAuth सिस्टम पर निर्भर करता है. इससे लोगों को अपने खाते का ऐक्सेस आपके गेम को देने की अनुमति मिलती है. OAuth स्कोप, ऐसी अनुमतियां होती हैं जिनका अनुरोध डेवलपर के तौर पर किया जा सकता है. अनुमति मिलने पर, आपका गेम उपयोगकर्ता की ओर से कुछ एपीआई कॉल कर सकता है. साथ ही, आपको उनके Google खाते के कुछ हिस्सों का ऐक्सेस भी मिल सकता है.

PGS का दायरा, गेम (games-lite) के लिए यूनीक होता है. अगर आपका गेम, सेव किए गए गेम की सुविधा का इस्तेमाल करता है, तो यह दूसरे दायरे (drive.appdata) पर निर्भर करता है. सेव किए गए गेम की सुविधा, उपयोगकर्ता को उसके Google Drive खाते का ऐक्सेस देती है. इसी खाते में गेम का डेटा सेव किया जाता है.

आपका गेम, उपयोगकर्ताओं को बेहतरीन अनुभव देने के लिए, किसी भी स्कोप का अनुरोध कर सकता है. आपका गेम, एक बंडल में उन सभी स्कोप का अनुरोध कर सकता है जिनकी उसे ज़रूरत है. इससे Google खाते के ऐक्सेस के लिए अनुरोधों की संख्या कम हो जाती है. हालांकि, इस तरीके में एक बड़ी समस्या है. अगर आपने PGS के लिए तय किए गए स्कोप से ज़्यादा स्कोप का अनुरोध किया है, तो अपने-आप साइन इन करने की सुविधा काम नहीं करेगी. अपने-आप साइन इन होने की सुविधा, खिलाड़ियों को आपके गेम में साइन इन कराने का सबसे अच्छा तरीका है.

स्कोप के लिए, एक-एक करके अनुरोध करना सबसे सही तरीका है. आपके गेम को शुरुआती अनुरोध में, सिर्फ़ PGS के स्कोप के लिए पूछना चाहिए. साथ ही, ज़्यादा काम के समय पर अन्य स्कोप के लिए अलग से अनुरोध करना चाहिए.

OAuth ऐक्सेस देने के लिए, हर स्कोप के लिए अलग स्क्रीन का इस्तेमाल किया जाता है. इससे उपयोगकर्ताओं को यह तय करने में मदद मिलती है कि किस स्कोप को ऐक्सेस देना है. सिर्फ़ PGS स्कोप के साथ अपने-आप साइन इन होने की सुविधा का इस्तेमाल करने पर, उपयोगकर्ताओं को किसी भी OAuth प्रॉम्प्ट के साथ इंटरैक्ट नहीं करना पड़ेगा. इससे साइन इन करने में आने वाली समस्याएं कम हो जाएंगी.

PGS, Android पर गेम खेलने वाले लोगों के लिए एक गेमिंग आइडेंटिटी उपलब्ध कराता है. हालांकि, यह ज़रूरी नहीं है कि यह आइडेंटिटी, आपके उपयोगकर्ताओं से जुड़ी एकमात्र आइडेंटिटी हो. PGS, सोशल नेटवर्क आईडी, और गेम में मौजूद आईडी सिस्टम का इस्तेमाल करके, एक ही समय में खिलाड़ियों को साइन इन किया जा सकता है. हर सिस्टम, आपको और आपके खिलाड़ियों को खास फ़ायदे देता है. साथ ही, ये सभी सिस्टम एक साथ काम करके, Android पर गेम खेलने वाले लोगों को शानदार अनुभव दे सकते हैं.

बैकएंड इंटिग्रेशन के लिए, प्लेयर की पहचान को सुरक्षित तरीके से वापस पाना और उसकी पुष्टि करना

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

इसके अलावा, कुछ पुराने गेम और खिलाड़ियों के लिए, Android एसडीके से मिले प्लेयर आईडी और उस प्लेयर के लिए अन्य खिलाड़ियों को दिखने वाले आईडी में अंतर हो सकता है. ऐसा तब होता है, जब वे एक ही गेम में उस प्लेयर की प्रोफ़ाइल देखते हैं. यह खास तौर पर तब होता है, जब दोस्तों की सूची का इस्तेमाल किया जा रहा हो. हालांकि, REST API में दिखने वाला player_id हमेशा एक जैसा होता है. साथ ही, यह हमेशा वही आईडी होता है जो अन्य खिलाड़ियों को दिखता है.

ज़्यादा जानकारी के लिए, ऑफ़लाइन ऐक्सेस और REST API से जुड़े दस्तावेज़ देखें.

क्लाइंट-साइड पर लागू करना

Android पर साइन-इन करने की सुविधा लागू करने का तरीका जानने के लिए, Android गेम में साइन-इन करना लेख पढ़ें.

साइन-इन संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.