- คำขอ HTTP
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- UpdateMultipleAchievements
- UpdateAchievement
- AchievementUpdateType
- AchievementIncrement
- SetAchievementSteps
- UpdatedAchievement
- UpdatedAchievementState
- ลองใช้งาน
อัปเดตรางวัลพิเศษหลายรายการสำหรับโปรแกรมเล่นที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน
คำขอ HTTP
POST https://games.googleapis.com/games/v1/achievements/updateMultiple
เนื้อหาของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ UpdateMultipleAchievements
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับรางวัลพิเศษ.updateMultiple rpc
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"kind": string,
"updatedAchievements": [
{
object ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ |
updatedAchievements[] |
สถานะที่อัปเดตของรางวัลพิเศษ |
ขอบเขตการให้สิทธิ์
ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0
UpdateMultipleAchievements
รายการคำขออัปเดตรางวัลพิเศษ
การแสดง JSON |
---|
{
"kind": string,
"updates": [
{
object ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ |
updates[] |
คำขออัปเดตรางวัลพิเศษแต่ละรายการ |
UpdateAchievement
คำขออัปเดตรางวัลพิเศษ
การแสดง JSON |
---|
{ "kind": string, "achievementId": string, "updateType": enum ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ |
achievementId |
รางวัลพิเศษที่นำการอัปเดตนี้ไปใช้ |
updateType |
ประเภทของการอัปเดตที่นำไปใช้ |
incrementPayload |
เพย์โหลดเมื่อมีการขออัปเดตประเภท |
setStepsAtLeastPayload |
เพย์โหลดเมื่อมีการขออัปเดตประเภท |
AchievementUpdateType
ประเภทการอัปเดตรางวัลพิเศษที่เป็นไปได้
Enum | |
---|---|
REVEAL |
แสดงความสำเร็จ |
UNLOCK |
รางวัลพิเศษถูกปลดล็อกแล้ว |
INCREMENT |
ผลสัมฤทธิ์จะเพิ่มขึ้น |
SET_STEPS_AT_LEAST |
ความคืบหน้าของรางวัลพิเศษตั้งค่าไว้อย่างน้อยสำหรับค่าที่ส่งผ่าน |
AchievementIncrement
เพย์โหลดที่จะขอเพิ่มรางวัลพิเศษ
การแสดง JSON |
---|
{ "kind": string, "steps": integer, "requestId": string } |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ |
steps |
จำนวนก้าวที่เพิ่มขึ้น |
requestId |
requestId ที่เชื่อมโยงกับส่วนเพิ่มของรางวัลพิเศษ |
SetAchievementSteps
เพย์โหลดที่จะขอเพิ่มรางวัลพิเศษ
การแสดง JSON |
---|
{ "kind": string, "steps": integer } |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ |
steps |
จำนวนขั้นตอนขั้นต่ำที่จะตั้งค่ารางวัลพิเศษเป็น |
UpdatedAchievement
รางวัลพิเศษที่อัปเดต
การแสดง JSON |
---|
{
"kind": string,
"achievementId": string,
"updateOccurred": boolean,
"currentState": enum ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ |
achievementId |
รางวัลพิเศษที่ใช้กับการอัปเดตนี้ |
updateOccurred |
การอัปเดตที่ขอส่งผลกระทบต่อรางวัลพิเศษจริงหรือไม่ |
currentState |
สถานะปัจจุบันของรางวัลพิเศษ |
currentSteps |
ขั้นตอนปัจจุบันที่บันทึกไว้สำหรับรางวัลพิเศษนี้ หากเป็นส่วนเพิ่ม |
newlyUnlocked |
รางวัลพิเศษนี้เพิ่งปลดล็อกมาใหม่หรือไม่ (กล่าวคือ มีคำขอปลดล็อกสำหรับรางวัลพิเศษนี้เป็นรายการแรกสำหรับผู้เล่นหรือไม่) |
UpdatedAchievementState
สถานะรางวัลพิเศษที่อัปเดตที่เป็นไปได้
Enum | |
---|---|
HIDDEN |
รางวัลพิเศษซ่อนอยู่ |
REVEALED |
แสดงความสำเร็จ |
UNLOCKED |
รางวัลพิเศษถูกปลดล็อกแล้ว |