REST Resource: players

संसाधन: खिलाड़ी

प्लेयर से जुड़ा संसाधन.

जेएसओएन के काेड में दिखाना 
{
  "kind": string,
  "playerId": string,
  "displayName": string,
  "avatarImageUrl": string,
  "bannerUrlPortrait": string,
  "bannerUrlLandscape": string,
  "originalPlayerId": string,
  "profileSettings": {
    object (ProfileSettings)
  },
  "name": {
    "familyName": string,
    "givenName": string
  },
  "experienceInfo": {
    object (PlayerExperienceInfo)
  },
  "title": string,
  "friendStatus": enum (FriendStatus),
  "gamePlayerId": string
}
फ़ील्ड
kind

string

यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. मान हमेशा तय स्ट्रिंग games#player होता है
playerId

string

प्लेयर का आईडी.
displayName

string

प्लेयर को दिखाने के लिए नाम.
avatarImageUrl

string

उस इमेज का बेस यूआरएल जो प्लेयर को दिखाती है.
bannerUrlPortrait

string

पोर्ट्रेट मोड के प्लेयर बैनर इमेज का यूआरएल.
bannerUrlLandscape

string

लैंडस्केप मोड वाले प्लेयर की बैनर इमेज का यूआरएल.
originalPlayerId

string

वह प्लेयर आईडी जिसका इस्तेमाल इस खिलाड़ी के लिए तब किया गया था, जब उसने पहली बार विवादित गेम में साइन इन किया था. यह सिर्फ़ अनुरोध करने वाले प्लेयर के लिए Player.get को कॉल करने के लिए भरा जाता है. ऐसा सिर्फ़ तब होता है, जब प्लेयर आईडी को बाद में बदला गया हो. यह सिर्फ़ उन क्लाइंट के लिए भरा जाता है जिनमें प्लेयर आईडी को रीमैप करने की सुविधा काम करती है.
profileSettings

object (ProfileSettings)

खिलाड़ी की प्रोफ़ाइल सेटिंग. यह नीति कंट्रोल करती है कि खिलाड़ी की प्रोफ़ाइल अन्य खिलाड़ियों को दिखे या नहीं.
name

object

एक ऑब्जेक्ट, जिसमें खिलाड़ी के नाम के अलग-अलग कॉम्पोनेंट दिखाए गए हैं. कुछ खिलाड़ियों के लिए, हो सकता है कि ये फ़ील्ड मौजूद न हों.
name.familyName

string

इस खिलाड़ी का सरनेम. कुछ जगहों पर, इसे सरनेम के तौर पर भी जाना जाता है.
name.givenName

string

इस खिलाड़ी का दिया गया नाम. कुछ जगहों पर, इसे नाम के तौर पर भी जाना जाता है.
experienceInfo

object (PlayerExperienceInfo)

खिलाड़ी के Play गेम के अनुभव की जानकारी दिखाने के लिए ऑब्जेक्ट.
title

string

गेम गतिविधियों के लिए, खिलाड़ी को मिला इनाम.
friendStatus

enum (FriendStatus)

अनुरोध करने वाले खिलाड़ी के संबंध में, खिलाड़ी के दोस्त की स्थिति. अगर खिलाड़ी अपने दोस्तों की सूची गेम में शेयर नहीं कर रहा है, तो यह नीति सेट नहीं होती है.
gamePlayerId

string

हर ऐप्लिकेशन के लिए यूनीक प्लेयर आइडेंटिफ़ायर.

ProfileSettings

प्रोफ़ाइल की सेटिंग

जेएसओएन के काेड में दिखाना 
{
  "kind": string,
  "profileVisible": boolean,
  "friendsListVisibility": enum (FriendsListVisibility)
}
फ़ील्ड
kind

string

यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग games#profileSettings होती है.
profileVisible

boolean

खिलाड़ी की प्रोफ़ाइल, साइन इन किए हुए मौजूदा प्लेयर को दिखती है या नहीं.
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

क्या खिलाड़ी के दोस्तों की सूची इस गेम में दिखेगी या उनका अनुरोध किया जा सकता है. यह फ़ील्ड सिर्फ़ साइन इन किए हुए प्लेयर के लिए भरा जाता है.

Enums
VISIBLE फ़िलहाल, दोस्तों की सूची गेम में दिख रही है.
REQUEST_REQUIRED डेवलपर के पास दोस्तों की सूची का ऐक्सेस नहीं होता. हालांकि, वह सहमति जताने वाला डायलॉग दिखाने के लिए, Android API को कॉल कर सकता है.
UNAVAILABLE वर्तमान में इस उपयोगकर्ता के लिए दोस्त सूची उपलब्ध नहीं है और इस समय पहुंच का अनुरोध करना संभव नहीं है, क्योंकि या तो उपयोगकर्ता ने स्थायी रूप से अस्वीकार कर दिया है या उसके लिए दोस्त सुविधा उपलब्ध नहीं है. इस स्थिति में, दोस्तों की सूची को ऐक्सेस करने का अनुरोध नहीं किया जा सकेगा.

PlayerExperienceInfo

खिलाड़ी के अनुभव के बारे में 1P/3P मेटाडेटा.

जेएसओएन के काेड में दिखाना 
{
  "kind": string,
  "currentExperiencePoints": string,
  "lastLevelUpTimestampMillis": string,
  "currentLevel": {
    object (PlayerLevel)
  },
  "nextLevel": {
    object (PlayerLevel)
  }
}
फ़ील्ड
kind

string

यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग games#playerExperienceInfo होती है.
currentExperiencePoints

string (int64 format)

खिलाड़ी के लिए अनुभव पॉइंट की मौजूदा संख्या.
lastLevelUpTimestampMillis

string (int64 format)

प्लेयर को अगले लेवल पर ले जाने का टाइमस्टैंप, जो Unix epoch UTC के बाद, मिलीसेकंड में है.
currentLevel

object (PlayerLevel)

प्लेयर का मौजूदा लेवल.
nextLevel

object (PlayerLevel)

खिलाड़ी का अगला लेवल. अगर मौजूदा लेवल सबसे ज़्यादा है, तो यह मौजूदा लेवल के बराबर होना चाहिए.

PlayerLevel

उपयोगकर्ता के लेवल के बारे में 1P/3P मेटाडेटा.

जेएसओएन के काेड में दिखाना 
{
  "kind": string,
  "level": integer,
  "minExperiencePoints": string,
  "maxExperiencePoints": string
}
फ़ील्ड
kind

string

यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग games#playerLevel होती है.
level

integer

उपयोगकर्ता के लिए लेवल.
minExperiencePoints

string (int64 format)

इस लेवल के लिए ज़रूरी अनुभव.
maxExperiencePoints

string (int64 format)

इस लेवल के लिए सबसे ज़्यादा एक्सपीरियंस पॉइंट.

FriendStatus

यह गेम, खिलाड़ियों के बीच दोस्ती के संबंधों के बारे में बताता है.

Enums
NO_RELATIONSHIP खिलाड़ियों के बीच कोई संबंध नहीं है.
FRIEND खिलाड़ी और अनुरोध करने वाला व्यक्ति दोस्त हैं.

तरीके

get

 दिए गए आईडी से प्लेयर संसाधन लाता है.

getMultipleApplicationPlayerIds

 जिस डेवलपर की तरफ़ से कॉल करने वाले ऐप्लिकेशन का अनुरोध किया गया है उन सभी गेम के लिए, मौजूदा पुष्टि किए गए प्लेयर के लिए ऐप्लिकेशन प्लेयर आईडी पाएं.

getScopedPlayerIds

 फ़िलहाल, पुष्टि किए गए उपयोगकर्ता के लिए स्कोप वाले प्लेयर आइडेंटिफ़ायर को फिर से हासिल करता है.

list

 वर्तमान में प्रमाणित उपयोगकर्ता के लिए प्लेयर का संग्रह पाएं.