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

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

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

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

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

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

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

Play Games Services का नया इंटिग्रेशन

जिन गेम में 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 की मदद से एक से ज़्यादा खाते मैनेज करना

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

इस रणनीति के लिए, 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 क्लाइंट आईडी मिल सकें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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