Google Play की गेम सेवाओं की मदद से, डेवलपर सोशल लीडरबोर्ड, उपलब्धियों, गेम की स्थिति, Google से साइन-इन वगैरह की मदद से गेम को बेहतर बना सकते हैं.
सेवा: game.googleapis.com
इस सेवा को कॉल करने के लिए, हमारा सुझाव है कि आप Google की क्लाइंट लाइब्रेरी का इस्तेमाल करें. अगर इस सेवा को कॉल करने के लिए आपके ऐप्लिकेशन को आपकी अपनी लाइब्रेरी का इस्तेमाल करना है, तो एपीआई अनुरोध करते समय नीचे दी गई जानकारी का इस्तेमाल करें.
खोज से जुड़ा दस्तावेज़
डिस्कवरी दस्तावेज़ REST API के बारे में जानकारी देने और उसका इस्तेमाल करने के लिए, इस स्पेसिफ़िकेशन को मशीन से पढ़ सकता है. इसका इस्तेमाल क्लाइंट लाइब्रेरी, IDE प्लगिन, और Google API के साथ इंटरैक्ट करने वाले अन्य टूल बनाने में किया जाता है. एक सेवा, खोज के लिए कई दस्तावेज़ उपलब्ध करा सकती है. खोज से जुड़ा यह दस्तावेज़, इस सेवा पर उपलब्ध है:
सेवा एंडपॉइंट
सेवा एंडपॉइंट एक बेस यूआरएल होता है, जो एपीआई सेवा के नेटवर्क पते के बारे में बताता है. एक सेवा में एक से ज़्यादा सेवा एंडपॉइंट हो सकते हैं. इस सेवा में यह सर्विस एंडपॉइंट है और नीचे दिए गए सभी यूआरआई इस सर्विस एंडपॉइंट से मिलते-जुलते हैं:
https://games.googleapis.com
तरीके |
generatePlayGroupingApiToken |
POST /games/v1/accesstokens/generatePlayGroupingApiToken
अटैच किए गए क्रेडेंशियल की मदद से पहचाने गए PGS उपयोगकर्ता के लिए Play Grouping API टोकन जनरेट करता है. |
generateRecallPlayGroupingApiToken |
POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
PGS इस्तेमाल करने वाले व्यक्ति के लिए, अनुरोध में दिए गए Recall सेशन आईडी से Play Grouping API टोकन जनरेट करता है. |
तरीके |
list |
GET /games/v1/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
पुष्टि किए गए मौजूदा प्लेयर की कई उपलब्धियों को अपडेट करता है. |
तरीके |
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
इस ऐप्लिकेशन के पुष्टि किए गए मौजूदा उपयोगकर्ता के लिए, इवेंट की संख्या में हुए बदलावों का बैच रिकॉर्ड करता है. |
तरीके |
get |
GET /games/v1/leaderboards/{leaderboardId}
दिए गए आईडी के साथ लीडरबोर्ड का मेटाडेटा लाता है. |
list |
GET /games/v1/leaderboards
यह आपके ऐप्लिकेशन के सभी लीडरबोर्ड मेटाडेटा की सूची बनाता है. |
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}
वर्तमान में प्रमाणित उपयोगकर्ता के लिए खिलाड़ियों का संग्रह पाएं. |
तरीके |
gamesPlayerTokens |
GET /games/v1/recall/gamesPlayerTokens/{sessionId}
अनुरोध किए गए उन सभी गेम से Recall टोकन वापस पाएं जो दिए गए रीकॉल सेशन आईडी में, कोड में बदले गए PGS प्लेयर से जुड़े हैं. |
lastTokenFromAllDeveloperGames |
GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
दिए गए रीकॉल सेशन आईडी में कोड में बदले गए PGS प्लेयर से जुड़े सभी डेवलपर गेम से आखिरी रीकॉल टोकन पाएं. |
linkPersona |
POST /games/v1/recall:linkPersona
दिए गए रीकॉल सेशन आईडी में, कोड में बदले गए PGS प्लेयर के मुख्य खाते को गेम में मौजूद खाते से जोड़ें |
resetPersona |
POST /games/v1/recall:resetPersona
दिए गए पर्सोना को किसी भी खिलाड़ी से लिंक करने वाले सभी Recall टोकन मिटाएं. ये टोकन, प्रोफ़ाइल के साथ या उसके बिना भी मौजूद होते हैं. |
retrieveTokens |
GET /games/v1/recall/tokens/{sessionId}
दिए गए रीकॉल सेशन आईडी में कोड में बदले गए PGS प्लेयर से जुड़े सभी रीकॉल टोकन वापस पाएं. |
unlinkPersona |
POST /games/v1/recall:unlinkPersona
उस Recall टोकन को मिटाएं जिसकी पहचान PGS प्लेयर के मुख्य खाते से की गई है. इस टोकन की पहचान Recall सेशन से की गई है और गेम में बनाए गए उस खाते को लिंक किया गया है जिसकी पहचान 'पर्सोना' से हुई है या टोकन वैल्यू के हिसाब से. |
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
लीडरबोर्ड पर एक से ज़्यादा स्कोर सबमिट करता है. |
तरीके |
get |
GET /games/v1/snapshots/{snapshotId}
दिए गए स्नैपशॉट आईडी के लिए मेटाडेटा हासिल करता है. |
list |
GET /games/v1/players/{playerId}/snapshots
आपके ऐप्लिकेशन के प्लेयर आईडी से संबंधित प्लेयर के लिए बनाए गए स्नैपशॉट की सूची लाता है. |
REST रिसॉर्स: आंकड़े
तरीके |
get |
GET /games/v1/stats
इस ऐप्लिकेशन में, पुष्टि किए गए मौजूदा उपयोगकर्ता के लिए यूज़र ऐक्टिविटी और खर्च से जुड़े आंकड़े दिखाता है. |