Method: events.record

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

คำขอ HTTP

POST https://games.googleapis.com/games/v1/events

พารามิเตอร์การค้นหา

พารามิเตอร์
language

string

ภาษาที่ต้องการใช้สำหรับสตริงที่แสดงผลโดยวิธีการนี้

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

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

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

แหล่งข้อมูลการอัปเดตระยะเวลาของกิจกรรม

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

การแสดง JSON 
{
  "kind": string,
  "batchFailures": [
    {
      object (EventBatchRecordFailure)
    }
  ],
  "eventFailures": [
    {
      object (EventRecordFailure)
    }
  ],
  "playerEvents": [
    {
      object (PlayerEvent)
    }
  ]
}
ช่อง
kind

string

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

object (EventBatchRecordFailure)

ความล้มเหลวของทั้งกลุ่มที่เกิดขึ้นขณะใช้การอัปเดต
eventFailures[]

object (EventRecordFailure)

การอัปเดตเหตุการณ์หนึ่งๆ ล้มเหลว
playerEvents[]

object (PlayerEvent)

สถานะปัจจุบันของกิจกรรมที่อัปเดตแล้ว

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

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

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

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

EventsUpdates

แหล่งข้อมูลการอัปเดตระยะเวลาของกิจกรรม

การแสดง JSON 
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
ช่อง
kind

string

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

string (int64 format)

รหัสคำขอที่ใช้ระบุความพยายามที่จะบันทึกเหตุการณ์นี้
currentTimeMillis

string (int64 format)

เวลาปัจจุบันที่ส่งการอัปเดตนี้ในหน่วยมิลลิวินาที ตั้งแต่ 1970 UTC (Unix Epoch)
timePeriods[]

object (EventPeriodUpdate)

รายการเวลาที่มีการอัปเดตระยะเวลาในคำขอนี้

EventPeriodUpdate

แหล่งข้อมูลการอัปเดตระยะเวลาของกิจกรรม

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

object (EventPeriodRange)

ระยะเวลาที่การอัปเดตนี้ครอบคลุม
updates[]

object (EventUpdateRequest)

การอัปเดตที่จัดทำขึ้นสำหรับระยะเวลานี้
kind

string

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

EventPeriodRange

ช่วงเวลาของเหตุการณ์

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

string

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

string (int64 format)

เวลาที่ระยะเวลาการอัปเดตนี้เริ่มต้น หน่วยเป็นมิลลิวินาที ตั้งแต่ 1970 UTC (Unix Epoch)
periodEndMillis

string (int64 format)

เวลาที่ระยะเวลาการอัปเดตนี้สิ้นสุดลง โดยมีหน่วยเป็นมิลลิวินาที ตั้งแต่ 1970 UTC (Unix Epoch)

EventUpdateRequest

แหล่งข้อมูลการอัปเดตระยะเวลาของกิจกรรม

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

string

รหัสเหตุการณ์ที่แก้ไขในการอัปเดตนี้
updateCount

string (int64 format)

จำนวนครั้งที่เหตุการณ์นี้เกิดขึ้นในระยะเวลานี้
kind

string

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

EventBatchRecordFailure

ทรัพยากรการอัปเดตเป็นกลุ่มที่ล้มเหลว

การแสดง JSON 
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
ช่อง
range

object (EventPeriodRange)

ช่วงเวลาที่ถูกปฏิเสธ ว่างเปล่าสำหรับความล้มเหลวทั้งคำขอ
failureCause

enum (EventFailureCause)

สาเหตุที่การอัปเดตล้มเหลว
kind

string

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

EventFailureCause

ค่าที่เป็นไปได้สำหรับสาเหตุที่เหตุการณ์ล้มเหลว

Enum
TOO_LARGE มีการออกคำขอแบบกลุ่มที่มีเหตุการณ์มากกว่าที่อนุญาตในชุดเดียว
TIME_PERIOD_EXPIRED มีการส่งกลุ่มโดยมีข้อมูลในอดีตมากเกินกว่าที่จะบันทึกได้ในอดีต
TIME_PERIOD_SHORT มีการส่งกลุ่มที่มีช่วงเวลาสั้นเกินไป
TIME_PERIOD_LONG มีการส่งกลุ่มที่มีช่วงเวลาที่ยาวเกินไป
ALREADY_UPDATED มีการพยายามบันทึกกลุ่มข้อมูลที่เคยเห็นแล้ว
RECORD_RATE_HIGH มีการพยายามบันทึกข้อมูลเร็วกว่าที่เซิร์ฟเวอร์จะใช้อัปเดต

EventRecordFailure

แหล่งข้อมูลการอัปเดตเหตุการณ์ล้มเหลว

การแสดง JSON 
{
  "eventId": string,
  "failureCause": enum (EventUpdateFailureCause),
  "kind": string
}
ช่อง
eventId

string

รหัสของเหตุการณ์ที่ไม่ได้อัปเดต
failureCause

enum (EventUpdateFailureCause)

สาเหตุที่การอัปเดตล้มเหลว
kind

string

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

EventUpdateFailureCause

ค่าที่เป็นไปได้สำหรับสาเหตุที่ทำให้การอัปเดตเหตุการณ์ล้มเหลว

Enum
NOT_FOUND มีการพยายามตั้งค่าเหตุการณ์ที่ไม่ได้กำหนดไว้
INVALID_UPDATE_VALUE มีการพยายามเพิ่มเหตุการณ์โดยค่าที่ไม่ใช่ค่าบวก