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년 UTC(Unix 에포크) 이후 이 업데이트가 전송된 현재 시간(밀리초)입니다.
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년 UTC(Unix 에포크) 이후 이 업데이트 기간이 시작되는 시간(밀리초 단위)입니다.
periodEndMillis

string (int64 format)

1970년 UTC (Unix 에포크) 이후 이 업데이트 기간이 종료되는 시간을 밀리초 단위로 표시합니다.

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

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

열거형
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

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

열거형
NOT_FOUND 정의되지 않은 이벤트를 설정하려고 했습니다.
INVALID_UPDATE_VALUE 양수가 아닌 값으로 이벤트를 늘리려고 했습니다.