Google Play Games Services API

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

सेवा: games.googleapis.com

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

खोज से जुड़ा दस्तावेज़

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

सेवा का एंडपॉइंट

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

  • https://games.googleapis.com

REST रिसॉर्स: accesstokens

तरीके
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
यह अटैच किए गए क्रेडेंशियल से पहचाने गए PGS उपयोगकर्ता के लिए, Play Grouping API टोकन जनरेट करता है.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
यह PGS उपयोगकर्ता के लिए Play Grouping API टोकन जनरेट करता है. इस उपयोगकर्ता की पहचान, अनुरोध में दिए गए रीकॉल सेशन आईडी से की जाती है.

REST रिसॉर्स: achievementDefinitions

तरीके
list GET /games/v1/achievements
आपके ऐप्लिकेशन के लिए, उपलब्धियों की सभी परिभाषाएं दिखाता है.

REST रिसॉर्स: achievements

तरीके
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 रिसॉर्स: applications

तरीके
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 रिसॉर्स: events

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

REST रिसॉर्स: leaderboards

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

REST रिसॉर्स: metagame

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

REST रिसॉर्स: playerGameEvents

तरीके
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
यह कुकी, किसी खिलाड़ी के लिए गेम से जुड़े इवेंट का बैच रिकॉर्ड करती है.

REST रिसॉर्स: players

तरीके
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

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

REST रिसॉर्स: revisions

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

REST रिसॉर्स: scores

तरीके
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 रिसॉर्स: snapshots

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

REST रिसॉर्स: stats

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