- HTTP 요청
- 쿼리 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- 실습
이 애플리케이션의 현재 인증된 사용자에 대해 이벤트가 발생한 횟수에 대한 변경사항을 일괄 기록합니다.
HTTP 요청
POST https://games.googleapis.com/games/v1/events
쿼리 매개변수
매개변수 | |
---|---|
language |
이 메서드가 반환하는 문자열에 사용할 기본 언어입니다. |
요청 본문
요청 본문에 EventsUpdates
의 인스턴스가 포함됩니다.
응답 본문
이벤트 기간 업데이트 리소스입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "kind": string, "batchFailures": [ { object ( |
필드 | |
---|---|
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
batchFailures[] |
업데이트 적용에서 발생한 모든 일괄 처리 실패입니다. |
eventFailures[] |
특정 이벤트 업데이트에 실패한 경우 |
playerEvents[] |
업데이트된 이벤트의 현재 상태 |
승인 범위
다음 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 ( |
필드 | |
---|---|
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
requestId |
이 이벤트 기록 시도를 식별하는 데 사용되는 요청 ID입니다. |
currentTimeMillis |
1970년 UTC(Unix 에포크) 이후 이 업데이트가 전송된 현재 시간(밀리초)입니다. |
timePeriods[] |
이 요청에서 이루어진 기간 업데이트의 목록입니다. |
EventPeriodUpdate
이벤트 기간 업데이트 리소스입니다.
JSON 표현 |
---|
{ "timePeriod": { object ( |
필드 | |
---|---|
timePeriod |
이 업데이트가 적용되는 기간입니다. |
updates[] |
이 기간에 진행 중인 업데이트입니다. |
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
EventPeriodRange
이벤트 기간입니다.
JSON 표현 |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
필드 | |
---|---|
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
periodStartMillis |
이 업데이트 기간이 시작되는 시간으로 1970 UTC (Unix Epoch) 이후부터 밀리초 단위로 표시됩니다. |
periodEndMillis |
1970 UTC(Unix 에포크) 이후 이 업데이트 기간이 종료되는 시간(밀리초)입니다. |
EventUpdateRequest
이벤트 기간 업데이트 리소스입니다.
JSON 표현 |
---|
{ "definitionId": string, "updateCount": string, "kind": string } |
필드 | |
---|---|
definitionId |
이 업데이트에서 수정되는 이벤트의 ID입니다. |
updateCount |
선택한 기간에 이벤트가 발생한 횟수입니다. |
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
EventBatchRecordFailure
일괄 업데이트 실패 리소스입니다.
JSON 표현 |
---|
{ "range": { object ( |
필드 | |
---|---|
range |
거부된 기간 요청 전체 실패의 경우 비어 있습니다. |
failureCause |
업데이트 실패 원인입니다. |
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
EventFailureCause
이벤트 실패 원인에 사용할 수 있는 값입니다.
열거형 | |
---|---|
TOO_LARGE |
일괄 요청에 단일 일괄에서 허용되는 것보다 더 많은 이벤트가 포함되어 있습니다. |
TIME_PERIOD_EXPIRED |
배치가 전송된 데이터가 너무 오래되어 기록할 수 없습니다. |
TIME_PERIOD_SHORT |
배치가 전송된 기간이 너무 짧습니다. |
TIME_PERIOD_LONG |
배치가 전송된 기간이 너무 깁니다. |
ALREADY_UPDATED |
이미 표시된 데이터 배치를 기록하려고 했습니다. |
RECORD_RATE_HIGH |
서버에서 업데이트를 적용하는 속도보다 빨리 데이터를 기록하려고 했습니다. |
EventRecordFailure
이벤트 업데이트 실패 리소스입니다.
JSON 표현 |
---|
{
"eventId": string,
"failureCause": enum ( |
필드 | |
---|---|
eventId |
업데이트되지 않은 이벤트의 ID입니다. |
failureCause |
업데이트 실패 원인입니다. |
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
EventUpdateFailureCause
이벤트 업데이트 실패의 원인으로 사용할 수 있는 값입니다.
열거형 | |
---|---|
NOT_FOUND |
정의되지 않은 이벤트를 설정하려고 했습니다. |
INVALID_UPDATE_VALUE |
양수가 아닌 값으로 이벤트를 증가시키려고 했습니다. |