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

تمثّل هذه السمة عنوان URL الأساسي للصورة التي تمثّل المشغّل.
bannerUrlPortrait

string

عنوان URL لصورة بانر المشغّل في الوضع العمودي
bannerUrlLandscape

string

عنوان URL إلى صورة بانر مشغّل الوضع الأفقي
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

إعدادات الملف الشخصي

تمثيل JSON 
{
  "kind": string,
  "profileVisible": boolean,
  "friendsListVisibility": enum (FriendsListVisibility)
}
الحقول
kind

string

تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة games#profileSettings.
profileVisible

boolean

ما إذا كان الملف الشخصي للّاعب مرئيًا للمشغّل الذي سجّلت الدخول إليه حاليًا.
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

ما إذا كانت قائمة أصدقاء اللاعب مرئية لهذه اللعبة أو يمكن طلبها لا تتم تعبئة هذا الحقل إلا للمشغّل الذي سجّلت الدخول إليه حاليًا.

عمليات التعداد
VISIBLE قائمة الأصدقاء مرئية للعبة حاليًا.
REQUEST_REQUIRED لا يمكن لمطوِّر البرامج الوصول إلى قائمة الأصدقاء، ولكن يمكنه طلب واجهة برمجة تطبيقات Android لعرض مربّع إفادة الموافقة.
UNAVAILABLE قائمة الأصدقاء غير متاحة حاليًا لهذا المستخدم، ولا يمكن طلب الوصول في الوقت الحالي، إما لأن المستخدم رفض الدعوة نهائيًا أو لأن ميزة الأصدقاء غير متوفرة له. في هذه الحالة، لن تنجح أي محاولات لطلب الوصول إلى قائمة الأصدقاء.

PlayerExperienceInfo

البيانات الوصفية للطرف الأول/الطرف الثالث حول تجربة المشغّل

تمثيل 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 للّعبة بالتوقيت العالمي المنسّق
currentLevel

object (PlayerLevel)

المستوى الحالي للّاعب.
nextLevel

object (PlayerLevel)

المستوى التالي من اللاعب. إذا كان المستوى الحالي هو الحد الأقصى، يجب أن يكون هذا المستوى مماثلاً للمستوى الحالي.

PlayerLevel

بيانات وصفية للطرف الأول أو للطرف الثالث حول مستوى المستخدم

تمثيل JSON 
{
  "kind": string,
  "level": integer,
  "minExperiencePoints": string,
  "maxExperiencePoints": string
}
الحقول
kind

string

تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة games#playerLevel.
level

integer

مستوى المستخدم.
minExperiencePoints

string (int64 format)

تمثّل هذه السمة الحدّ الأدنى لنقاط الخبرة لهذا المستوى.
maxExperiencePoints

string (int64 format)

تمثّل هذه السمة الحد الأقصى لنقاط الخبرة لهذا المستوى.

FriendStatus

تحدد علاقات الصداقة بين اللاعبين.

عمليات التعداد
NO_RELATIONSHIP لا توجد علاقة بين اللاعبين.
FRIEND اللاعب ومقدِّم الطلب صديقان.

الطُرق

get

 استرداد مورد "المشغّل" باستخدام رقم التعريف المحدّد.

getMultipleApplicationPlayerIds

 يمكنك الحصول على أرقام تعريف مشغّل التطبيق للّاعب الذي تمت مصادقته حاليًا في جميع الألعاب المطلوبة من قِبل المطوّر نفسه الذي يستخدمه تطبيق الاتصال.

getScopedPlayerIds

 يسترد مُعرّفات المشغّل ضمن النطاق للمستخدم الذي تمت مصادقته حاليًا.

list

 احصل على مجموعة اللاعبين للمستخدم الذي تمت مصادقته حاليًا.