Method: achievements.updateMultiple

อัปเดตรางวัลพิเศษหลายรายการสำหรับโปรแกรมเล่นที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน

คำขอ HTTP

POST https://games.googleapis.com/games/v1/achievements/updateMultiple

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

เนื้อความของคำขอมีอินสแตนซ์ของ UpdateMultipleAchievements

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

ข้อความตอบกลับสำหรับtagmanager.update Multiple rpc

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

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

string

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

object (UpdatedAchievement)

สถานะที่อัปเดตแล้วของรางวัลพิเศษ

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

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

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

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

UpdateMultipleAchievements

รายการคำขออัปเดตรางวัลพิเศษ

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

string

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

object (UpdateAchievement)

คำขออัปเดตรางวัลพิเศษแต่ละรายการ

UpdateAchievement

คำขออัปเดตรางวัลพิเศษ

การแสดง JSON 
{
  "kind": string,
  "achievementId": string,
  "updateType": enum (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
ช่อง
kind

string

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

string

รางวัลพิเศษที่กำลังใช้อัปเดตนี้
updateType

enum (AchievementUpdateType)

ประเภทของการอัปเดตที่กำลังใช้
incrementPayload

object (AchievementIncrement)

เพย์โหลดหากมีการขอการอัปเดตประเภท INCREMENT สำหรับรางวัลพิเศษนี้
setStepsAtLeastPayload

object (SetAchievementSteps)

เพย์โหลดหากมีการขอการอัปเดตประเภท SET_STEPS_AT_LEAST สำหรับรางวัลพิเศษนี้

AchievementUpdateType

ประเภทการอัปเดตรางวัลพิเศษที่เป็นไปได้

Enum
REVEAL รางวัลพิเศษจะปรากฏขึ้น
UNLOCK รางวัลพิเศษถูกปลดล็อก
INCREMENT รางวัลพิเศษเพิ่มขึ้น
SET_STEPS_AT_LEAST ความคืบหน้าของรางวัลพิเศษได้รับการตั้งค่าเป็นค่าที่ส่งผ่านเป็นอย่างน้อย

AchievementIncrement

เพย์โหลดที่จะขอเพิ่มรางวัลพิเศษ

การแสดง JSON 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
ช่อง
kind

string

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

integer

จำนวนขั้นตอนที่จะเพิ่มขึ้น
requestId

string (int64 format)

requestId ที่เชื่อมโยงกับการเพิ่มของรางวัลพิเศษ

SetAchievementSteps

เพย์โหลดที่จะขอเพิ่มรางวัลพิเศษ

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

string

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

integer

จำนวนขั้นตอนขั้นต่ำของรางวัลพิเศษที่จะตั้งค่า

UpdatedAchievement

รางวัลพิเศษที่อัปเดตแล้ว

การแสดง JSON 
{
  "kind": string,
  "achievementId": string,
  "updateOccurred": boolean,
  "currentState": enum (UpdatedAchievementState),
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
ช่อง
kind

string

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

string

รางวัลพิเศษที่ใช้การอัปเดตนี้
updateOccurred

boolean

การอัปเดตที่ขอมีผลต่อรางวัลพิเศษหรือไม่
currentState

enum (UpdatedAchievementState)

สถานะปัจจุบันของรางวัลพิเศษ
currentSteps

integer

ขั้นตอนปัจจุบันที่บันทึกไว้สำหรับรางวัลพิเศษนี้หากเป็นรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ
newlyUnlocked

boolean

รางวัลพิเศษนี้เพิ่งปลดล็อกใหม่หรือไม่ (กล่าวคือ คำขอปลดล็อกสำหรับรางวัลพิเศษนี้เป็นคำขอแรกสำหรับผู้เล่นหรือไม่)

UpdatedAchievementState

สถานะรางวัลพิเศษที่อาจได้รับการอัปเดต

Enum
HIDDEN รางวัลพิเศษซ่อนอยู่
REVEALED รางวัลพิเศษจะปรากฏขึ้น
UNLOCKED รางวัลพิเศษถูกปลดล็อก