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 مراجعه کنید.

رویدادها به روز رسانی

منبع به روز رسانی دوره رویداد.

نمایندگی 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 )

فهرستی از به‌روزرسانی‌های دوره زمانی که در این درخواست انجام می‌شود.

EventPeriod Update

منبع به روز رسانی دوره رویداد.

نمایندگی JSON
{
  "timePeriod": {
    object (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
زمینه های
timePeriod

object ( EventPeriodRange )

دوره زمانی تحت پوشش این به روز رسانی.

updates[]

object ( EventUpdateRequest )

به روز رسانی های در حال انجام برای این دوره زمانی.

kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. مقدار همیشه games#eventPeriodUpdate .

محدوده دوره رویداد

محدوده زمانی دوره رویداد.

نمایندگی JSON
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
زمینه های
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. مقدار همیشه games#eventPeriodRange است.

periodStartMillis

string ( int64 format)

زمانی که این دوره به‌روزرسانی، برحسب میلی‌س، از سال 1970 UTC (عصر یونیکس) آغاز می‌شود.

periodEndMillis

string ( int64 format)

زمانی که این دوره به‌روزرسانی، برحسب میلی‌س، از سال 1970 UTC (دوران یونیکس) به پایان می‌رسد.

EventUpdateRequest

منبع به روز رسانی دوره رویداد.

نمایندگی JSON
{
  "definitionId": string,
  "updateCount": string,
  "kind": string
}
زمینه های
definitionId

string

شناسه رویداد در حال تغییر در این به‌روزرسانی.

updateCount

string ( int64 format)

تعداد دفعاتی که این رویداد در این بازه زمانی رخ داده است.

kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. مقدار همیشه games#eventUpdateRequest .

EventBatchRecord Failure

یک منبع شکست دسته ای به روز رسانی.

نمایندگی JSON
{
  "range": {
    object (EventPeriodRange)
  },
  "failureCause": enum (EventFailureCause),
  "kind": string
}
زمینه های
range

object ( EventPeriodRange )

محدوده زمانی که رد شد. خالی برای شکست در سطح درخواست.

failureCause

enum ( EventFailureCause )

علت خرابی به روز رسانی

kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. مقدار همیشه games#eventBatchRecordFailure .

رویداد FailureCause

مقادیر ممکن برای یک رویداد باعث شکست می شود.

Enums
TOO_LARGE یک درخواست دسته‌ای با رویدادهای بیشتر از موارد مجاز در یک دسته صادر شد.
TIME_PERIOD_EXPIRED دسته ای با داده های بسیار دور در گذشته برای ضبط ارسال شده است.
TIME_PERIOD_SHORT یک دسته با محدوده زمانی بسیار کوتاه ارسال شد.
TIME_PERIOD_LONG یک دسته با محدوده زمانی بسیار طولانی ارسال شد.
ALREADY_UPDATED تلاش برای ثبت دسته ای از داده ها که قبلا دیده شده بود انجام شد.
RECORD_RATE_HIGH تلاشی برای ثبت داده‌ها سریع‌تر از آنچه سرور به‌روزرسانی‌ها را اعمال می‌کند، انجام شد.

EventRecord Failure

یک منبع شکست به‌روزرسانی رویداد.

نمایندگی JSON
{
  "eventId": string,
  "failureCause": enum (EventUpdateFailureCause),
  "kind": string
}
زمینه های
eventId

string

شناسه رویداد که به روز نشده است.

failureCause

enum ( EventUpdateFailureCause )

علت خرابی به روز رسانی

kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. مقدار همیشه games#eventRecordFailure .

EventUpdateFailureCause

مقادیر احتمالی علت خرابی به‌روزرسانی رویداد.

Enums
NOT_FOUND سعی شد رویدادی تنظیم شود که تعریف نشده باشد.
INVALID_UPDATE_VALUE تلاشی برای افزایش یک رویداد با مقدار غیر مثبت انجام شد.