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

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