- คำขอ 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 |
มีการเพิ่มเหตุการณ์ด้วยค่าที่ไม่เป็นบวก |