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