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)

이벤트 기록 시도를 식별하는 데 사용되는 요청 ID입니다.
currentTimeMillis

string (int64 format)

1970년 1월 1일 UTC(유닉스 에포크) 이후 이 업데이트가 전송된 현재 시간(밀리초)입니다.
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년 1월 1일 UTC(Unix 에포크) 이후 이 업데이트 기간이 시작된 시간(밀리초)입니다.
periodEndMillis

string (int64 format)

1970년 1월 1일 UTC(유닉스 에포크) 이후 이 업데이트 기간이 종료되는 시간(밀리초)입니다.

EventUpdateRequest

이벤트 기간 업데이트 리소스입니다.

JSON 표현 
{
  "definitionId": string,
  "updateCount": string,
  "kind": string
}
필드
definitionId

string

이 업데이트에서 수정되는 이벤트의 ID입니다.
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

이벤트 실패 원인에 가능한 값입니다.

Enum
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

업데이트되지 않은 이벤트의 ID입니다.
failureCause

enum (EventUpdateFailureCause)

업데이트 실패의 원인입니다.
kind

string

이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#eventRecordFailure입니다.

EventUpdateFailureCause

이벤트 업데이트 실패의 원인에 대한 가능한 값입니다.

Enum
NOT_FOUND 정의되지 않은 이벤트를 설정하려고 시도했습니다.
INVALID_UPDATE_VALUE 이벤트를 양수가 아닌 값으로 증분하려고 시도했습니다.