RequestHeader

서버로 전송된 모든 요청에 대해 정의된 헤더 객체입니다.

JSON 표현
{
  "requestId": string,
  "requestTimestamp": string,
  "userLocale": string,
  "protocolVersion": {
    object (Version)
  }
}
필드
requestId

string

필수: 이 요청의 고유 식별자입니다.

이 문자열은 최대 길이가 100자이고 'a-z', 'A-Z', '0-9', ':', '-', '_' 문자만 포함하는 문자열입니다.

requestTimestamp

string (int64 format)

필수: 이 요청의 타임스탬프가 에포크 이후 밀리초로 표시됩니다. 수신기는 이 타임스탬프가 '지금'의 ±60인지 확인해야 합니다. 이 요청 타임스탬프는 재시도 시 멱등성이 아닙니다.

userLocale
(deprecated)

string

지원 중단됨: 2자리 또는 3자리 ISO 639-2 Alpha 3 언어 코드이며 원하는 경우 하이픈과 ISO 3166-1 Alpha-2 국가 코드를 추가할 수 있습니다(예: 'pt', 'pt-BR', 'fil', 'fil-PH'). 이를 통해 응답에서 userMessage 필드를 구동할 수 있습니다.

protocolVersion

object (Version)

필수: 이 요청의 버전입니다.

버전

기존 a.b.c 버전 구조의 구조화된 형식인 버전 객체. 동일한 번호의 메이저 버전은 호환성을 보장합니다. 마이너 버전과 버전은 예고 없이 자주 변경될 수 있습니다. 통합자는 동일한 주 버전에 대한 모든 요청을 지원해야 합니다.

JSON 표현
{
  "major": integer,
  "minor": integer,
  "revision": integer
}
필드
major

integer

필수: 주요 버전입니다. 이는 다른 버전의 호환성 요청에 대해 호환된다는 것이 보장되지 않습니다.

minor

integer

필수: 마이너 버전. 이는 중요한 버그 수정을 나타냅니다.

revision

integer

필수: 마이너 버전. 사소한 버그 수정을 나타냅니다.