Package google.type

Индекс

Дата

Представляет полную или частичную календарную дату, например день рождения. Время суток и часовой пояс либо указаны в другом месте, либо не имеют значения. Дата указана по григорианскому календарю. Это может представлять собой одно из следующих действий:

  • Полная дата с ненулевыми значениями года, месяца и дня.
  • Месяц и день с нулевым годом (например, годовщина).
  • Год сам по себе, с нулевым месяцем и нулевым днем.
  • Год и месяц с нулевым днем ​​(например, дата истечения срока действия кредитной карты).

Связанные типы:

Поля
year

int32

Год даты. Должно быть от 1 до 9999 или 0, чтобы указать дату без года.

month

int32

Месяц года. Должно быть от 1 до 12 или 0, чтобы указать год без месяца и дня.

day

int32

День месяца. Должно быть от 1 до 31 и действительно для года и месяца, или 0, чтобы указать год отдельно или год и месяц, если день не имеет значения.

День недели

Представляет день недели.

Перечисления
DAY_OF_WEEK_UNSPECIFIED День недели не указан.
MONDAY Понедельник
TUESDAY Вторник
WEDNESDAY Среда
THURSDAY Четверг
FRIDAY Пятница
SATURDAY Суббота
SUNDAY Воскресенье

Интервал

Представляет временной интервал, закодированный как начало отметки времени (включительно) и время окончания отметки времени (не включая).

Начало должно быть меньше или равно концу. Когда начало равно концу, интервал пуст (не соответствует времени). Если начало и конец не указаны, интервал соответствует любому времени.

Поля
start_time

Timestamp

Необязательный. Инклюзивное начало интервала.

Если указано, временная метка, соответствующая этому интервалу, должна быть такой же или после начала.

end_time

Timestamp

Необязательный. Эксклюзивное завершение антракта.

Если указано, временная метка, соответствующая этому интервалу, должна быть перед концом.

Номер телефона

Объект, представляющий номер телефона, подходящий в качестве формата API-интерфейса.

Это представление:

  • не следует использовать для языкового форматирования номера телефона, например «+1 (650) 253-0000 доб. 123».

  • не предназначен для эффективного хранения

  • может не подходить для набора номера - для этого следует использовать специализированные библиотеки (см. ссылки) для анализа номера

Чтобы сделать что-то значимое с этим номером, например отформатировать его для различных вариантов использования, сначала преобразуйте его в объект i18n.phonenumbers.PhoneNumber .

Например, в Java это будет:

com.google.type.PhoneNumberwireProto = 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

Расширение номера телефона. Расширение не стандартизировано в рекомендациях ITU, за исключением того, что оно определяется как серия чисел с максимальной длиной 40 цифр. Помимо цифр, здесь могут храниться и некоторые другие символы набора, такие как «,» (обозначающие ожидание) или «#».

Обратите внимание, что ни в одном регионе в настоящее время не используются расширения с короткими кодами, поэтому это поле обычно задается только вместе с номером E.164. Он хранится отдельно от номера E.164, чтобы обеспечить возможность расширения короткого кода в будущем.

Союз поле kind . Необходимый. Либо обычный номер, либо короткий код. В будущем к приведенному ниже полю могут быть добавлены новые поля, поэтому клиентам следует игнорировать номера телефонов, для которых не установлено ни одно из полей, для которых они закодировали. kind может быть только одним из следующих:
e164_number

string

Номер телефона, представленный в виде ведущего знака плюса («+»), за которым следует номер телефона в упрощенном формате ITU E.164, состоящий из телефонного кода страны (от 1 до 3 цифр) и номера абонента, без каких-либо дополнительных пробелы или форматирование, например: - правильно: «+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

Короткий код.

Ссылка(и): - https://en.wikipedia.org/wiki/Short_code .

Короткий код

Объект, представляющий короткий код, который представляет собой телефонный номер, который обычно намного короче обычных телефонных номеров и может использоваться для адресации сообщений в системах MMS и SMS, а также для сокращенного набора номера (например, «Отправьте сообщение 611, чтобы узнать, сколько минут у вас осталось в плане.»).

Сокращенные коды ограничены регионом и не могут быть набраны на международном уровне. Это означает, что один и тот же короткий код может существовать в разных регионах с разным использованием и ценами, даже если в этих регионах используется один и тот же код страны (например, США и Калифорния).

Поля
region_code

string

Необходимый. Код региона BCP-47 места, где можно совершать вызовы на этот короткий код, например «US» и «BB».

Ссылки: - http://www.unicode.org/reports/tr35/#unicode_region_subtag

number

string

Необходимый. Цифры короткого кода без начального плюса («+») или кода страны, например «611».

Почтовый адрес

Представляет почтовый адрес, например, для адресов почтовой доставки или платежей. Учитывая почтовый адрес, почтовая служба может доставлять товары в помещение, почтовый ящик или другое место. Он не предназначен для моделирования географических мест (дорог, городов, гор).

Обычно адрес создается посредством пользовательского ввода или путем импорта существующих данных, в зависимости от типа процесса.

Советы по вводу/редактированию адреса: – Используйте готовый к интернационализации виджет адреса, например https://github.com/google/libaddressinput . – Пользователям не должны предоставляться элементы пользовательского интерфейса для ввода или редактирования полей за пределами стран, где это поле есть. использовал.

Дополнительные инструкции по использованию этой схемы см. на странице 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 содержимого этого адреса (если известен). Часто это язык пользовательского интерфейса формы ввода или ожидается, что он будет соответствовать одному из языков, используемых в стране/регионе адреса, или их транслитерированным эквивалентам. Это может повлиять на форматирование в некоторых странах, но не критично для правильности данных и никогда не повлияет на проверку или другие операции, не связанные с форматированием.

Если это значение неизвестно, его следует опустить (вместо указания возможно неправильного значения по умолчанию).

Примеры: «ж-Хант», «джа», «джа-Латн», «эн».

postal_code

string

Необязательный. Почтовый индекс адреса. Не все страны используют или требуют наличия почтовых индексов, но там, где они используются, они могут вызвать дополнительную проверку других частей адреса (например, проверка штата/почтового индекса в США).

sorting_code

string

Необязательный. Дополнительный код сортировки для конкретной страны. В большинстве регионов это не используется. Там, где оно используется, значение представляет собой либо строку типа «CEDEX», за которой необязательно следует число (например, «CEDEX 7»), либо просто число, представляющее «код сектора» (Ямайка), «указатель зоны доставки». (Малави) или «индикатор почтового отделения» (например, Кот-д'Ивуар).

administrative_area

string

Необязательный. Высшее административное подразделение, используемое для почтовых адресов страны или региона. Например, это может быть штат, провинция, область или префектура. В частности, для Испании это провинция, а не автономное сообщество (например, «Барселона», а не «Каталония»). Многие страны не используют административную зону в почтовых адресах. Например, в Швейцарии это место следует оставить незаселенным.

locality

string

Необязательный. Обычно относится к части адреса, посвященной городу. Примеры: город в США, ИТ-коммуна, почтовый город Великобритании. В регионах мира, где населенные пункты не определены четко или не вписываются в эту структуру, оставьте locality пустым и используйте адрес_строки.

sublocality

string

Необязательный. Сублокальность адреса. Например, это могут быть микрорайоны, районы, районы.

address_lines[]

string

Неструктурированные адресные строки, описывающие нижние уровни адреса.

Поскольку значения в адресных строках не содержат информации о типе и иногда могут содержать несколько значений в одном поле (например, «Остин, Техас»), важно, чтобы порядок строк был ясен. Порядок адресных строк должен быть «порядком конверта» для страны/региона адреса. В местах, где это может отличаться (например, в Японии), адрес_языка используется для явного указания (например, «ja» для упорядочения от большого к меньшему и «ja-Latn» или «en» для упорядочения от малого к большому). Таким образом, в зависимости от языка можно выбрать наиболее конкретную строку адреса.

Минимально допустимое структурное представление адреса состоит из региона_кода, а вся остальная информация размещена в адресных_строках. Можно было бы очень приблизительно отформатировать такой адрес без геокодирования, но никакие семантические рассуждения не могли быть сделаны ни о каком из компонентов адреса, пока он не был хотя бы частично решен.

Создание адреса, содержащего только код_региона и строки_адреса, а затем геокодирование — рекомендуемый способ обработки полностью неструктурированных адресов (в отличие от угадывания, какие части адреса должны быть населенными пунктами или административными областями).

recipients[]

string

Необязательный. Получатель по адресу. Это поле может при определенных обстоятельствах содержать многострочную информацию. Например, он может содержать информацию об уходе.

organization

string

Необязательный. Название организации по адресу.

ВремяДня

Обозначает время суток. Дата и часовой пояс либо не имеют значения, либо указаны в другом месте. 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.

Часовой пояс

Представляет часовой пояс из базы данных часовых поясов IANA .

Поля
id

string

Часовой пояс IANA Часовой пояс базы данных, например «Америка/Нью_Йорк».

version

string

Необязательный. Номер версии базы данных часовых поясов IANA, например «2019a».