Google Play Game Services

Google Play की गेम सेवा, डेवलपर को सोशल लीडरबोर्ड, उपलब्धियां, गेम की स्थिति, Google से साइन-इन वगैरह की मदद से, गेम को बेहतर बनाने की सुविधा देती है.

सेवा: game.googleapis.com

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

डिस्कवरी दस्तावेज़

डिस्कवरी दस्तावेज़ एक ऐसी खास जानकारी है जिसे मशीन आसानी से पढ़ सकती है. इससे REST API के बारे में जानकारी मिलती है और उसका इस्तेमाल किया जाता है. इसका इस्तेमाल क्लाइंट लाइब्रेरी, IDE प्लगिन, और Google API के साथ इंटरैक्ट करने वाले अन्य टूल बनाने के लिए किया जाता है. एक सेवा में, आपकी खोज से जुड़े कई दस्तावेज़ मिल सकते हैं. यह सेवा, खोज के लिए ये दस्तावेज़ उपलब्ध कराती है:

सर्विस एंडपॉइंट

सेवा एंडपॉइंट एक बेस यूआरएल होता है, जो किसी एपीआई सेवा के नेटवर्क पते के बारे में बताता है. एक सेवा में एक से ज़्यादा सेवा एंडपॉइंट हो सकते हैं. इस सेवा में नीचे दिया गया सर्विस एंडपॉइंट है और नीचे दिए गए सभी यूआरआई, इस सर्विस एंडपॉइंट से जुड़े हैं:

  • https://games.googleapis.com

REST रिसॉर्स: achievementDefinitions

तरीके
list GET /games/v1/achievements
इसमें आपके आवेदन की सभी उपलब्धियों की परिभाषाएं दी गई होती हैं.

REST रिसॉर्स: उपलब्धियां

तरीके
increment POST /games/v1/achievements/{achievementId}/increment
पुष्टि किए गए मौजूदा खिलाड़ी के लिए दिए गए आईडी के साथ, उपलब्धि के चरणों को बढ़ाता है.
list GET /games/v1/players/{playerId}/achievements
यह बताता है कि जिस खिलाड़ी की पुष्टि हो चुकी है वह आपके आवेदन की सभी उपलब्धियों की प्रोग्रेस देख सकता है.
reveal POST /games/v1/achievements/{achievementId}/reveal
मौजूदा पुष्टि किए गए खिलाड़ी के लिए, दिए गए आईडी के साथ उपलब्धि की स्थिति को REVEALED पर सेट करता है.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
यह नीति, प्रमाणित किए गए मौजूदा खिलाड़ी के लिए कोई उपलब्धि अनलॉक करने का तरीका बताती है.
unlock POST /games/v1/achievements/{achievementId}/unlock
पुष्टि किए गए मौजूदा खिलाड़ी के लिए यह उपलब्धि अनलॉक करती है.
updateMultiple POST /games/v1/achievements/updateMultiple
पुष्टि किए गए मौजूदा खिलाड़ी की कई उपलब्धियां अपडेट करता है.

REST रिसॉर्स: ऐप्लिकेशन

तरीके
get GET /games/v1/applications/{applicationId}
दिए गए आईडी से ऐप्लिकेशन का मेटाडेटा वापस लाता है.
getEndPoint POST /games/v1/applications/getEndPoint
अनुरोध किए गए एंड पॉइंट टाइप के लिए यूआरएल दिखाता है.
played POST /games/v1/applications/played
इससे पता चलता है कि जिस उपयोगकर्ता की पुष्टि की गई है वह आपका ऐप्लिकेशन इस्तेमाल कर रहा है.
verify GET /games/v1/applications/{applicationId}/verify
यह पुष्टि करता है कि इस अनुरोध के साथ दिए गए, पुष्टि करने वाले टोकन, तय किए गए आईडी वाले ऐप्लिकेशन के लिए हैं. साथ ही, उस प्लेयर का आईडी लौटाता है जिसके लिए इसे दिया गया था.

REST रिसॉर्स: इवेंट

तरीके
listByPlayer GET /games/v1/events
यह विकल्प दिखाता है कि मौजूदा समय में पुष्टि किए गए उपयोगकर्ता के लिए, इस ऐप्लिकेशन में इवेंट की मौजूदा प्रोग्रेस कितनी है.
listDefinitions GET /games/v1/eventDefinitions
इस ऐप्लिकेशन में इवेंट की परिभाषाओं की सूची दिखाता है.
record POST /games/v1/events
यह जानकारी, इस ऐप्लिकेशन के मौजूदा पुष्टि किए गए उपयोगकर्ता के लिए, इवेंट होने की संख्या में हुए बदलावों के बैच को रिकॉर्ड करती है.

REST रिसॉर्स: लीडरबोर्ड

तरीके
get GET /games/v1/leaderboards/{leaderboardId}
दिए गए आईडी से लीडरबोर्ड का मेटाडेटा वापस लाता है.
list GET /games/v1/leaderboards
इसमें आपके ऐप्लिकेशन के लिए, लीडरबोर्ड का पूरा मेटाडेटा मौजूद होता है.

REST रिसॉर्स: मेटागेम

तरीके
getMetagameConfig GET /games/v1/metagameConfig
कॉल करने वाले ऐप्लिकेशन के लिए मेटागेम कॉन्फ़िगरेशन डेटा दें.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
playerId से जुड़े प्लेयर के लिए, हर कैटगरी के हिसाब से इकट्ठा किया गया Play डेटा की सूची बनाएं.

REST रिसॉर्स: खिलाड़ी

तरीके
get GET /games/v1/players/{playerId}
दिए गए आईडी से प्लेयर के संसाधन को फिर से हासिल करता है.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
पुष्टि किए गए मौजूदा खिलाड़ी के लिए, उन सभी गेम के लिए ऐप्लिकेशन प्लेयर आईडी पाएं जिनका अनुरोध एक ही डेवलपर ने किया है.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
यह प्रॉपर्टी, मौजूदा समय में पुष्टि किए गए उपयोगकर्ता के लिए स्कोप किए गए प्लेयर आइडेंटिफ़ायर को फिर से हासिल करती है.
list GET /games/v1/players/me/players/{collection}
उस उपयोगकर्ता के लिए प्लेयर का कलेक्शन पाएं जिसकी पुष्टि हो चुकी है.

REST रिसॉर्स: recall

तरीके
linkPersona POST /games/v1/recall:linkPersona
दिए गए रीकॉल सेशन आईडी में, पीजीएस प्लेयर के मुख्य खाते को इन-गेम खाते से जोड़ें
resetPersona POST /games/v1/recall:resetPersona
दिए गए पर्सोना को प्रोफ़ाइल के साथ या उसके बिना, किसी भी खिलाड़ी से लिंक करने वाले सभी रीकॉल टोकन मिटाएं.
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
PGS प्लेयर के मुख्य खाते से जुड़े सभी रीकॉल टोकन वापस पाएं. ये टोकन, दिए गए रीकॉल सेशन आईडी में कोड में बदले गए हैं.
unlinkPersona POST /games/v1/recall:unlinkPersona
पीजीएस प्लेयर के मुख्य खाते को लिंक करने वाला रीकॉल टोकन मिटाएं. यह टोकन, रीकॉल सेशन से पहचाना गया है. साथ ही, 'पर्सोना' या टोकन वैल्यू से पहचाने गए इन-गेम खाते से जुड़ा है.

REST रिसॉर्स: बदलाव

तरीके
check GET /games/v1/revisions/check
यह पता लगाता है कि गेम क्लाइंट पुराना है या नहीं.

REST रिसॉर्स: स्कोर

तरीके
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
पुष्टि किए गए मौजूदा खिलाड़ी के लिए लीडरबोर्ड में सबसे ज़्यादा स्कोर और वैकल्पिक रैंक पाएं.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
लीडरबोर्ड में, सबसे ऊपर से शुरू करते हुए स्कोर की सूची होती है.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
लीडरबोर्ड में, किसी खिलाड़ी के स्कोर के आस-पास और उसके स्कोर की सूची बनाई जाती है.
submit POST /games/v1/leaderboards/{leaderboardId}/scores
चुने गए लीडरबोर्ड पर स्कोर सबमिट करता है.
submitMultiple POST /games/v1/leaderboards/scores
लीडरबोर्ड पर एक से ज़्यादा स्कोर सबमिट करता है.

REST रिसॉर्स: स्नैपशॉट

तरीके
get GET /games/v1/snapshots/{snapshotId}
किसी दिए गए स्नैपशॉट आईडी के लिए मेटाडेटा वापस लाता है.
list GET /games/v1/players/{playerId}/snapshots
आपके ऐप्लिकेशन में प्लेयर आईडी से जुड़े प्लेयर के लिए बनाए गए स्नैपशॉट की सूची वापस लाता है.

REST रिसॉर्स: आंकड़े

तरीके
get GET /games/v1/stats
इस ऐप्लिकेशन में, पुष्टि किए गए मौजूदा उपयोगकर्ता के लिए, यूज़र ऐक्टिविटी और खर्च के आंकड़े दिखाता है.