Applications: listHidden

ต้องมีการให้สิทธิ์

ดูรายการผู้เล่นที่ซ่อนไว้จากแอปพลิเคชันที่ระบุ วิธีนี้ใช้ได้เฉพาะกับบัญชีผู้ใช้ของ Developer Console เท่านั้น

ส่งคำขอ

คำขอ HTTP

GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden

พารามิเตอร์

ชื่อพารามิเตอร์	ค่า	คำอธิบาย
พารามิเตอร์เส้นทาง
applicationId	string	รหัสแอปพลิเคชันจาก Google Play Console
พารามิเตอร์การค้นหาที่ไม่บังคับ
maxResults	integer	จำนวนสูงสุดของทรัพยากรโปรแกรมเล่นที่จะแสดงผลในการตอบสนอง ใช้สำหรับการแบ่งหน้า สำหรับการตอบกลับใดๆ จำนวนทรัพยากรของผู้เล่นจริงที่ส่งคืนอาจน้อยกว่า maxResults ที่ระบุไว้ ค่าที่ยอมรับได้คือ 1 ถึง 15 เท่านั้น
pageToken	string	โทเค็นที่แสดงผลโดยคำขอก่อนหน้า

การให้สิทธิ์

คำขอนี้ต้องได้รับสิทธิ์ด้วยขอบเขตต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)

ขอบเขต
https://www.googleapis.com/auth/games

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

โปรดอย่าแสดงเนื้อหาของคำขอด้วยวิธีนี้

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบสนองที่มีโครงสร้างต่อไปนี้

{
  "kind": "gamesManagement#hiddenPlayerList",
  "nextPageToken": string,
  "items": [
    {
      "kind": "gamesManagement#hiddenPlayer",
      "player": {
        "kind": "gamesManagement#player",
        "playerId": string,
        "displayName": string,
        "avatarImageUrl": string,
        "lastPlayedWith": {
          "timeMillis": long,
          "autoMatched": boolean
        },
        "name": {
          "familyName": string,
          "givenName": string
        },
        "experienceInfo": {
          "currentExperiencePoints": long,
          "lastLevelUpTimestampMillis": long,
          "currentLevel": {
            "level": integer,
            "minExperiencePoints": long,
            "maxExperiencePoints": long
          },
          "nextLevel": {
            "level": integer,
            "minExperiencePoints": long,
            "maxExperiencePoints": long
          }
        },
        "title": string
      },
      "hiddenTimeMillis": long
    }
  ]
}

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย	Notes
kind	string	ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ gamesManagement#hiddenPlayerList เสมอ
nextPageToken	string	โทเค็นการแบ่งหน้าสำหรับหน้าผลการค้นหาถัดไป
items[]	list	ผู้เล่น
items[].kind	string	ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ gamesManagement#hiddenPlayer เสมอ
items[].player	nested object	ข้อมูลผู้เล่น
items[].player.kind	string	ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ gamesManagement#player เสมอ
items[].player.playerId	string	รหัสของโปรแกรมเล่น
items[].player.displayName	string	ชื่อที่จะแสดงสำหรับโปรแกรมเล่น
items[].player.avatarImageUrl	string	URL ฐานสำหรับรูปภาพที่แสดงถึงโปรแกรมเล่น
items[].player.lastPlayedWith	nested object	รายละเอียดเกี่ยวกับเวลาล่าสุดที่ผู้เล่นรายนี้เล่นเกมแบบผู้เล่นหลายคนด้วยโปรแกรมเล่นที่ตรวจสอบสิทธิ์อยู่ในขณะนี้ ป้อนข้อมูลสำหรับสมาชิกคอลเล็กชันผู้เล่นของ PLAYED_WITH แล้ว
items[].player.lastPlayedWith.timeMillis	long	เวลาล่าสุดที่ผู้เล่นเล่นเกมเป็นมิลลิวินาทีตั้งแต่ Epoch ใน UTC
items[].player.lastPlayedWith.autoMatched	boolean	เป็นจริงหากจับคู่โปรแกรมเล่นโดยอัตโนมัติกับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน
items[].player.name	object	ตัวแทนออบเจ็กต์ของคอมโพเนนต์แต่ละรายการของชื่อผู้เล่น สำหรับผู้เล่นบางคน ช่องเหล่านี้อาจไม่มีอยู่
items[].player.name.familyName	string	นามสกุลของผู้เล่นรายนี้ ในบางแห่ง อาจเรียกว่านามสกุล
items[].player.name.givenName	string	ชื่อจริงของผู้เล่นนี้ ในบางแห่ง อาจเรียกว่าชื่อจริง
items[].player.experienceInfo	nested object	ออบเจ็กต์ที่แสดงข้อมูลประสบการณ์ Play Games ของผู้เล่น
items[].player.experienceInfo.currentExperiencePoints	long	จำนวนคะแนนประสบการณ์ปัจจุบันของผู้เล่น
items[].player.experienceInfo.lastLevelUpTimestampMillis	long	การประทับเวลาเมื่อผู้เล่นเลื่อนระดับเป็นมิลลิวินาทีตั้งแต่ Unix Epoch UTC
items[].player.experienceInfo.currentLevel	nested object	ระดับปัจจุบันของโปรแกรมเล่น
items[].player.experienceInfo.currentLevel.level	integer	ระดับสำหรับผู้ใช้
items[].player.experienceInfo.currentLevel.minExperiencePoints	long	คะแนนประสบการณ์ขั้นต่ำสำหรับระดับนี้
items[].player.experienceInfo.currentLevel.maxExperiencePoints	long	คะแนนประสบการณ์สูงสุดสำหรับระดับนี้
items[].player.experienceInfo.nextLevel	nested object	ระดับถัดไปของผู้เล่น หากระดับปัจจุบันเป็นระดับสูงสุด ควรเท่ากับระดับปัจจุบัน
items[].player.experienceInfo.nextLevel.level	integer	ระดับสำหรับผู้ใช้
items[].player.experienceInfo.nextLevel.minExperiencePoints	long	คะแนนประสบการณ์ขั้นต่ำสำหรับระดับนี้
items[].player.experienceInfo.nextLevel.maxExperiencePoints	long	คะแนนประสบการณ์สูงสุดสำหรับระดับนี้
items[].player.title	string	ชื่อของผู้เล่นได้รับรางวัลจากกิจกรรมเกม
items[].hiddenTimeMillis	long	เวลาที่ซ่อนโปรแกรมเล่นนี้