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