Package google.type

색인

날짜

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

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

관련 유형:

필드
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 일요일

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

선택사항입니다. 국가 또는 지역의 우편 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 미국의 주, 캐나다의 주, 구소련의 주 또는 프랑스의 도가 될 수 있습니다. 스페인의 경우 광역 자치주가 아니라 주(province)입니다(예: '카탈로니아'가 아니라 '바르셀로나'). 많은 국가에서는 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 필드를 채우지 않은 상태로 두어야 합니다.
locality

string

선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 시, 이탈리아 코무네, 영국 포스트타운. 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 locality를 비워 두고 address_lines를 사용합니다.
sublocality

string

선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 구일 수 있습니다.
address_lines[]

string

주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다.

address_lines의 값에는 유형 정보가 없고 경우에 따라 하나의 필드에 여러 값이 포함될 수 있으므로 (예: 'Austin, TX') 행 순서가 명확해야 합니다. 주소 입력란 순서는 주소의 국가 또는 지역의 '봉투 순서'여야 합니다. 이것이 달라질 수 있는 곳 (예: 일본)에서는 address_language를 사용하여 명시적으로 만듭니다 (예: 큰 단위에서 작은 단위 순서는 'ja', 작은 단위에서 큰 단위 순서는 'ja-Latn' 또는 'en'). 이렇게 하면 언어를 기준으로 가장 구체적인 주소 입력란을 선택할 수 있습니다.

주소에 허용되는 최소 구조 표시는 나머지 모든 정보가 address_lines에 배치된 region_code로 구성됩니다. 이러한 주소를 지오코딩 없이 상당히 비슷하게 형식을 갖출 수도 있지만 최소한 부분적으로 확인될 때까지는 어떤 주소 구성요소에 대해서도 의미 추론을 할 수 없습니다.

주소 중 지역에 해당하는 부분과 행정 구역에 해당하는 부분을 추측하는 대신 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

분의 초입니다. 0 이상이어야 하며 일반적으로 59 이하여야 합니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.
nanos

int32

나노초 단위의 초수입니다. 0 이상, 999,999,999 이하여야 합니다.

TimeZone

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

필드
id

string

IANA 시간대 데이터베이스 시간대입니다. 예를 들면 "America/New_York"입니다.
version

string

선택사항. IANA 시간대 데이터베이스 버전 번호입니다. 예를 들면 "2019a"입니다.