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 بالتوقيت العالمي المنسَّق (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 حسب التوقيت العالمي المنسَّق (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

القيم المحتملة لسبب إخفاق الحدث.

عمليات التعداد
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

القيم المحتملة لسبب تعذُّر تعديل الحدث.

عمليات التعداد
NOT_FOUND جرت محاولة لضبط حدث غير محدّد.
INVALID_UPDATE_VALUE جرت محاولة لزيادة أحد الأحداث بقيمة غير موجبة.