Package google.type

Chỉ mục

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không quan trọng. Ngày này có liên quan đến Lịch Gregorian. Giá trị này có thể biểu thị một trong những nội dung sau:

  • Một ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, với năm bằng 0 (ví dụ: ngày kỷ niệm).
  • Chỉ riêng giá trị năm, với giá trị tháng và ngày bằng 0.
  • Năm và tháng, với ngày bằng 0 (ví dụ: ngày hết hạn thẻ tín dụng).

Các loại có liên quan:

Trường
year

int32

Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.
month

int32

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc bằng 0 để chỉ định một năm không có tháng và ngày.
day

int32

Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong năm và tháng, hoặc bằng 0 để chỉ định giá trị năm, hoặc một năm và tháng, trong đó ngày là không quan trọng.

DayOfWeek

Đại diện cho một ngày trong tuần.

Enum
DAY_OF_WEEK_UNSPECIFIED Ngày trong tuần không được chỉ định.
MONDAY Thứ Hai
TUESDAY Tuesday (thứ Ba)
WEDNESDAY Wednesday (thứ Tư)
THURSDAY Thursday (thứ Năm)
FRIDAY Friday (thứ Sáu)
SATURDAY Saturday (thứ Bảy)
SUNDAY Chủ Nhật

Khoảng thời gian

Biểu thị một khoảng thời gian, được mã hoá dưới dạng Dấu thời gian bắt đầu (bao gồm) và Dấu thời gian kết thúc (không bao gồm).

Điểm bắt đầu phải nhỏ hơn hoặc bằng điểm kết thúc. Khi thời gian bắt đầu bằng thời gian kết thúc, khoảng thời gian sẽ trống (không khớp với thời gian nào). Khi cả thời gian bắt đầu và kết thúc đều không được chỉ định, khoảng thời gian sẽ khớp với bất kỳ thời gian nào.

Trường
start_time

Timestamp

Không bắt buộc. Bắt đầu khoảng thời gian bao gồm cả giá trị đầu và giá trị cuối.

Nếu được chỉ định, Dấu thời gian khớp với khoảng thời gian này phải giống hoặc sau thời điểm bắt đầu.
end_time

Timestamp

Không bắt buộc. Kết thúc khoảng thời gian, không bao gồm giá trị đầu và giá trị cuối.

Nếu được chỉ định, Dấu thời gian khớp với khoảng thời gian này phải nằm trước thời điểm kết thúc.

PhoneNumber

Một đối tượng đại diện cho số điện thoại, phù hợp với định dạng đường truyền API.

Biểu thị này:

  • không được dùng để định dạng số điện thoại theo từng ngôn ngữ, chẳng hạn như "+1 (650) 253-0000 ext. 123"

  • không được thiết kế để lưu trữ hiệu quả

  • có thể không phù hợp để quay số – bạn nên sử dụng các thư viện chuyên biệt (xem tài liệu tham khảo) để phân tích cú pháp số cho mục đích đó

Để làm việc gì đó có ý nghĩa với số này, chẳng hạn như định dạng số này cho nhiều trường hợp sử dụng, trước tiên, hãy chuyển đổi số này thành đối tượng i18n.phonenumbers.PhoneNumber.

Ví dụ: trong Java, mã này sẽ là:

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());
}

(Các) tài liệu tham khảo: – https://github.com/google/libphonenumber

Trường
extension

string

Số phụ của số điện thoại. Tiện ích này không được chuẩn hoá trong các đề xuất của ITU, ngoại trừ việc được xác định là một chuỗi số có độ dài tối đa là 40 chữ số. Ngoài các chữ số, một số ký tự quay số khác như "," (cho biết đang chờ) hoặc "#" có thể được lưu trữ tại đây.

Xin lưu ý rằng không có khu vực nào hiện sử dụng đuôi có mã ngắn, vì vậy, trường này thường chỉ được đặt cùng với số E.164. Mã này được lưu giữ riêng biệt với số E.164 để cho phép mở rộng mã ngắn trong tương lai.
Trường hợp hợp nhất kind. Bắt buộc. Số điện thoại thông thường hoặc mã ngắn. Các trường mới có thể được thêm vào oneof bên dưới trong tương lai, vì vậy, ứng dụng nên bỏ qua những số điện thoại mà không có trường nào được mã hoá theo số điện thoại đó. kind chỉ có thể là một trong những giá trị sau:
e164_number

string

Số điện thoại, được biểu thị bằng dấu cộng ở đầu ('+'), theo sau là số điện thoại sử dụng định dạng ITU E.164 không quá nghiêm ngặt, bao gồm mã vùng của quốc gia (từ 1 đến 3 chữ số) và số thuê bao, không có dấu cách hoặc định dạng bổ sung. Ví dụ: – đúng: "+15552220123" – sai: "+1 (555) 222-01234 x123".

Định dạng E.164 của ITU giới hạn số điện thoại ở mức 12 chữ số, nhưng trên thực tế, không phải quốc gia nào cũng tuân thủ quy định đó. Vì vậy, chúng tôi sẽ nới lỏng quy định hạn chế đó tại đây. Không được dùng số chỉ dành cho quốc gia.

Tài liệu tham khảo: – 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

Một mã ngắn.

(Các) tài liệu tham khảo: – https://en.wikipedia.org/wiki/Short_code

ShortCode

Một đối tượng đại diện cho mã ngắn, là một số điện thoại thường ngắn hơn nhiều so với số điện thoại thông thường và có thể được dùng để gửi tin nhắn trong hệ thống MMS và SMS, cũng như để quay số rút gọn (Ví dụ: "Nhắn tin đến 611 để xem bạn còn bao nhiêu phút trong gói cước").

Mã ngắn chỉ được dùng ở một khu vực và không thể gọi được trên phạm vi quốc tế. Điều này có nghĩa là cùng một mã ngắn có thể tồn tại ở nhiều khu vực, với mức sử dụng và giá khác nhau, ngay cả khi các khu vực đó có cùng mã gọi quốc gia (ví dụ: Hoa Kỳ và Canada).

Trường
region_code

string

Bắt buộc. Mã vùng BCP-47 của vị trí có thể thực hiện cuộc gọi đến mã rút gọn này, chẳng hạn như "US" và "BB".

(Các) tài liệu tham khảo: – http://www.unicode.org/reports/tr35/#unicode_region_subtag
number

string

Bắt buộc. Các chữ số của mã ngắn, không có dấu cộng ở đầu ("+") hoặc mã gọi quốc gia. Ví dụ: "611".

PostalAddress (Địa chỉ bưu điện)

Biểu thị địa chỉ bưu chính. Ví dụ: địa chỉ giao hàng qua đường bưu chính hoặc địa chỉ thanh toán. Khi có địa chỉ bưu chính, dịch vụ bưu chính có thể giao hàng đến một cơ sở, hộp thư bưu điện hoặc địa chỉ tương tự. Mô hình này không dùng để lập mô hình vị trí địa lý (đường, thị trấn, núi).

Trong trường hợp sử dụng thông thường, địa chỉ sẽ được tạo bằng dữ liệu do người dùng nhập hoặc từ việc nhập dữ liệu hiện có, tuỳ thuộc vào loại quy trình.

Lời khuyên về cách nhập / chỉnh sửa địa chỉ: – Sử dụng tiện ích địa chỉ sẵn sàng cho quốc tế hoá, chẳng hạn như https://github.com/google/libaddressinput) – Người dùng không được thấy các thành phần trên giao diện người dùng để nhập hoặc chỉnh sửa các trường bên ngoài quốc gia sử dụng trường đó.

Để biết thêm hướng dẫn về cách sử dụng giản đồ này, hãy xem: https://support.google.com/business/answer/6397478

Trường
revision

int32

Bản sửa đổi giản đồ của PostalAddress. Bạn phải đặt giá trị này thành 0, tức là bản sửa đổi mới nhất.

Tất cả bản sửa đổi mới phải tương thích ngược với các bản sửa đổi cũ.
region_code

string

Bắt buộc. Mã vùng CLDR của quốc gia/khu vực của địa chỉ. Giá trị này không bao giờ được suy luận và người dùng phải đảm bảo giá trị này là chính xác. Hãy xem https://cldr.unicode.org/ và https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html để biết thông tin chi tiết. Ví dụ: "CH" cho Thuỵ Sĩ.
language_code

string

Không bắt buộc. Mã ngôn ngữ BCP-47 của nội dung trong địa chỉ này (nếu có). Đây thường là ngôn ngữ giao diện người dùng của biểu mẫu nhập hoặc dự kiến sẽ khớp với một trong các ngôn ngữ được sử dụng ở quốc gia/khu vực của địa chỉ hoặc các ngôn ngữ tương đương được chuyển tự. Điều này có thể ảnh hưởng đến định dạng ở một số quốc gia nhất định, nhưng không ảnh hưởng đến độ chính xác của dữ liệu và sẽ không bao giờ ảnh hưởng đến bất kỳ hoạt động xác thực hoặc hoạt động nào khác không liên quan đến định dạng.

Nếu không xác định được giá trị này, bạn nên bỏ qua giá trị này (thay vì chỉ định giá trị mặc định có thể không chính xác).

Ví dụ: "zh-Hant", "ja", "ja-Latn", "en".
postal_code

string

Không bắt buộc. Mã bưu chính của địa chỉ. Không phải quốc gia nào cũng sử dụng hoặc yêu cầu phải có mã bưu chính, nhưng ở những quốc gia sử dụng mã bưu chính, mã này có thể kích hoạt quy trình xác thực bổ sung với các phần khác của địa chỉ (ví dụ: xác thực tiểu bang/mã zip ở Hoa Kỳ).
sorting_code

string

Không bắt buộc. Mã sắp xếp bổ sung, dành riêng cho quốc gia. Mã này không được sử dụng ở hầu hết các khu vực. Khi được sử dụng, giá trị này là một chuỗi như "CEDEX", theo sau có thể là một số (ví dụ: "CEDEX 7") hoặc chỉ là một số, đại diện cho "mã ngành" (Jamaica), "chỉ báo khu vực phân phối" (Malawi) hoặc "chỉ báo bưu điện" (ví dụ: Bờ Biển Ngà).
administrative_area

string

Không bắt buộc. Phân khu hành chính cao nhất dùng cho địa chỉ bưu chính của một quốc gia hoặc khu vực. Ví dụ: tiểu bang, tỉnh, oblast hoặc tỉnh. Cụ thể, đối với Tây Ban Nha, đây là tỉnh chứ không phải cộng đồng tự trị (ví dụ: "Barcelona" chứ không phải "Catalonia"). Nhiều quốc gia không sử dụng khu vực hành chính trong địa chỉ bưu chính. Ví dụ: ở Thuỵ Sĩ, bạn không nên điền thông tin này.
locality

string

Không bắt buộc. Thường đề cập đến phần thành phố/thị trấn của địa chỉ. Ví dụ: thành phố ở Hoa Kỳ, comune ở Ý, thị trấn bưu chính ở Vương quốc Anh. Ở những khu vực trên thế giới mà địa phương không được xác định rõ ràng hoặc không phù hợp với cấu trúc này, hãy để trống địa phương và sử dụng address_lines.
sublocality

string

Không bắt buộc. Khu vực phụ của địa chỉ. Ví dụ: khu dân cư, quận, huyện.
address_lines[]

string

Dòng địa chỉ không có cấu trúc mô tả các cấp thấp hơn của địa chỉ.

Vì các giá trị trong address_lines không có thông tin về loại và đôi khi có thể chứa nhiều giá trị trong một trường (ví dụ: "Austin, TX"), nên bạn cần phải sắp xếp thứ tự dòng một cách rõ ràng. Thứ tự của các dòng địa chỉ phải là "thứ tự phong bì" đối với quốc gia/khu vực của địa chỉ. Ở những nơi có thể khác nhau (ví dụ: Nhật Bản), address_language được dùng để làm rõ (ví dụ: "ja" để sắp xếp từ lớn đến nhỏ và "ja-Latn" hoặc "en" để sắp xếp từ nhỏ đến lớn). Bằng cách này, bạn có thể chọn dòng cụ thể nhất của địa chỉ dựa trên ngôn ngữ.

Biểu thị cấu trúc tối thiểu được phép của một địa chỉ bao gồm region_code với tất cả thông tin còn lại được đặt trong address_lines. Bạn có thể định dạng một địa chỉ như vậy một cách gần đúng mà không cần mã hoá địa lý, nhưng không thể đưa ra lý do ngữ nghĩa về bất kỳ thành phần địa chỉ nào cho đến khi địa chỉ đó được giải quyết ít nhất một phần.

Bạn nên tạo một địa chỉ chỉ chứa region_code và address_lines, sau đó mã hoá địa lý để xử lý các địa chỉ hoàn toàn không có cấu trúc (thay vì đoán xem phần nào của địa chỉ là địa phương hoặc khu vực hành chính).
recipients[]

string

Không bắt buộc. Người nhận tại địa chỉ. Trong một số trường hợp, trường này có thể chứa thông tin nhiều dòng. Ví dụ: thông tin này có thể chứa thông tin "người nhận thay mặt".
organization

string

Không bắt buộc. Tên của tổ chức tại địa chỉ đó.

TimeOfDay

Biểu thị thời gian trong ngày. Ngày và múi giờ không quan trọng hoặc được chỉ định ở nơi khác. API có thể chọn cho phép giây nhuận. Các loại liên quan là google.type.Date và google.protobuf.Timestamp.

Trường
hours

int32

Số giờ trong ngày theo định dạng 24 giờ. Phải lớn hơn hoặc bằng 0 và thường phải nhỏ hơn hoặc bằng 23. API có thể chọn cho phép giá trị "24:00:00" cho các tình huống như thời gian đóng cửa doanh nghiệp.
minutes

int32

Số phút trong một giờ. Phải lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 59.
seconds

int32

Số giây trong một phút. Phải lớn hơn hoặc bằng 0 và thường phải nhỏ hơn hoặc bằng 59. API có thể cho phép giá trị 60 nếu cho phép giây nhuận.
nanos

int32

Phân số giây, tính bằng nano giây. Phải lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 999.999.999.

TimeZone

Biểu thị một múi giờ trong Cơ sở dữ liệu múi giờ IANA.

Trường
id

string

Múi giờ của Cơ sở dữ liệu múi giờ IANA. Ví dụ: "America/New_York".
version

string

Không bắt buộc. Số phiên bản Cơ sở dữ liệu múi giờ IANA. Ví dụ: "2019a".