इसके लिए, अनुमति लेना ज़रूरी है
दिए गए ऐप्लिकेशन से छिपे हुए खिलाड़ियों की सूची पाएं. यह विधि आपके डेवलपर कंसोल के उपयोगकर्ता खातों के लिए ही उपलब्ध है.
अनुरोध
एचटीटीपी अनुरोध
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
पैरामीटर
पैरामीटर का नाम | वैल्यू | ब्यौरा |
---|---|---|
पाथ पैरामीटर | ||
applicationId |
string |
Google Play Console से मिला ऐप्लिकेशन आईडी. |
वैकल्पिक क्वेरी पैरामीटर | ||
maxResults |
integer |
जवाब में वापस दिए जाने वाले प्लेयर संसाधनों की ज़्यादा से ज़्यादा संख्या, जिसका इस्तेमाल पेजिंग के लिए किया जाता है. किसी भी जवाब के लिए, खिलाड़ी के लिए दिखाए गए संसाधनों की असल संख्या बताई गई maxResults से कम हो सकती है.
स्वीकार्य मान 1 से 15 तक हो सकते हैं, जिसमें ये भी शामिल हैं.
|
pageToken |
string |
पिछले अनुरोध पर टोकन मिला. |
अनुमति देना
इस अनुरोध के लिए नीचे दिए गए दायरे के साथ अनुमति की ज़रूरत है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).
स्कोप |
---|
https://www.googleapis.com/auth/games |
अनुरोध का मुख्य भाग
इस तरीके का इस्तेमाल करके, अनुरोध का मुख्य हिस्सा न दें.
जवाब
कामयाब होने पर, यह तरीका इस स्ट्रक्चर के साथ रिस्पॉन्स का मुख्य हिस्सा दिखाता है:
{ "kind": "gamesManagement#hiddenPlayerList", "nextPageToken": string, "items": [ { "kind": "gamesManagement#hiddenPlayer", "player": { "kind": "gamesManagement#player", "playerId": string, "displayName": string, "avatarImageUrl": string, "lastPlayedWith": { "timeMillis": long, "autoMatched": boolean }, "name": { "familyName": string, "givenName": string }, "experienceInfo": { "currentExperiencePoints": long, "lastLevelUpTimestampMillis": long, "currentLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long }, "nextLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long } }, "title": string }, "hiddenTimeMillis": long } ] }
प्रॉपर्टी का नाम | वैल्यू | ब्यौरा | ज़रूरी जानकारी |
---|---|---|---|
kind |
string |
यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग gamesManagement#hiddenPlayerList होती है. |
|
nextPageToken |
string |
नतीजों के अगले पेज के लिए पेज नंबर का टोकन. | |
items[] |
list |
खिलाड़ी. | |
items[].kind |
string |
यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग gamesManagement#hiddenPlayer होती है. |
|
items[].player |
nested object |
खिलाड़ी की जानकारी. | |
items[].player.kind |
string |
यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग gamesManagement#player होती है. |
|
items[].player.playerId |
string |
प्लेयर का आईडी. | |
items[].player.displayName |
string |
प्लेयर को दिखाने के लिए नाम. | |
items[].player.avatarImageUrl |
string |
उस इमेज का बेस यूआरएल जो प्लेयर को दिखाती है. | |
items[].player.lastPlayedWith |
nested object |
इस खिलाड़ी ने आखिरी बार ऐसे खिलाड़ी के साथ मल्टीप्लेयर गेम कब खेला था जिसकी पुष्टि हो चुकी है. PLAYED_WITH प्लेयर कलेक्शन के सदस्यों के लिए भरा गया. | |
items[].player.lastPlayedWith.timeMillis |
long |
यूटीसी में Epoch के बाद से, खिलाड़ी का आखिरी बार मिलीसेकंड में गेम खेला गया. | |
items[].player.lastPlayedWith.autoMatched |
boolean |
अगर प्लेयर का मौजूदा पुष्टि किए गए उपयोगकर्ता के साथ अपने-आप मिलान हुआ था, तो वैल्यू 'सही' होगी. | |
items[].player.name |
object |
एक ऑब्जेक्ट, जिसमें खिलाड़ी के नाम के अलग-अलग कॉम्पोनेंट दिखाए गए हैं. कुछ खिलाड़ियों के लिए, हो सकता है कि ये फ़ील्ड मौजूद न हों. | |
items[].player.name.familyName |
string |
इस खिलाड़ी का सरनेम. कुछ जगहों पर, इसे सरनेम के तौर पर भी जाना जाता है. | |
items[].player.name.givenName |
string |
इस खिलाड़ी का दिया गया नाम. कुछ जगहों पर, इसे नाम के तौर पर भी जाना जाता है. | |
items[].player.experienceInfo |
nested object |
खिलाड़ी के Play गेम के अनुभव की जानकारी दिखाने के लिए ऑब्जेक्ट. | |
items[].player.experienceInfo.currentExperiencePoints |
long |
खिलाड़ी के लिए अनुभव पॉइंट की मौजूदा संख्या. | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
प्लेयर को अगले लेवल पर ले जाने का टाइमस्टैंप, जो Unix epoch UTC के बाद, मिलीसेकंड में है. | |
items[].player.experienceInfo.currentLevel |
nested object |
प्लेयर का मौजूदा लेवल. | |
items[].player.experienceInfo.currentLevel.level |
integer |
उपयोगकर्ता के लिए लेवल. | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
इस लेवल के लिए ज़रूरी अनुभव. | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
इस लेवल के लिए सबसे ज़्यादा एक्सपीरियंस पॉइंट. | |
items[].player.experienceInfo.nextLevel |
nested object |
खिलाड़ी का अगला लेवल. अगर मौजूदा लेवल सबसे ज़्यादा है, तो यह मौजूदा लेवल के बराबर होना चाहिए. | |
items[].player.experienceInfo.nextLevel.level |
integer |
उपयोगकर्ता के लिए लेवल. | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
इस लेवल के लिए ज़रूरी अनुभव. | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
इस लेवल के लिए सबसे ज़्यादा एक्सपीरियंस पॉइंट. | |
items[].player.title |
string |
गेम गतिविधियों के लिए, खिलाड़ी को मिला इनाम. |