Google Cloud में, Play Games Services प्रोजेक्ट की सेटिंग मैनेज करना

ऐसा हो सकता है कि आपको Google Cloud में, Play Games की सेवाओं के प्रोजेक्ट को सीधे तौर पर देखना और उसमें बदलाव करना पड़े.

आम तौर पर, इन स्थितियों में ऐसा करना पड़ सकता है:

• अपने प्रोजेक्ट के लिए, अतिरिक्त एपीआई (जैसे, Google Drive) चालू करना.
• OAuth 2.0 डायलॉग में, अपने गेम के ब्रैंडिंग की जानकारी में बदलाव करना.
• एपीआई का कोटा देखना और ज़रूरत पड़ने पर, ज़्यादा कोटा का अनुरोध करना.
• पहले बनाए गए क्लाइंट आईडी में, अनुमति वाले यूआरआई या JavaScript ऑरिजिन में बदलाव करना.

अपना प्रोजेक्ट देखना

Google Cloud में अपना प्रोजेक्ट देखने के लिए:

1. कॉन्फ़िगरेशन पेज (उपयोगकर्ता बढ़ाएं > Play Games की सेवाएं > सेटअप और मैनेजमेंट > कॉन्फ़िगरेशन) पर जाकर, अपने गेम के लिए कोई क्रेडेंशियल चुनें.
2. ऑथेंटिकेशन सेक्शन में जाएं और Google Cloud में देखें पर क्लिक करें.

एपीआई के इस्तेमाल के कोटे में बदलाव करना

Google Cloud में, अपने गेम के लिए सेट की गई एपीआई के इस्तेमाल की सीमाएं और इस्तेमाल किया गया कोटा देखा जा सकता है. इसके अलावा, हर उपयोगकर्ता के लिए सीमाएं सेट की जा सकती हैं, ताकि कोई ऐसा उपयोगकर्ता जो नियमों का उल्लंघन कर रहा है (या कोई ऐसा गेम क्लाइंट जिसमें गड़बड़ी है), आपके कोटे को खत्म न कर पाए.

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

1. अगर आपके प्रोजेक्ट के लिए कोई बिलिंग खाता नहीं है, तो एक खाता बनाएं.
2. एपीआई कंसोल में, एपीआई लाइब्रेरी के 'चालू किए गए एपीआई ' पेज पर जाएं और सूची में से कोई एपीआई चुनें.
3. कोटे से जुड़ी सेटिंग देखने और उनमें बदलाव करने के लिए, कोटे को चुनें. इस्तेमाल के आंकड़े देखने के लिए, इस्तेमाल को चुनें.

ध्यान दें कि "उपयोगकर्ता" की पहचान, कोटा के लिए अनुरोध करने वाले क्लाइंट के आईपी पते के आधार पर की जाती है. उदाहरण के लिए, अगर आपके सभी अनुरोध किसी एक सर्वर से आए हैं, तो हो सकता है कि उस सर्वर को गलती से स्पैम करने वाला एक उपयोगकर्ता के तौर पर टैग कर दिया जाए. इससे बचने के लिए, अपने एपीआई एंडपॉइंट के अनुरोधों में userIp=x.x.x.x आर्ग्युमेंट जोड़ा जा सकता है.

हर उपयोगकर्ता के लिए कोटे सेट करने के बारे में ज़्यादा जानने के लिए, एपीआई के इस्तेमाल पर सीमाएं तय करना लेख पढ़ें.

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

OAuth की दर की सीमाएं और नए उपयोगकर्ता की सीमाएं देखना

OAuth के लिए, उपयोगकर्ता की अनुमति देने की दर और नए उपयोगकर्ता की सीमाओं से जुड़े कोटे देखने के लिए:

1. Google Cloud Console पर जाएं.
2. पक्का करें कि आपने सही प्रोजेक्ट चुना हो.
3. एपीआई और सेवाएं > ऐसी स्क्रीन जहां OAuth के लिए सहमति दी जाती है पर जाएं.
4. इस पेज पर, उपयोगकर्ता की अनुमति देने की मौजूदा दर (या टोकन की अनुमति देने की दर) और नए उपयोगकर्ता की कुल सीमा देखी जा सकती है.

OAuth की दर की सीमाएं और OAuth के लिए सहमति वाली स्क्रीन पर, नए उपयोगकर्ता की सीमाएं.

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

ज़्यादा जानकारी के लिए, OAuth के लिए ऐप्लिकेशन की दर की सीमाएं लेख पढ़ें.

अन्य एपीआई चालू करना

Play Console में क्लाइंट आईडी बनाने पर, आपके प्रोजेक्ट के लिए Google Play की गेम सेवाओं का एपीआई अपने-आप चालू हो जाता है. Google Cloud से, Google के अन्य एपीआई चालू किए जा सकते हैं.

अपने प्रोजेक्ट के लिए कोई एपीआई चालू करने के लिए, यह तरीका अपनाएं:

1. Google API Console में, एपीआई लाइब्रेरी खोलें. प्रॉम्प्ट मिलने पर, कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं. एपीआई लाइब्रेरी में, उपलब्ध सभी एपीआई की सूची होती है. इन्हें प्रॉडक्ट फ़ैमिली और लोकप्रियता के हिसाब से ग्रुप में बांटा जाता है.

2. अगर आपको सूची में वह एपीआई नहीं दिख रहा है जिसे चालू करना है, तो उसे ढूंढने के लिए खोज का इस्तेमाल करें.

3. वह एपीआई चुनें जिसे चालू करना है. इसके बाद, चालू करें बटन पर क्लिक करें.

4. प्रॉम्प्ट मिलने पर, बिलिंग चालू करें.

5. प्रॉम्प्ट मिलने पर, एपीआई की सेवा की शर्तें स्वीकार करें.

ब्रैंडिंग की जानकारी में बदलाव करना

OAuth 2.0 डायलॉग में दिखने वाले अपने गेम के ब्रैंडिंग की जानकारी (टाइटल, लोगो वगैरह) में बदलाव करने के लिए, Google Cloud की सहमति वाली स्क्रीन में एट्रिब्यूट सेट करें.

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

1. Play Console में, सहमति वाली स्क्रीन का पेज खोलें. प्रॉम्प्ट मिलने पर, कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं.
2. फ़ॉर्म भरें और सेव करें पर क्लिक करें.

OAuth के उपयोगकर्ता का टाइप बदलना

अगर प्रोडक्शन (टेस्ट करें और रिलीज़ करें > प्रोडक्शन) टेस्टिंग ट्रैक में, निजी टेस्टिंग खाते का इस्तेमाल करके टेस्ट किया जा रहा है, तो आपको Google Cloud में, OAuth की ऑडियंस की सेटिंग को बाहरी के तौर पर भी कॉन्फ़िगर करना होगा. ज़्यादा जानकारी के लिए, ऐप्लिकेशन की ऑडियंस मैनेज करना लेख पढ़ें.

क्लाइंट आईडी से जुड़े एट्रिब्यूट में बदलाव करना

अहम जानकारी: अगर वेब ऐप्लिकेशन का लॉन्च यूआरएल बदला जाता है, तो Play Console में भी बदलाव करना होगा. इसके लिए, इस सेक्शन में दिए गए निर्देशों का पालन करें. ऐसा करने से, origin_mismatch गड़बड़ियां मिलने से बचा जा सकता है. अगर Android ऐप्लिकेशन के पैकेज का नाम बदला जाता है, तो आपको लिंक किए गए ऐप्लिकेशन की नई एंट्री बनानी होगी. साथ ही, लिंक किए गए ऐप्लिकेशन की उस मौजूदा एंट्री को हटाना होगा जिसमें पैकेज का पुराना नाम है.

अपने OAuth 2.0 क्लाइंट आईडी (वेब ऐप्लिकेशन के लिए वेब ऑरिजिन और रीडायरेक्ट यूआरएल वगैरह) से जुड़े एट्रिब्यूट में बदलाव करने के लिए:

1. Play Console खोलें और अपने गेम पर जाएं.
2. कॉन्फ़िगरेशन पेज (उपयोगकर्ता बढ़ाएं > Play Games की सेवाएं > सेटअप और मैनेजमेंट > कॉन्फ़िगरेशन) पर जाकर, अपने गेम के लिए कोई क्रेडेंशियल चुनें.
3. ऑथेंटिकेशन सेक्शन में सबसे नीचे तक स्क्रोल करें और Google Cloud में देखें पर क्लिक करें.
4. Google Cloud में, अपना प्रोजेक्ट चुनें.
5. बाईं ओर मौजूद साइडबार में, एपीआई और ऑथेंटिकेशन को चुनें. पक्का करें कि एपीआई की दिखाई गई सूची में, Google Play की गेम सेवाओं के एपीआई की स्थिति चालू हो.
6. बाईं ओर मौजूद साइडबार में, रजिस्टर किए गए ऐप्लिकेशन को चुनें.
7. OAuth 2.0 क्लाइंट आईडी सेक्शन को बड़ा करें और वह एट्रिब्यूट ढूंढें जिसमें बदलाव करना है.

OAuth क्लाइंट को किसी मौजूदा Cloud प्रोजेक्ट से माइग्रेट करना

Google Cloud में अपना प्रोजेक्ट देखने के लिए, अपना प्रोजेक्ट देखना में दिया गया तरीका अपनाएं.

Play Games की सेवाओं (पीजीएस) को सेट अप करने के लिए, Google Cloud का एक यूनीक प्रोजेक्ट ज़रूरी है. अगर कई गेम, Cloud के एक ही प्रोजेक्ट को शेयर करते हैं, तो आपको उनके Android OAuth क्लाइंट को अलग-अलग प्रोजेक्ट में माइग्रेट करना होगा, ताकि यह पक्का किया जा सके कि वे सही तरीके से कॉन्फ़िगर किए गए हैं.

पहली इमेज. Google Cloud के एक प्रोजेक्ट को शेयर करने वाले गेम 1 और गेम 2 का उदाहरण

ऊपर दिए गए उदाहरण में, गेम 1 और गेम 2 ने 'Google से साइन इन करें' सुविधा के लिए, वेब और Android क्लाइंट, Google Cloud के एक ही प्रोजेक्ट में बनाए हैं. हमें गेम 2 के वेब और Android क्लाइंट को, Google Cloud के मौजूदा लेगसी प्रोजेक्ट से, Google Cloud के नए टारगेट प्रोजेक्ट में ले जाना होगा.

दूसरी इमेज. गेम 2 के क्लाइंट को, Google Cloud के नए टारगेट प्रोजेक्ट में माइग्रेट करना

पहला चरण: बैकएंड की तैयारी करना

स्विच करने से पहले, आपको अपने बैकएंड और क्लाइंट में बदलाव करना होगा, ताकि वे वेब क्लाइंट आईडी के पुराने और नए, दोनों वर्शन को एक साथ हैंडल कर सकें.

• सर्वर-साइड कॉन्फ़िगरेशन: अगर आपका सर्वर, आईडी टोकन में वेब क्लाइंट आईडी की पुष्टि करता है, तो आपको अपने सर्वर-साइड लॉजिक को अपडेट करना होगा, ताकि वह लेगसी Cloud प्रोजेक्ट में मौजूद पुराने क्लाइंट और टारगेट Cloud प्रोजेक्ट में जनरेट किए जाने वाले नए क्लाइंट, दोनों से जारी किए गए आईडी टोकन को एक साथ सपोर्ट कर सके.
• क्लाइंट-साइड कॉन्फ़िगरेशन: स्विच करते समय, नए वेब क्लाइंट आईडी का इस्तेमाल करके साइन इन करने के लिए, आपके क्लाइंट ऐप्लिकेशन को वेब क्लाइंट के कई आईडी को सपोर्ट करना होगा. इसके लिए, इनमें से कोई भी तरीका इस्तेमाल किया जा सकता है:
  • क्लाइंट ऐप्लिकेशन में, वेब क्लाइंट के दो आईडी पहले से मौजूद हों. पुराना क्लाइंट आईडी खत्म होने पर, नए वेब क्लाइंट आईडी पर स्विच किया जाए
  • स्विच करने की प्रोसेस पूरी करने के लिए, सर्वर से वेब क्लाइंट का नया आईडी डाइनैमिक तरीके से हासिल किया जाए
• वेब क्लाइंट पहले से बनाना: टारगेट प्रोजेक्ट में, आपको वेब क्लाइंट पहले से बनाना होगा, ताकि एटॉमिक स्विच के दौरान होने वाली संभावित देरी से बचा जा सके.

दूसरा चरण: Google Cloud के सही प्रोजेक्ट में, वेब और Android के नए OAuth क्लाइंट कॉन्फ़िगर करना

दूसरा चरण: Google Cloud के टारगेट प्रोजेक्ट में, गेम 2 के लिए वेब का नया OAuth क्लाइंट बनाना:

तीसरी इमेज. वेब का नया OAuth क्लाइंट बनाना

दूसरा चरण: चेतावनी: Android क्लाइंट में बदलाव करने पर, आपके गेम के उपयोगकर्ता 'Google से साइन इन करें' सुविधा का इस्तेमाल करके, आपके गेम में साइन इन नहीं कर पाएंगे. इसलिए, आपको दूसरे चरण के बाद तुरंत तीसरा चरण पूरा करना होगा. कार्रवाइयों के लिए, एक साथ दो वेब पेज खोलने का सुझाव दिया जाता है, ताकि बदलाव और फिर से बनाने के बीच का समय कम किया जा सके.

Google Cloud के लेगसी प्रोजेक्ट में, गेम 2 के Android क्लाइंट के पैकेज का नाम बदलकर कोई अमान्य वैल्यू डालें. जैसे, com.noexist.none.

चौथी इमेज. लेगसी प्रोजेक्ट में, Android क्लाइंट के पैकेज का नाम बदलना

तीसरा चरण: Google Cloud के टारगेट प्रोजेक्ट में, गेम 2 के लिए तुरंत Android का नया क्लाइंट बनाएं.इसमें, गेम 2 का SHA-1 फ़िंगरप्रिंट और पैकेज का नाम वही रखें:

पांचवी इमेज. टारगेट प्रोजेक्ट में, Android का नया क्लाइंट बनाना

तीसरा चरण: रीयल-टाइम कॉन्फ़िगरेशन डिप्लॉयमेंट

टारगेट प्रोजेक्ट में, Android का नया क्लाइंट बनाने के बाद, तुरंत यह तरीका अपनाएं:

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