Method: metagame.listCategoriesByPlayer

แสดงข้อมูลการเล่นที่รวบรวมตามหมวดหมู่สำหรับผู้เล่นที่เกี่ยวข้องกับ playerId

คำขอ HTTP

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

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

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

string

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

collection

enum (Collection)

คอลเล็กชันของหมวดหมู่ที่ระบบจะส่งคืนข้อมูล

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

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

string

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

maxResults

integer

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

pageToken

string

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

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

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

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

การตอบกลับหมวดหมู่เกมเมตาสำหรับรายการของบุคคลที่สาม

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

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

string

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

nextPageToken

string

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

items[]

object (MetagameCategory)

รายการหมวดหมู่ที่มีข้อมูลการใช้งาน

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

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

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

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

คอลเล็กชัน

กำหนดหมวดหมู่ที่ข้อมูลจะแสดงผล

Enum
ALL เรียกดูข้อมูลสำหรับหมวดหมู่ทั้งหมด โดยตัวเลือกนี้คือค่าเริ่มต้น

MetagameCategory

ข้อมูลที่เกี่ยวข้องกับหมวดหมู่เกมแต่ละหมวดหมู่

การแสดง JSON
{
  "kind": string,
  "category": string,
  "experiencePoints": string
}
ช่อง
kind

string

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

category

string

ชื่อหมวดหมู่

experiencePoints

string (int64 format)

คะแนนประสบการณ์ที่ได้รับจากหมวดหมู่นี้