पहचान और खाता लिंक करना

Google Play Games की सेवाओं की पुष्टि करने की सुविधा का इस्तेमाल करें. इससे, आपके गेम में उपयोगकर्ता के प्लैटफ़ॉर्म की पुष्टि करने की प्रोसेस को आसान बनाया जा सकता है. पुष्टि करने की प्रोसेस शुरू करने के लिए, Play Games Services SDK टूल को शुरू करें. इससे, अलग प्लैटफ़ॉर्म पर पुष्टि करने की प्रोसेस की ज़रूरत नहीं पड़ती.

उपयोगकर्ता खातों को लिंक करना, ताकि एक डिवाइस पर शुरू किया गया कॉन्टेंट दूसरे डिवाइस पर भी चलाया जा सके

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

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

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

• खाता लिंक करना
• क्लाउड सेव

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

Play Games की सेवाओं का नया इंटिग्रेशन

जिन गेम में Play की गेम सेवाओं का इंटिग्रेशन पहले से मौजूद नहीं है उनके लिए, Recall API बैकएंड सेटअप को आसान बनाता है. यह खाते के असोसिएशन मैनेज करता है. साथ ही, किसी व्यक्ति के गेम खाते और उसके Play की गेम सेवाओं वाले खाते के बीच कनेक्शन को सेव करता है.

Recall API का इस्तेमाल करके खाता लिंक करना

अलग-अलग प्लैटफ़ॉर्म पर उपलब्ध गेम में उपयोगकर्ता खातों को लिंक करने के लिए, Recall API का इस्तेमाल करने का सुझाव दिया जाता है. यह एपीआई खास तौर पर उन गेम के लिए फ़ायदेमंद है जिनमें Play की गेम सेवाओं को इंटिग्रेट नहीं किया गया है. इसके अलावा, यह उन गेम के लिए भी फ़ायदेमंद है जो Play की गेम सेवाओं के अलावा, प्लैटफ़ॉर्म पर पुष्टि करने के अन्य समाधानों का इस्तेमाल करते हैं.

Recall API, खाते के असोसिएशन मैनेज करके, आपके गेम के बैकएंड सेटअप को आसान बनाता है.

• आसान बैकएंड: एपीआई, खाता लिंक करने के लिए आपके गेम के बैकएंड सेटअप को आसान बनाता है.
• Play की ओर से मैनेज किए जाने वाले असोसिएशन: Play, उपयोगकर्ताओं के गेम खातों (इसमें तीसरे पक्ष के खाते भी शामिल हैं) और उनके Play की गेम सेवाओं के खातों के बीच के असोसिएशन को सेव करता है.
• प्रोग्रेस को पहले जैसा करना: डेवलपर, Play को Recall टोकन जनरेट करके भेजते हैं. इसके बाद, इन टोकन को वापस पाकर, किसी उपयोगकर्ता की गेम प्रोग्रेस को पहले जैसा किया जा सकता है.

Recall API लागू करते समय, डेवलपर को यह पुष्टि करनी होगी कि रिकॉल टोकन अपारदर्शी स्ट्रिंग हैं. इन टोकन में, गेम खेलने वालों के बारे में कोई भी संवेदनशील या व्यक्तिगत पहचान से जुड़ी जानकारी नहीं होनी चाहिए. जैसे, नाम, ईमेल पता या डेमोग्राफ़िक.

उपयोगकर्ता के डेटा को सुरक्षित रखने और सुरक्षा बनाए रखने के लिए, गेम को रिकॉल टोकन जनरेट करते समय, बेहतर एन्क्रिप्शन एल्गोरिदम का इस्तेमाल करना चाहिए.

Recall के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, Recall API देखें.

Recall API की सुविधा लागू करने के लिए, अपने गेम में Play की गेम सेवाओं वाले Recall API को इंटिग्रेट करना लेख पढ़ें.

Recall API की मदद से एक से ज़्यादा खाते मैनेज करना

एक ही उपयोगकर्ता के लिए कई खातों को मैनेज करते समय, हर खाते को एक अलग पर्सोना के तौर पर माना जा सकता है. इस तरीके से, उपयोगकर्ता की ज़रूरत के हिसाब से अनुभव दिए जा सकते हैं.

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

• हर पर्सोना के लिए एक यूनीक टोकन जनरेट करें. गेम क्लाइंट सेटअप करना लेख पढ़ें.
• Recall API का इस्तेमाल करके, इन टोकन को Play की गेम सेवाओं के खाते से लिंक करें. स्टोर टोकन देखें.
• उन स्थितियों के लिए नीति सेट करना जिनमें Play की गेम सेवाओं का खाता, एक से ज़्यादा पर्सोना से लिंक होता है. डेवलपर खातों के मालिकाना हक वाले सभी गेम के लिए, रीकॉल टोकन की नई जानकारी देखें.

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

ध्यान दें: जब एक Play Games Services खाते से कई खाते लिंक होते हैं, तो लिंक किए गए खातों को स्विच करने से Play Games Services के गेमप्ले में कोई बदलाव नहीं होता. जैसे, उपलब्धियां और लीडरबोर्ड के स्कोर. उदाहरण के लिए, अगर खाता A और खाता B, दोनों एक ही Play Games Services प्रोफ़ाइल से लिंक हैं, तो खाता A के लिए अनलॉक की गई उपलब्धियां, खाता B के लिए फिर से अनलॉक नहीं की जाती हैं. भले ही, खाता B एक ही लेवल या गेम लूप को फिर से चला सकता हो.

Play Games की सेवाओं का मौजूदा इंटिग्रेशन

इस सेक्शन में, प्लेयर खातों को बाइंड करके अपने गेम को Play की गेम सेवाओं के साथ इंटिग्रेट करने का तरीका बताया गया है. यह जानें कि पुष्टि किए गए खिलाड़ियों की पहचान करने के लिए, प्लेयर आईडी का इस्तेमाल कैसे किया जाता है. साथ ही, Play की गेम सेवाओं के किसी एक उपयोगकर्ता के लिए, एक से ज़्यादा गेम खातों को कैसे मैनेज किया जाता है.

Player_id के साथ बाइंड करें

प्लेयर आईडी, Play की गेम सेवाओं के प्लेयर खाते का आइडेंटिफ़ायर होता है. आपका गेम, ऐसे किसी भी खिलाड़ी के लिए प्लेयर आईडी वापस पा सकता है जिसने Play Games की सेवाओं का इस्तेमाल करके, आपके गेम में पुष्टि की है.

जिन गेम का बैकएंड, Play Games की सेवाओं के साथ सेट अप किया गया है Player_Id या जिन गेम में बच्चों के लिए सहायता की ज़रूरत होती है उन्हें Player_Id का इस्तेमाल करना चाहिए. साथ ही, अपने गेम और तीसरे पक्ष के खातों को Player_Id से लिंक करना चाहिए.

जानें कि प्लेयर आईडी कैसे काम करते हैं:

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

ज़्यादा जानकारी के लिए, नई जनरेशन वाले प्लेयर आईडी देखें.

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

उपयोगकर्ता के एक से ज़्यादा खातों को Play की गेम सेवाओं के एक ही खाते से लिंक करने के लिए, अपनी टेबल में एक से ज़्यादा मैपिंग बनाएं.

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

'Google से साइन इन करें' सुविधा का इस्तेमाल करके, Google की क्रॉस-प्लैटफ़ॉर्म पहचान

Google से साइन इन करें (SiwG), Google का मुख्य आइडेंटिटी सॉल्यूशन है. इसकी मदद से गेम डेवलपर, गेम खेलने वाले लोगों की प्रोफ़ाइल की जानकारी सुरक्षित तरीके से पा सकते हैं. जैसे, उनका नाम, ईमेल पता, और प्रोफ़ाइल फ़ोटो.

'Google से साइन इन करें' सुविधा का एक मुख्य फ़ायदा यह है कि यह वेब, Android, और iOS जैसे कई प्लैटफ़ॉर्म पर उपलब्ध है. इससे खिलाड़ियों को तेज़ी से, सुरक्षित तरीके से, और भरोसेमंद तरीके से साइन-इन करने का अनुभव मिलता है.

अहम जानकारी: 'Google से साइन इन करें' सुविधा और Google Play Games Services की पुष्टि करने की सुविधा, दोनों अलग-अलग हैं. इसके बजाय, 'Google से साइन इन करें' सुविधा को इस तरह से डिज़ाइन किया गया है कि यह आपके आइडेंटिटी सॉल्यूशन या Play की गेम सेवाओं के इंटिग्रेशन को बेहतर बनाए, न कि उसे बदले.

Google आईडी टोकन के sub फ़ील्ड से बाइंड करें

अलग-अलग प्लैटफ़ॉर्म पर एक जैसा अनुभव देने के लिए, पुष्टि करने की ऐसी रणनीति लागू की जा सकती है जो आपके गेम के खाता सिस्टम को Google खाते के यूनीक आइडेंटिफ़ायर से लिंक करती हो. इस तरीके में, Android पर Play Games Services की पुष्टि करने की सुविधा का इस्तेमाल किया जाता है. साथ ही, iOS और वेब जैसे अन्य प्लैटफ़ॉर्म पर, 'Google से साइन इन करें' सुविधा वाले स्टैंडर्ड SDK टूल का इस्तेमाल किया जाता है.

इस रणनीति की मुख्य वजह, Google आईडी टोकन का sub फ़ील्ड है. sub (या "विषय") फ़ील्ड, Google उपयोगकर्ता के खाते के लिए एक यूनीक और स्थायी आइडेंटिफ़ायर होता है. इस आईडी का इस्तेमाल "ब्रिज" के तौर पर किया जाएगा. इससे किसी खिलाड़ी के सभी सेशन को आपके बैकएंड में मौजूद एक गेम खाते से लिंक किया जा सकेगा.

यहां हाई-लेवल फ़्लो दिया गया है:

• Android पर: आपका गेम, Play Games Services SDK टूल को शुरू करता है, ताकि Android डिवाइसों पर पुष्टि करने की प्रोसेस अपने-आप शुरू हो जाए. आपने Play Games Services v2 के इंटिग्रेशन को कॉन्फ़िगर किया हो, ताकि वह तीन साइन-इन स्कोप के लिए अनुरोध कर सके: email, profile, और openid. ये वही स्कोप हैं जिनके लिए, 'Google से साइन इन करें' सुविधा देने वाला स्टैंडर्ड एसडीके अनुरोध करता है. इससे आपको ऐसा आईडी टोकन मिलता है जिसमें प्लेयर का sub फ़ील्ड शामिल होता है.
• वेब और iOS पर: आपका गेम, स्टैंडर्ड वेब के लिए 'Google से साइन इन करें' और iOS और macOS के लिए Google साइन इन SDK टूल का इस्तेमाल करता हो. जब उपयोगकर्ता साइन इन करता है, तो SiwG SDK एक आईडी टोकन उपलब्ध कराता है. इसमें उपयोगकर्ता का sub फ़ील्ड भी शामिल होता है.
• खाता लिंक करना: उपयोगकर्ता दोनों प्लैटफ़ॉर्म पर एक ही Google खाते से साइन इन कर रहा है. इसलिए, आपको मिलने वाला sub फ़ील्ड एक जैसा होगा. इसके बाद, इस sub वैल्यू को अपने आइडेंटिटी सलूशन में मौजूद इंटरनल यूज़र आईडी से आसानी से बाइंड किया जा सकता है. इससे उपयोगकर्ताओं को बेहतर अनुभव मिलता है.

Android पर इंटिग्रेशन

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

बड़े लेवल पर, लागू करने की प्रोसेस में ये चरण शामिल होते हैं:

1. एक ही प्रोजेक्ट में क्लाइंट आईडी सेट अप करना: इंटिग्रेट करने से पहले, आपको Google Play Console में Play Games Services सेट अप करनी होगी, ताकि आपको OAuth 2.0 क्लाइंट आईडी मिल सकें.

   अहम जानकारी: अलग-अलग प्लैटफ़ॉर्म को लिंक करने के लिए, इस Google Cloud प्रोजेक्ट का इस्तेमाल सभी प्लैटफ़ॉर्म के लिए किया जाना चाहिए. बाद में, अन्य प्लैटफ़ॉर्म (जैसे कि वेब और iOS) के लिए बनाए गए सभी क्लाइंट आईडी को इसी प्रोजेक्ट में जोड़ना होगा.

2. Play की गेम सेवाओं को कॉन्फ़िगर करें: शुरू करने से पहले, आपको Google Play Console में अपना गेम जोड़ना होगा. साथ ही, अपने गेम में Play की गेम सेवाओं के प्लैटफ़ॉर्म की पुष्टि करने की सुविधा को इंटिग्रेट करना होगा.

3. 'Google से साइन इन करें' बटन जोड़ें: अपने गेम के साइन-इन पेज या उपयोगकर्ता सेटिंग स्क्रीन पर, "Google से साइन इन करें" बटन जोड़ें. इस बटन से, साइन इन या साइन अप करने की प्रोसेस शुरू हो जाएगी. इस बटन को बनाते समय, हमारा सुझाव है कि आप 'Google से साइन इन करें' सुविधा के लिए ब्रैंडिंग के दिशा-निर्देशों का पालन करें. बटन पर कम से कम "Google" या "Google से साइन इन करें" साफ़ तौर पर दिखना चाहिए. दिशा-निर्देशों के लिंक में, डाउनलोड की जा सकने वाली ऐसी यूज़र एक्सपीरियंस (यूएक्स) ऐसेट भी दी गई हैं जो ज़रूरी शर्तों का पालन करती हैं. इनका इस्तेमाल आपके गेम में किया जा सकता है.

4. साइन-इन स्कोप के साथ सर्वर ऑथराइज़ेशन कोड का अनुरोध करना: जब खिलाड़ी बटन पर क्लिक करता है, तब आपका गेम एक बार इस्तेमाल किया जा सकने वाला सर्वर ऑथराइज़ेशन कोड का अनुरोध करता है. सबसे ज़रूरी चरण यह है कि इस अनुरोध को कॉन्फ़िगर किया जाए, ताकि इसमें ये साइन-इन स्कोप शामिल हों: EMAIL, PROFILE, और OPEN_ID.

   इसे कॉन्फ़िगर करने का तरीका, आपके डेवलपमेंट एनवायरमेंट पर निर्भर करता है:

   • Java/Kotlin के लिए: requestServerSideAccess का इस्तेमाल करके, सर्वर ऑथराइज़ेशन कोड पाने के लिए गाइड देखें.

   • Unity के लिए: Unity में पुष्टि करने वाले कोड वापस पाने से जुड़ी गाइड देखें.

5. बैकएंड पर ऑथराइज़ेशन कोड को एक्सचेंज करें और आईडी टोकन की पुष्टि करें: पिछले चरण से मिले ऑथराइज़ेशन कोड को अपने बैकएंड सर्वर पर भेजें. सर्वर पर, कोड को आईडी टोकन, ऐक्सेस टोकन, और रीफ़्रेश टोकन के लिए स्वैप करने के लिए, OAuth 2.0 कोड एक्सचेंज फ़्लो की स्टैंडर्ड गाइड का पालन करें. गाइड में बताए गए तरीके के मुताबिक, आपको अपने सर्वर पर आईडी टोकन की पुष्टि करनी होगी.

6. sub फ़ील्ड को बाइंड करें: आईडी टोकन की पुष्टि हो जाने के बाद, इसके पेलोड से sub फ़ील्ड को निकालें. इस sub वैल्यू का इस्तेमाल, Google Identity के लिए यूनीक कुंजी के तौर पर करें.

   • अगर आपके डेटाबेस में sub की यह वैल्यू पहले से मौजूद है, तो इसका मतलब है कि उपयोगकर्ता ने पहले भी खाता लिंक किया था. उन्हें उनके गेम खाते में साइन इन कराएं.

   • अगर यह sub वैल्यू मौजूद नहीं है, तो आपके पास दो विकल्प हैं. पहला, अपने गेम के खाता सिस्टम में इस sub से जुड़ा नया उपयोगकर्ता खाता बनाएं. दूसरा, अपने खाता सिस्टम में मौजूद किसी उपयोगकर्ता खाते से लिंक करें. इसके लिए, आईडी टोकन में दी गई उपयोगकर्ता की जानकारी (जैसे कि ईमेल पता) को मैच करें.

iOS, वेब, और अन्य प्लैटफ़ॉर्म पर इंटिग्रेशन

Android, iOS, वेब या पीसी के अलावा अन्य प्लैटफ़ॉर्म पर, आपको 'Google से साइन इन करें' सुविधा वाले स्टैंडर्ड SDK टूल इस्तेमाल करने होंगे. इसका मकसद Android के फ़्लो जैसा ही है: सुरक्षित तरीके से Google आईडी टोकन पाना, उसे अपने बैकएंड पर भेजना, और खाते को लिंक करने के लिए sub फ़ील्ड का इस्तेमाल करना.

बड़े लेवल पर, लागू करने की प्रोसेस में ये चरण शामिल होते हैं:

1. क्लाइंट-साइड इंटिग्रेशन: अपने प्लैटफ़ॉर्म के लिए, 'Google से साइन इन करें' सुविधा वाले एसडीके को इंटिग्रेट करने के लिए, आधिकारिक दस्तावेज़ में दिए गए निर्देशों का पालन करें. इन गाइड में, क्लाइंट-साइड के पूरे फ़्लो के बारे में बताया गया है. इसमें, 'Google से साइन इन करें' बटन को रेंडर करने से लेकर आईडी टोकन को वापस पाने तक की जानकारी शामिल है.

   • वेब के लिए: वेब के लिए Google से साइन इन करें

   • iOS के लिए: iOS और macOS के लिए Google साइन इन

   • जिन प्लैटफ़ॉर्म के लिए कोई एसडीके उपलब्ध नहीं है (जैसे कि कस्टम गेम इंजन या पीसी बिल्ड), उनके लिए ज़रूरी टोकन पाने के लिए, OAuth 2.0 वेब सर्वर फ़्लो को मैन्युअल तरीके से लागू किया जा सकता है.

2. बैकएंड लॉजिक: आईडी टोकन (या पुष्टि करने वाला कोड) को अपने बैकएंड पर भेजें. इसके बाद, आपका सर्वर ठीक उसी तरह से पुष्टि करता है और sub फ़ील्ड बाइंडिंग लॉजिक का इस्तेमाल करता है जैसा कि "Android पर इंटिग्रेशन" सेक्शन के चौथे और पांचवें चरण में बताया गया है.

'Google से साइन इन करें' के सभी फ़्लो में मौजूद sub फ़ील्ड, Android पर Google Play Games Services के फ़्लो से मिले फ़ील्ड के जैसा ही होता है. इसलिए, यह प्रोसेस सभी प्लैटफ़ॉर्म पर उपयोगकर्ता के खाते को लिंक कर देती है.