Package google.type

색인

• Date(메시지)
• DayOfWeek(열거형)
• Interval(메시지)
• LatLng(메시지)
• Money(메시지)
• PostalAddress(메시지)
• TimeOfDay(메시지)
• TimeZone(메시지)

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.

• 연도, 월, 일 값이 0이 아닌 전체 날짜
• 월과 일, 연도는 0(예: 기념일)
• 연도만, 월과 일은 0
• 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

• google.type.TimeOfDay
• google.type.DateTime
• google.protobuf.Timestamp

필드
year	int32 날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.
month	int32 연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.
day	int32 월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

DayOfWeek

요일을 나타냅니다.

열거형
DAY_OF_WEEK_UNSPECIFIED	요일이 지정되지 않습니다.
MONDAY	월요일
TUESDAY	화요일
WEDNESDAY	수요일
THURSDAY	목요일
FRIDAY	금요일
SATURDAY	토요일
SUNDAY	일요일

간격

타임스탬프 시작(포함) 및 타임스탬프 종료(제외)로 인코딩된 시간 간격을 나타냅니다.

시작은 종료보다 작거나 같아야 합니다. 시작이 종료와 같으면 간격이 비어 있습니다(시간과 일치하지 않음). 시작과 종료가 모두 지정되지 않은 경우 간격은 모든 시간과 일치합니다.

필드
start_time	Timestamp 선택사항입니다. 간격의 시작(포함)입니다. 지정된 경우 이 간격과 일치하는 타임스탬프는 시작과 같거나 시작 이후여야 합니다.
end_time	Timestamp (선택사항) 간격의 끝(제외)입니다. 지정된 경우 이 간격과 일치하는 타임스탬프는 종료 시간 이전이어야 합니다.

LatLng

위도/경도 쌍을 나타내는 객체로 위도(도)와 경도(도)를 나타내는 double의 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.

필드
latitude	double 위도입니다. 범위는 [-90.0, +90.0]입니다.
longitude	double 경도입니다. 범위는 [-180.0, +180.0]입니다.

금액

금액과 통화 유형을 나타냅니다.

필드
currency_code	string ISO 4217에 정의된 3자리 통화 코드입니다.
units	int64 이 금액의 온전한 단위입니다. 예를 들어 currencyCode가 "USD"이면 1단위는 미화 1달러입니다.
nanos	int32 이 금액의 나노 (10^-9) 단위 숫자입니다. 이 값은 -999,999,999~+999,999,999(끝값 포함) 사이여야 합니다. units가 양수이면 nanos는 양수 또는 0이어야 합니다. units가 0이면 nanos는 양수, 0 또는 음수일 수 있습니다. units가 음수이면 nanos는 음수 또는 0이어야 합니다. 예를 들어 $-1.75는 units=-1 및 nanos=-750,000,000으로 나타냅니다.

PostalAddress

우편 배송 또는 결제 주소와 같은 우편 주소를 나타냅니다. 우편 주소를 사용하면 우편 서비스에서 구내, 사서함 등으로 물품을 배송할 수 있습니다. 우편 주소는 도로, 마을, 산과 같은 지리적 위치를 모델링하기 위한 것이 아닙니다.

일반적인 사용 사례에서는 프로세스 유형에 따라 사용자 입력 또는 기존 데이터 가져오기를 통해 주소가 생성됩니다.

주소 입력 또는 수정에 관한 조언:

• https://github.com/google/libaddressinput과 같은 국제화 지원 주소 위젯을 사용합니다.
• 사용자에게 해당 필드가 사용되는 국가 이외의 국가에서 필드를 입력하거나 수정할 수 있는 UI 요소가 표시되어서는 안 됩니다.

이 스키마를 사용하는 방법에 관한 자세한 내용은 https://support.google.com/business/answer/6397478을 참고하세요.

필드
revision	int32 PostalAddress의 스키마 버전입니다. 최신 버전인 0으로 설정해야 합니다. 모든 새 버전은 이전 버전과 하위 호환되어야 합니다.
region_code	string 필수 항목입니다. 주소의 국가/지역에 해당하는 CLDR 지역 코드입니다. 이 값은 추론되지 않으며 값이 올바른지 확인하는 것은 사용자의 책임입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 스위스의 경우 'CH'
language_code	string (선택사항) 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (알려진 경우). 이는 입력 양식의 UI 언어인 경우가 많으며, 주소의 국가/지역에서 사용되는 언어 중 하나 또는 이에 상응하는 음역과 일치할 것으로 예상됩니다. 이는 특정 국가의 형식에 영향을 미칠 수 있지만 데이터의 정확성에는 중요하지 않으며 유효성 검사나 기타 형식과 관련 없는 작업에는 영향을 미치지 않습니다. 이 값을 알 수 없는 경우 잘못된 기본값을 지정하는 대신 생략해야 합니다. 예: 'zh-Hant', 'ja', 'ja-Latn', 'en'.
postal_code	string (선택사항) 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 요구하는 것은 아니지만, 우편번호를 사용하는 경우 주소의 다른 부분 (예: 미국의 주 또는 우편번호 유효성 검사)과 함께 추가 유효성 검사가 트리거될 수 있습니다.
sorting_code	string (선택사항) 국가별 추가 분류 코드입니다. 대부분의 지역에서는 사용되지 않습니다. 사용되는 경우 값은 'CEDEX'와 같은 문자열이며, 뒤에 숫자 (예: 'CEDEX 7')가 오거나 숫자만으로 '부문 코드' (자메이카), '배송 지역 표시기' (말라위) 또는 '우체국 표시기' (코트디부아르)를 나타냅니다.
administrative_area	string (선택사항) 국가 또는 지역의 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 주, 지방, 주(oblast) 또는 현이 될 수 있습니다. 스페인의 경우 자치구가 아닌 주입니다 (예: '카탈루냐'가 아닌 '바르셀로나'). 많은 국가에서 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 항목을 입력하지 않은 상태로 두어야 합니다.
locality	string (선택사항) 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, 이탈리아 코무네, 영국 우편 도시 지역이 명확하게 정의되지 않거나 이 구조에 잘 맞지 않는 지역에서는 locality를 비워 두고 address_lines를 사용합니다.
sublocality	string (선택사항) 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구 또는 구역일 수 있습니다.
address_lines[]	string 주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다. address_lines의 값에는 유형 정보가 없으며 단일 필드에 여러 값 (예: 'Austin, TX')이 포함될 수 있으므로 줄 순서가 명확해야 합니다. 주소 입력란의 순서는 주소의 국가 또는 지역에 대한 '봉투 순서'여야 합니다. 이 순서가 달라질 수 있는 지역 (예: 일본)에서는 address_language를 사용하여 명시적으로 지정합니다 (예: 큰 단위에서 작은 단위 순서의 경우 'ja', 작은 단위에서 큰 단위 순서의 경우 'ja-Latn' 또는 'en'). 이렇게 하면 언어에 따라 가장 구체적인 주소 줄을 선택할 수 있습니다. 허용되는 최소한의 구조적 주소 표현은 region_code로 구성되며 나머지 모든 정보는 address_lines에 배치됩니다. 지오코딩 없이 이러한 주소의 형식을 대략적으로 지정할 수는 있지만, 적어도 부분적으로 해결될 때까지는 주소 구성요소에 대한 의미론적 추론을 할 수 없습니다. region_code 및 address_lines만 포함하는 주소를 만든 다음 지오코딩하는 것이 완전히 구조화되지 않은 주소를 처리하는 데 권장되는 방법입니다 (주소의 어느 부분이 지역 또는 행정 구역인지 추측하는 것과 반대).
recipients[]	string (선택사항) 주소의 수신자입니다. 이 필드에는 특정 상황에서 여러 줄의 정보가 포함될 수 있습니다. 예를 들어 '수취인' 정보가 포함될 수 있습니다.
organization	string (선택사항) 주소에 있는 조직의 이름입니다.

TimeOfDay

하루 중 특정 시간을 나타냅니다. 날짜와 시간대가 중요하지 않거나 아무 곳으로 지정됩니다. API는 윤초를 허용하도록 선택할 수 있습니다. 관련된 유형은 google.type.Date 및 google.protobuf.Timestamp입니다.

필드
hours	int32 24시간 형식의 시간입니다. 0 이상이어야 하며 일반적으로 23 이하여야 합니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다.
minutes	int32 특정 시간의 분입니다. 0 이상 59 이하여야 합니다.
seconds	int32 1분 기준의 초입니다. 0 이상이어야 하며 일반적으로 59 이하여야 합니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.
nanos	int32 나노초 단위의 초수입니다. 0 이상, 999,999,999 이하여야 합니다.

TimeZone

IANA 시간대 데이터베이스에서 가져온 시간대를 나타냅니다.

필드
id	string IANA 시간대 데이터베이스 시간대입니다. 예를 들면 "America/New_York"입니다.
version	string 선택사항. IANA 시간대 데이터베이스 버전 번호입니다. 예를 들면 "2019a"입니다.