- 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년 1월 1일 UTC(유닉스 에포크) 이후 이 업데이트가 전송된 현재 시간(밀리초)입니다. |
timePeriods[] |
이 요청에서 업데이트되는 기간 목록입니다. |
EventPeriodUpdate
이벤트 기간 업데이트 리소스입니다.
JSON 표현 |
---|
{ "timePeriod": { object ( |
필드 | |
---|---|
timePeriod |
이 업데이트가 적용되는 기간입니다. |
updates[] |
이 기간에 적용되는 업데이트입니다. |
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
EventPeriodRange
이벤트 기간 시간 범위입니다.
JSON 표현 |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
필드 | |
---|---|
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
periodStartMillis |
1970년 1월 1일 UTC(Unix 에포크) 이후 이 업데이트 기간이 시작된 시간(밀리초)입니다. |
periodEndMillis |
1970년 1월 1일 UTC(유닉스 에포크) 이후 이 업데이트 기간이 종료되는 시간(밀리초)입니다. |
EventUpdateRequest
이벤트 기간 업데이트 리소스입니다.
JSON 표현 |
---|
{ "definitionId": string, "updateCount": string, "kind": string } |
필드 | |
---|---|
definitionId |
이 업데이트에서 수정되는 이벤트의 ID입니다. |
updateCount |
이 기간에 이 이벤트가 발생한 횟수입니다. |
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
EventBatchRecordFailure
일괄 업데이트 실패 리소스입니다.
JSON 표현 |
---|
{ "range": { object ( |
필드 | |
---|---|
range |
거부된 시간 범위입니다. 요청 전반의 실패인 경우 비어 있습니다. |
failureCause |
업데이트 실패의 원인입니다. |
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
EventFailureCause
이벤트 실패 원인에 가능한 값입니다.
Enum | |
---|---|
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
이벤트 업데이트 실패의 원인에 대한 가능한 값입니다.
Enum | |
---|---|
NOT_FOUND |
정의되지 않은 이벤트를 설정하려고 시도했습니다. |
INVALID_UPDATE_VALUE |
이벤트를 양수가 아닌 값으로 증분하려고 시도했습니다. |