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 이벤트를 양수가 아닌 값으로 증분하려고 시도했습니다.

API reference packages and classes for Android app developers.

업데이트됨 Feb 10, 2025

API reference packages and classes for Android app developers.

업데이트됨 Feb 13, 2025

API reference packages and classes for Android app developers.

업데이트됨 Feb 10, 2025