REST Resource: players

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

खिलाड़ी से जुड़ा संसाधन.

JSON के काेड में दिखाना 
{
  "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

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

object (ProfileSettings)

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

object

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

string

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

string

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

object (PlayerExperienceInfo)

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

string

गेम ऐक्टिविटी के लिए खिलाड़ी को मिला इनाम.
friendStatus

enum (FriendStatus)

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

string

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

ProfileSettings

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

JSON के काेड में दिखाना 
{
  "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 का मेटाडेटा.

JSON के काेड में दिखाना 
{
  "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 यूटीसी के बाद, मिलीसेकंड में प्लेयर का लेवल ऊपर किए जाने का टाइमस्टैंप.
currentLevel

object (PlayerLevel)

खिलाड़ी का मौजूदा लेवल.
nextLevel

object (PlayerLevel)

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

PlayerLevel

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

JSON के काेड में दिखाना 
{
  "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

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