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 개요를 참고하세요.

이벤트 업데이트

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

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 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년 UTC (Unix Epoch) 이후 이 업데이트 기간이 시작되는 시간을 밀리초 단위로 표시합니다.
periodEndMillis

string (int64 format)

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

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 양수가 아닌 값만큼 이벤트를 늘리려고 했습니다.