Google Play Game Services

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

सेवा: game.googleapis.com

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

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

डिस्कवरी दस्तावेज़ REST API के बारे में जानकारी देने और उसका इस्तेमाल करने के लिए, इस स्पेसिफ़िकेशन को मशीन से पढ़ सकता है. इसका इस्तेमाल क्लाइंट लाइब्रेरी, IDE प्लगिन, और 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 इस्तेमाल करने वाले व्यक्ति के लिए, अनुरोध में दिए गए Recall सेशन आईडी से Play Grouping API टोकन जनरेट करता है.

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 से जुड़े खिलाड़ी के लिए, हर कैटगरी के हिसाब से इकट्ठा किया गया डेटा की सूची बनाएं.

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 रिसॉर्स: वापस लाएं

तरीके
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 लीडरबोर्ड पर एक से ज़्यादा स्कोर सबमिट करता है.

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

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

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

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