- בקשת 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
ערכים אפשריים לסיבת הכשל של אירוע.
טיפוסים בני מנייה (enums) | |
---|---|
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
ערכים אפשריים לסיבת הכשל בעדכון אירוע.
טיפוסים בני מנייה (enums) | |
---|---|
NOT_FOUND |
נעשה ניסיון להגדיר אירוע שלא הוגדר. |
INVALID_UPDATE_VALUE |
נעשה ניסיון להגדיל אירוע באמצעות ערך לא חיובי. |