Applications: listHidden

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

ดึงรายชื่อโปรแกรมเล่นที่ซ่อนจากแอปพลิเคชันที่ระบุ วิธีการนี้ใช้ได้เฉพาะกับบัญชีผู้ใช้สำหรับแผงควบคุมสำหรับนักพัฒนาซอฟต์แวร์ของคุณเท่านั้น

ส่งคำขอ

คำขอ 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
    }
  ]
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย หมายเหตุ
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 เกมของผู้เล่น
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 เวลาที่ซ่อนโปรแกรมเล่นนี้