Method: events.record

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

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

POST https://games.googleapis.com/games/v1/events

क्वेरी पैरामीटर

पैरामीटर
language

string

इस तरीके से दिखाई गई स्ट्रिंग के लिए, इस्तेमाल की जाने वाली पसंदीदा भाषा.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में EventsUpdates का उदाहरण है.

जवाब का मुख्य भाग

इवेंट की अवधि को अपडेट करने वाला संसाधन.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "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

इवेंट की अवधि को अपडेट करने वाला संसाधन.

जेएसओएन के काेड में दिखाना 
{
  "kind": string,
  "requestId": string,
  "currentTimeMillis": string,
  "timePeriods": [
    {
      object (EventPeriodUpdate)
    }
  ]
}
फ़ील्ड
kind

string

यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग games#eventRecordRequest होती है.
requestId

string (int64 format)

अनुरोध आईडी, जिससे इवेंट रिकॉर्ड करने की इस कोशिश की पहचान की जाती है.
currentTimeMillis

string (int64 format)

1970 UTC (Unix Epoch) के बाद से, इस अपडेट को भेजे जाने का मौजूदा समय (मिलीसेकंड में).
timePeriods[]

object (EventPeriodUpdate)

इस अनुरोध में की जा रही समयावधि के अपडेट की सूची.

EventPeriodUpdate

इवेंट की अवधि को अपडेट करने वाला संसाधन.

जेएसओएन के काेड में दिखाना 
{
  "timePeriod": {
    object (EventPeriodRange)
  },
  "updates": [
    {
      object (EventUpdateRequest)
    }
  ],
  "kind": string
}
फ़ील्ड
timePeriod

object (EventPeriodRange)

इस अपडेट में शामिल की गई समयावधि.
updates[]

object (EventUpdateRequest)

इस समयावधि के लिए किए जा रहे अपडेट.
kind

string

यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग games#eventPeriodUpdate होती है.

EventPeriodRange

इवेंट की समयावधि.

जेएसओएन के काेड में दिखाना 
{
  "kind": string,
  "periodStartMillis": string,
  "periodEndMillis": string
}
फ़ील्ड
kind

string

यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग games#eventPeriodRange होती है.
periodStartMillis

string (int64 format)

अपडेट की यह अवधि, मिलीसेकंड में, 1970 यूटीसी (यूनिक्स एपोच) के बाद से शुरू होती है.
periodEndMillis

string (int64 format)

अपडेट की यह अवधि, मिलीसेकंड में, 1970 यूटीसी (Unix Epoch) के बाद का है.

EventUpdateRequest

इवेंट की अवधि को अपडेट करने वाला संसाधन.

जेएसओएन के काेड में दिखाना 
{
  "definitionId": string,
  "updateCount": string,
  "kind": string
}
फ़ील्ड
definitionId

string

उस इवेंट का आईडी जिसे इस अपडेट में बदला जा रहा है.
updateCount

string (int64 format)

इस समयावधि में यह इवेंट कितनी बार हुआ.
kind

string

यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग games#eventUpdateRequest होती है.

EventBatchRecordFailure

बैच अपडेट न हो पाने के बारे में जानकारी देने वाला रिसॉर्स.

जेएसओएन के काेड में दिखाना 
{
  "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

ऐसा संसाधन जो इवेंट अपडेट नहीं कर सका.

जेएसओएन के काेड में दिखाना 
{
  "eventId": string,
  "failureCause": enum (EventUpdateFailureCause),
  "kind": string
}
फ़ील्ड
eventId

string

उस इवेंट का आईडी जिसे अपडेट नहीं किया गया.
failureCause

enum (EventUpdateFailureCause)

अपडेट न हो पाने की वजह.
kind

string

यह अलग-अलग तरीके से यह बताता है कि यह संसाधन किस तरह का है. वैल्यू हमेशा तय स्ट्रिंग games#eventRecordFailure होती है.

EventUpdateFailureCause

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

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