- طلب 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 بالتوقيت العالمي المنسَّق (Unix Epoch). |
timePeriods[] |
قائمة بالتعديلات التي يتم إجراؤها على الفترة الزمنية في هذا الطلب |
EventPeriodUpdate
مورد تحديث فترة الحدث
تمثيل JSON |
---|
{ "timePeriod": { object ( |
الحقول | |
---|---|
timePeriod |
الفترة الزمنية التي يغطيها هذا التعديل. |
updates[] |
التعديلات التي يتم إجراؤها لهذه الفترة الزمنية |
kind |
يحدِّد نوع هذا المورد بشكلٍ فريد. القيمة هي دائمًا السلسلة الثابتة |
EventPeriodRange
النطاق الزمني لفترة الحدث.
تمثيل JSON |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
الحقول | |
---|---|
kind |
يحدِّد نوع هذا المورد بشكلٍ فريد. القيمة هي دائمًا السلسلة الثابتة |
periodStartMillis |
وقت بدء فترة التحديث هذه بالمللي ثانية، منذ عام 1970 حسب التوقيت العالمي المنسَّق (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
القيم المحتملة لسبب إخفاق الحدث.
عمليات التعداد | |
---|---|
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
القيم المحتملة لسبب تعذُّر تعديل الحدث.
عمليات التعداد | |
---|---|
NOT_FOUND |
جرت محاولة لضبط حدث غير محدّد. |
INVALID_UPDATE_VALUE |
جرت محاولة لزيادة أحد الأحداث بقيمة غير موجبة. |