Method: events.record

इस ऐप्लिकेशन के पुष्टि किए गए मौजूदा उपयोगकर्ता के लिए, इवेंट की संख्या में हुए बदलावों का बैच रिकॉर्ड करता है.

एचटीटीपी अनुरोध

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

इवेंट न हो पाने की वजह के लिए संभावित वैल्यू.

Enums
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

इवेंट अपडेट नहीं होने की वजह के लिए संभावित वैल्यू.

Enums
NOT_FOUND किसी ऐसे इवेंट को सेट करने की कोशिश की गई थी जिसे तय नहीं किया गया था.
INVALID_UPDATE_VALUE एक इवेंट को एक गैर-पॉज़िटिव मान से बढ़ाने की कोशिश की गई.