- คำขอ HTTP
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- ลองใช้งาน
บันทึกชุดการเปลี่ยนแปลงจำนวนครั้งที่เกิดเหตุการณ์ขึ้นสำหรับผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบันของแอปพลิเคชันนี้
คำขอ HTTP
POST https://games.googleapis.com/games/v1/events
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
language |
ภาษาที่ต้องการใช้สำหรับสตริงที่แสดงผลโดยวิธีการนี้ |
เนื้อหาของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ EventsUpdates
เนื้อหาการตอบกลับ
แหล่งข้อมูลการอัปเดตระยะเวลาของกิจกรรม
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "kind": string, "batchFailures": [ { object ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าเป็นสตริงคงที่ |
batchFailures[] |
ความล้มเหลวของทั้งกลุ่มที่เกิดขึ้นขณะใช้การอัปเดต |
eventFailures[] |
การอัปเดตเหตุการณ์หนึ่งๆ ล้มเหลว |
playerEvents[] |
สถานะปัจจุบันของกิจกรรมที่อัปเดตแล้ว |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต 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 ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าเป็นสตริงคงที่ |
requestId |
รหัสคำขอที่ใช้ระบุความพยายามที่จะบันทึกเหตุการณ์นี้ |
currentTimeMillis |
เวลาปัจจุบันที่ส่งการอัปเดตนี้ในหน่วยมิลลิวินาที ตั้งแต่ 1970 UTC (Unix Epoch) |
timePeriods[] |
รายการเวลาที่มีการอัปเดตระยะเวลาในคำขอนี้ |
EventPeriodUpdate
แหล่งข้อมูลการอัปเดตระยะเวลาของกิจกรรม
การแสดง JSON |
---|
{ "timePeriod": { object ( |
ช่อง | |
---|---|
timePeriod |
ระยะเวลาที่การอัปเดตนี้ครอบคลุม |
updates[] |
การอัปเดตที่จัดทำขึ้นสำหรับระยะเวลานี้ |
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าเป็นสตริงคงที่ |
EventPeriodRange
ช่วงเวลาของเหตุการณ์
การแสดง JSON |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าเป็นสตริงคงที่ |
periodStartMillis |
เวลาที่ระยะเวลาการอัปเดตนี้เริ่มต้น หน่วยเป็นมิลลิวินาที ตั้งแต่ 1970 UTC (Unix Epoch) |
periodEndMillis |
เวลาที่ระยะเวลาการอัปเดตนี้สิ้นสุดลง โดยมีหน่วยเป็นมิลลิวินาที ตั้งแต่ 1970 UTC (Unix Epoch) |
EventUpdateRequest
แหล่งข้อมูลการอัปเดตระยะเวลาของกิจกรรม
การแสดง JSON |
---|
{ "definitionId": string, "updateCount": string, "kind": string } |
ช่อง | |
---|---|
definitionId |
รหัสเหตุการณ์ที่แก้ไขในการอัปเดตนี้ |
updateCount |
จำนวนครั้งที่เหตุการณ์นี้เกิดขึ้นในระยะเวลานี้ |
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าเป็นสตริงคงที่ |
EventBatchRecordFailure
ทรัพยากรการอัปเดตเป็นกลุ่มที่ล้มเหลว
การแสดง JSON |
---|
{ "range": { object ( |
ช่อง | |
---|---|
range |
ช่วงเวลาที่ถูกปฏิเสธ ว่างเปล่าสำหรับความล้มเหลวทั้งคำขอ |
failureCause |
สาเหตุที่การอัปเดตล้มเหลว |
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าเป็นสตริงคงที่ |
EventFailureCause
ค่าที่เป็นไปได้สำหรับสาเหตุที่เหตุการณ์ล้มเหลว
Enum | |
---|---|
TOO_LARGE |
มีการออกคำขอแบบกลุ่มที่มีเหตุการณ์มากกว่าที่อนุญาตในชุดเดียว |
TIME_PERIOD_EXPIRED |
มีการส่งกลุ่มโดยมีข้อมูลในอดีตมากเกินกว่าที่จะบันทึกได้ในอดีต |
TIME_PERIOD_SHORT |
มีการส่งกลุ่มที่มีช่วงเวลาสั้นเกินไป |
TIME_PERIOD_LONG |
มีการส่งกลุ่มที่มีช่วงเวลาที่ยาวเกินไป |
ALREADY_UPDATED |
มีการพยายามบันทึกกลุ่มข้อมูลที่เคยเห็นแล้ว |
RECORD_RATE_HIGH |
มีการพยายามบันทึกข้อมูลเร็วกว่าที่เซิร์ฟเวอร์จะใช้อัปเดต |
EventRecordFailure
แหล่งข้อมูลการอัปเดตเหตุการณ์ล้มเหลว
การแสดง JSON |
---|
{
"eventId": string,
"failureCause": enum ( |
ช่อง | |
---|---|
eventId |
รหัสของเหตุการณ์ที่ไม่ได้อัปเดต |
failureCause |
สาเหตุที่การอัปเดตล้มเหลว |
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าเป็นสตริงคงที่ |
EventUpdateFailureCause
ค่าที่เป็นไปได้สำหรับสาเหตุที่ทำให้การอัปเดตเหตุการณ์ล้มเหลว
Enum | |
---|---|
NOT_FOUND |
มีการพยายามตั้งค่าเหตุการณ์ที่ไม่ได้กำหนดไว้ |
INVALID_UPDATE_VALUE |
มีการพยายามเพิ่มเหตุการณ์โดยค่าที่ไม่ใช่ค่าบวก |