Method: achievements.updateMultiple

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

คำขอ HTTP

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

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

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

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

ข้อความตอบกลับสำหรับรางวัลพิเศษ.updateMultiple 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 รางวัลพิเศษถูกปลดล็อกแล้ว