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 (שעון יוניקס [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 נעשה ניסיון להגדיל אירוע בערך שאינו חיובי.