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 تم إجراء محاولة لزيادة حدث بقيمة غير موجبة.