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

ערכים אפשריים לסיבת הכשל של אירוע.

טיפוסים בני מנייה (enums)
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

ערכים אפשריים לסיבת הכשל בעדכון אירוע.

טיפוסים בני מנייה (enums)
NOT_FOUND נעשה ניסיון להגדיר אירוע שלא הוגדר.
INVALID_UPDATE_VALUE נעשה ניסיון להגדיל אירוע באמצעות ערך לא חיובי.