Method: players.list

รับคอลเล็กชันของโปรแกรมเล่นสำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน

คำขอ HTTP

GET https://games.googleapis.com/games/v1/players/me/players/{collection}

พารามิเตอร์เส้นทาง

พารามิเตอร์
collection

enum (Collection)

กำลังดึงข้อมูลคอลเล็กชันของผู้เล่น

พารามิเตอร์การค้นหา

พารามิเตอร์
language

string

ภาษาที่ต้องการใช้สำหรับสตริงที่แสดงผลโดยวิธีการนี้
maxResults

integer

จำนวนสูงสุดของทรัพยากรโปรแกรมเล่นที่จะส่งคืนในการตอบสนอง ซึ่งใช้สำหรับการแบ่งหน้า สำหรับการตอบสนอง จำนวนจริงของทรัพยากรโปรแกรมเล่นที่แสดงผลอาจน้อยกว่า maxResults ที่ระบุ
pageToken

string

โทเค็นที่ส่งกลับโดยคำขอก่อนหน้า

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบกลับด้วยรายการโปรแกรมเล่นของบุคคลที่สาม

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (Player)
    }
  ]
}
ช่อง
kind

string

ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าเป็นสตริงคงที่ games#playerListResponse เสมอ
nextPageToken

string

โทเค็นที่ตรงกับผลการค้นหาหน้าถัดไป
items[]

object (Player)

ผู้เล่น

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

คอลเล็กชัน

Enum
CONNECTED

ดึงรายชื่อผู้เล่นที่เล่นเกมนี้อยู่เช่นกันตามลำดับเวลา
VISIBLE

ดึงรายชื่อผู้เล่นในกราฟโซเชียลของผู้ใช้ที่มองเห็นเกมนี้ได้
FRIENDS_ALL ดึงรายชื่อผู้เล่นที่เป็นเพื่อนของผู้ใช้ตามลำดับตัวอักษร