Package google.type

색인

• Date(메시지)
• DayOfWeek(열거형)
• Interval(메시지)
• PhoneNumber(메시지)
• PhoneNumber.ShortCode(메시지)
• 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 선택사항입니다. 간격의 끝(제외)입니다. 지정된 경우 이 간격과 일치하는 타임스탬프가 끝점 이전이어야 합니다.

PhoneNumber

전화번호를 나타내는 객체로, API 전송 형식으로 적합합니다.

이 표현은 다음과 같습니다.

• '[phone] ext. 123'과 같이 언어별 전화번호 형식 지정에 사용해서는 안 됩니다.

• 효율적인 저장을 위해 설계되지 않음

• 전화 걸기에는 적합하지 않을 수 있습니다. 이러한 용도로 번호를 파싱하려면 전문 라이브러리 (참조 참조)를 사용해야 합니다.

이 숫자로 의미 있는 작업(예: 다양한 사용 사례에 맞게 형식 지정)하려면 먼저 i18n.phonenumbers.PhoneNumber 객체로 변환합니다.

예를 들어 자바에서는 다음과 같습니다.

com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); }

참조: - https://github.com/google/libphonenumber

입력란
extension	string 전화번호의 내선입니다. 확장은 최대 길이가 40자리인 일련의 숫자로 정의되는 경우를 제외하고는 ITU 권장사항에서 표준화되지 않았습니다. 숫자 이외에 ',' (대기를 나타냄) 또는 '#'과 같은 기타 다이얼링 문자가 여기에 저장될 수 있습니다. 현재 짧은 코드가 있는 광고 확장을 사용하는 지역이 없으므로 이 입력란은 일반적으로 E.164 번호와 함께 설정됩니다. 향후 짧은 코드 확장을 위해 E.164 번호와 별도로 보류됩니다.
통합 필드 kind. 필수 항목입니다. 일반 번호 또는 짧은 코드입니다. 향후 새 필드가 아래 항목 중 하나에 추가될 수 있으므로 클라이언트는 코딩하는 어떤 필드도 설정되지 않은 전화번호를 무시해야 합니다. kind는 다음 중 하나여야 합니다.
e164_number	string 선행 더하기 기호 ('+')로 표시되는 전화번호, 추가 공백이나 형식 없이 국가 통화 코드 (1~3자리)와 구독자 번호로 구성된 여유로운 ITU E.164 형식을 사용하는 전화번호입니다.예를 들면 다음과 같습니다. - 올바른 예: '[phone]' - 잘못된 경우: '[phone] x123' ITU E.164 형식에서는 후자를 12자리로 제한하지만, 실제로 모든 국가에서 이를 인정하는 것은 아니므로 이 제한을 완화했습니다. 국가 전용 전화번호는 허용되지 않습니다. 참고 자료: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164 https://en.wikipedia.org/wiki/List_of_country_calling_codes
short_code	ShortCode 쇼트 코드. 참고 자료: https://en.wikipedia.org/wiki/Short_code

ShortCode

짧은 코드를 나타내는 객체로, 일반적으로 일반 전화번호보다 훨씬 짧은 전화번호이며 MMS와 SMS 시스템에서 메시지를 처리하는 데 사용하거나 약식 통화를 하는 데 사용할 수 있습니다 (예: '611에 문자 메시지로 남은 요금제 시간 확인').

짧은 코드는 한 지역으로 제한되며 국제적으로 전화할 수 없습니다. 즉, 동일한 짧은 코드가 여러 지역에 존재할 수 있으며, 같은 국가 통화 코드 (예: 미국과 캐나다)를 공유하더라도 사용량과 가격이 다를 수 있습니다.

입력란
region_code	string 필수 항목입니다. 이 짧은 코드를 호출할 수 있는 위치의 BCP-47 지역 코드입니다(예: 'US' 및 'BB'). 참조: - http://www.unicode.org/reports/tr35/#unicode_region_subtag
number	string 필수 항목입니다. 선행 더하기('+') 또는 국가 전화 코드가 없는 짧은 코드 숫자(예: '611')입니다.

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 선택사항입니다. 국가 또는 지역의 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 주, 도, 주 또는 현일 수 있습니다. 특히 스페인의 경우 이 지역은 자치지구가 아닌 주입니다 (예: '카탈로니아'가 아닌 '바르셀로나'). 많은 국가에서는 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 필드를 채우지 않은 상태로 두어야 합니다.
locality	string 선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, IT 코뮤, 영국 우체국 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워 두고 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').