색인
Date
(메시지)DayOfWeek
(열거형)Interval
(메시지)PhoneNumber
(메시지)PhoneNumber.ShortCode
(메시지)PostalAddress
(메시지)TimeOfDay
(메시지)TimeZone
(메시지)
날짜
생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 이는 다음 중 하나를 나타낼 수 있습니다.
- 연도, 월, 일 값이 0이 아닌 전체 날짜
- 월과 일, 연도는 0(예: 기념일)
- 연도만, 월과 일은 0
- 연도와 월, 일은 0(예: 신용카드 만료일)
관련 유형:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
입력란 | |
---|---|
year |
날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다. |
month |
연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다. |
day |
월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다. |
DayOfWeek
요일을 나타냅니다.
열거형 | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
요일이 지정되지 않습니다. |
MONDAY |
월요일 |
TUESDAY |
화요일 |
WEDNESDAY |
수요일 |
THURSDAY |
목요일 |
FRIDAY |
금요일 |
SATURDAY |
토요일 |
SUNDAY |
일요일 |
간격
타임스탬프 시작 (포함) 및 타임스탬프 끝 (제외)으로 인코딩된 시간 간격을 나타냅니다.
시작 시간은 끝보다 작거나 같아야 합니다. 시작이 끝과 같으면 간격은 비어 있습니다 (시간과 일치하지 않음). 시작과 끝이 모두 지정되지 않으면 간격은 항상 일치합니다.
입력란 | |
---|---|
start_time |
선택사항입니다. 포함 간격의 시작입니다. 지정된 경우 이 간격과 일치하는 타임스탬프는 시작 시점과 같거나 그 이후의 타임스탬프여야 합니다. |
end_time |
선택사항입니다. 간격의 끝(제외)입니다. 지정된 경우 이 간격과 일치하는 타임스탬프가 끝점 이전이어야 합니다. |
PhoneNumber
전화번호를 나타내는 객체로, API 전송 형식으로 적합합니다.
이 표현은 다음과 같습니다.
'+1 (650) 253-0000 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()); }
입력란 | |
---|---|
extension |
전화번호의 내선입니다. 확장은 최대 길이가 40자리인 일련의 숫자로 정의되는 경우를 제외하고는 ITU 권장사항에서 표준화되지 않았습니다. 숫자 이외에 ',' (대기를 나타냄) 또는 '#'과 같은 기타 다이얼링 문자가 여기에 저장될 수 있습니다. 현재 짧은 코드가 있는 광고 확장을 사용하는 지역이 없으므로 이 입력란은 일반적으로 E.164 번호와 함께 설정됩니다. 향후 짧은 코드 확장을 위해 E.164 번호와 별도로 보류됩니다. |
통합 필드 kind . 필수 항목입니다. 일반 번호 또는 짧은 코드입니다. 향후 새 필드가 아래 항목 중 하나에 추가될 수 있으므로 클라이언트는 코딩하는 어떤 필드도 설정되지 않은 전화번호를 무시해야 합니다. kind 는 다음 중 하나여야 합니다. |
|
e164_number |
선행 더하기 기호 ('+')로 표시되는 전화번호, 추가 공백이나 형식 없이 국가 통화 코드 (1~3자리)와 구독자 번호로 구성된 여유로운 ITU E.164 형식을 사용하는 전화번호입니다.예를 들면 다음과 같습니다. - 올바른 예: '+15552220123' - 잘못된 경우: '+1 (555) 222-01234 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
짧은 코드를 나타내는 객체로, 일반적으로 일반 전화번호보다 훨씬 짧은 전화번호이며 MMS와 SMS 시스템에서 메시지를 처리하는 데 사용하거나 약식 통화를 하는 데 사용할 수 있습니다 (예: '611에 문자 메시지로 남은 요금제 시간 확인').
짧은 코드는 한 지역으로 제한되며 국제적으로 전화할 수 없습니다. 즉, 동일한 짧은 코드가 여러 지역에 존재할 수 있으며, 같은 국가 통화 코드 (예: 미국과 캐나다)를 공유하더라도 사용량과 가격이 다를 수 있습니다.
입력란 | |
---|---|
region_code |
필수 항목입니다. 이 짧은 코드를 호출할 수 있는 위치의 BCP-47 지역 코드입니다(예: 'US' 및 'BB'). 참조: - http://www.unicode.org/reports/tr35/#unicode_region_subtag |
number |
필수 항목입니다. 선행 더하기('+') 또는 국가 전화 코드가 없는 짧은 코드 숫자(예: '611')입니다. |
PostalAddress
우편 배달 주소 또는 수취인 주소와 같은 우편 주소를 나타냅니다. 우편 주소가 주어지면 우편 서비스는 사업장, 사서함 또는 이와 유사한 장소로 물품을 배송할 수 있습니다. 도로, 마을, 산 등 지리적 위치를 모델링하기 위한 것이 아닙니다.
일반적으로 주소는 프로세스 유형에 따라 사용자 입력을 통해 또는 기존 데이터 가져오기를 통해 만들어집니다.
주소 입력 / 수정에 관한 조언: - https://github.com/google/libaddressinput과 같이 국제화가 가능한 주소 위젯 사용) - 해당 입력란이 사용되는 국가 이외의 국가에서는 입력란을 입력하거나 수정할 수 있는 UI 요소가 사용자에게 표시되어서는 안 됩니다.
이 스키마를 사용하는 방법에 관한 자세한 내용은 https://support.google.com/business/answer/6397478을 참고하세요.
입력란 | |
---|---|
revision |
모든 새 버전은 이전 버전과 호환되어야 합니다. |
region_code |
필수 항목입니다. 주소의 국가/지역의 CLDR 지역 코드입니다. 이는 추론되지 않으며 값이 올바른지 확인하는 것은 사용자의 몫입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 스위스의 경우 'CH'. |
language_code |
선택사항입니다. 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (아는 경우). 대개 입력 양식의 UI 언어이거나 주소의 국가/지역에서 사용되는 언어 중 하나 또는 음역된 언어와 일치해야 합니다. 이는 특정 국가에서 형식 지정에 영향을 줄 수 있지만 데이터의 정확성에 중요하지는 않으며 유효성 검사 또는 기타 형식 지정 이외의 관련 작업에는 영향을 미치지 않습니다. 이 값을 알 수 없는 경우, 잘못될 가능성이 있는 기본값을 지정하는 대신 이 값을 생략해야 합니다. 예: 'zh-Hant', 'ja', 'ja-Latn', 'en'. |
postal_code |
선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 표시해야 하는 것은 아니지만, 우편번호가 사용되는 지역에서는 주소의 다른 부분에 대한 추가 유효성 검사 (예: 미국의 주/우편번호 유효성 검사)가 트리거될 수 있습니다. |
sorting_code |
선택사항입니다. 국가별 추가 정렬 코드입니다. 대부분의 리전에서 사용되지 않습니다. 사용되는 경우 값은 'CEDEX'와 같이 선택적으로 뒤에 숫자가 오는 문자열 (예: 'CEDEX 7')이거나 '섹터 코드' (자메이카), '배송 구역 표시기' (말라위) 또는 '우체국 표시기' (예: 코트디부아르)를 나타내는 숫자만 사용할 수 있습니다. |
administrative_area |
선택사항입니다. 국가 또는 지역의 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 주, 도, 주 또는 현일 수 있습니다. 특히 스페인의 경우 이 지역은 자치지구가 아닌 주입니다 (예: '카탈로니아'가 아닌 '바르셀로나'). 많은 국가에서는 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 필드를 채우지 않은 상태로 두어야 합니다. |
locality |
선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, IT 코뮤, 영국 우체국 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워 두고 address_lines를 사용합니다. |
sublocality |
선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 구역이 될 수 있습니다. |
address_lines[] |
주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다. address_lines의 값에는 형식 정보가 없으며 경우에 따라 단일 필드에 여러 값이 포함될 수 있으므로 (예: 'Austin, TX') 행 순서가 명확해야 합니다. 주소 입력란 순서는 주소의 국가/지역에 해당하는 '봉투 순서'여야 합니다. 이것이 다를 수 있는 곳 (예: 일본)에서는 address_language를 사용하여 명시적으로 지정합니다 (예: 큰 단위에서 작은 단위 순서는 'ja', 작은 단위에서 큰 단위 순서는 'ja-Latn' 또는 'en'). 이렇게 하면 언어에 따라 가장 구체적인 주소 행을 선택할 수 있습니다. 주소에 허용되는 최소 구조 표현은 나머지 모든 정보가 address_lines에 배치된 region_code로 구성됩니다. 지오코딩을 사용하지 않고도 이러한 주소의 형식을 대략적으로 지정할 수는 있지만, 최소한 부분적으로만 해결될 때까지는 주소 구성 요소에 대해 의미론적 추론을 할 수 없습니다. (주소에서 지역 또는 행정 구역에 해당하는 부분을 추측하는 대신) region_code와 address_lines만 포함된 주소를 만든 다음 지오코딩을 사용하여 완전히 구조화되지 않은 주소를 처리하는 것이 좋습니다. |
recipients[] |
선택사항입니다. 주소의 수신자입니다. 경우에 따라 이 필드에 여러 줄의 정보가 포함될 수 있습니다. 예를 들어 '전교' 정보가 포함될 수 있습니다. |
organization |
선택사항입니다. 주소에 있는 조직의 이름입니다. |
TimeOfDay
하루 중 특정 시간을 나타냅니다. 날짜와 시간대가 중요하지 않거나 아무 곳으로 지정됩니다. API는 윤초를 허용하도록 선택할 수 있습니다. 관련된 유형은 google.type.Date
및 google.protobuf.Timestamp
입니다.
입력란 | |
---|---|
hours |
24시간 형식의 시간입니다. 0~23 사이의 값이어야 합니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다. |
minutes |
특정 시간의 분입니다. 0~59 사이의 값이어야 합니다. |
seconds |
특정 분의 초입니다. 일반적으로 0~59 사이의 값이어야 합니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다. |
nanos |
나노초 단위의 초수입니다. 0~999,999,999 사이의 값이어야 합니다. |
TimeZone
IANA 시간대 데이터베이스에서 가져온 시간대를 나타냅니다.
입력란 | |
---|---|
id |
IANA 시간대 데이터베이스의 시간대입니다(예: 'America/New_York'). |
version |
선택사항입니다. IANA 시간대 데이터베이스의 버전 번호입니다(예: '2019a'). |