Indeks
Date
(pesan)DayOfWeek
(enum)Interval
(pesan)PhoneNumber
(pesan)PhoneNumber.ShortCode
(pesan)PostalAddress
(pesan)TimeOfDay
(pesan)TimeZone
(pesan)
Tanggal
Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu telah ditentukan di tempat lain atau tidak signifikan. Tanggal ini relatif terhadap Kalender Gregorian. ID ini dapat mewakili salah satu dari hal berikut:
- Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
- Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
- Tahun saja, dengan bulan nol dan hari nol.
- Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).
Jenis terkait:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Kolom | |
---|---|
year |
Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun. |
month |
Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari. |
day |
Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan. |
DayOfWeek
Merepresentasikan hari.
Enum | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
Hari tidak ditentukan. |
MONDAY |
Senin |
TUESDAY |
Selasa |
WEDNESDAY |
Rabu |
THURSDAY |
Kamis |
FRIDAY |
Jumat |
SATURDAY |
Sabtu |
SUNDAY |
Minggu |
Interval
Mewakili interval waktu, yang dienkode sebagai Awal stempel waktu (inklusif) dan akhir Stempel waktu (eksklusif).
Awalnya harus lebih kecil dari atau sama dengan akhir. Jika awal sama dengan akhir, interval akan kosong (tidak cocok dengan waktu). Jika awal dan akhir tidak ditentukan, intervalnya akan cocok kapan saja.
Kolom | |
---|---|
start_time |
Opsional. Awal interval yang inklusif. Jika ditentukan, Stempel waktu yang cocok dengan interval ini harus sama atau setelah dimulai. |
end_time |
Opsional. Akhir eksklusif interval. Jika ditentukan, Stempel waktu yang cocok dengan interval ini harus sebelum akhir. |
PhoneNumber
Objek yang mewakili nomor telepon, cocok sebagai format kabel API.
Representasi ini:
tidak boleh digunakan untuk pemformatan khusus lokal nomor telepon, seperti "+1 (650) 253-0000 ext. 123"
tidak dirancang untuk penyimpanan yang efisien
- mungkin tidak cocok untuk panggilan - perpustakaan khusus (lihat referensi) harus digunakan untuk menguraikan nomor untuk tujuan itu
Untuk melakukan sesuatu yang bermakna dengan nomor ini, seperti memformatnya untuk berbagai kasus penggunaan, konversikan nomor tersebut menjadi objek i18n.phonenumbers.PhoneNumber
terlebih dahulu.
Misalnya, dalam Java ini adalah:
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()); }
Referensi: - https://github.com/google/libphonenumber
Kolom | |
---|---|
extension |
Ekstensi nomor telepon. Perluasan ini tidak distandardisasi dalam rekomendasi ITU, kecuali untuk didefinisikan sebagai serangkaian angka dengan panjang maksimum 40 digit. Selain angka, beberapa karakter panggilan lainnya seperti ',' (yang menunjukkan waktu tunggu) atau '#' dapat disimpan di sini. Perhatikan bahwa saat ini tidak ada wilayah yang menggunakan ekstensi dengan kode pendek, sehingga bidang ini biasanya hanya ditetapkan bersama dengan nomor E.164. Nomor ini disimpan terpisah dari nomor E.164 untuk memungkinkan ekstensi kode singkat di masa mendatang. |
Kolom union kind . Wajib. Bisa berupa angka biasa, atau kode singkat. Kolom baru dapat ditambahkan ke salah satu kolom di bawah ini di masa mendatang, jadi klien harus mengabaikan nomor telepon yang tidak menetapkan kolom yang sesuai dengan kodenya. kind hanya ada berupa salah satu diantara berikut: |
|
e164_number |
Nomor telepon, diwakili sebagai tanda plus utama ('+'), diikuti dengan nomor telepon yang menggunakan format santai ITU E.164 yang terdiri dari kode telepon negara (1 hingga 3 digit) dan nomor pelanggan, tanpa spasi atau format tambahan, misalnya: - benar: "+15552220123" - salah: "+1 (555) 222-01234 x123". Format ITU E.164 membatasi yang terakhir hingga 12 digit, tetapi dalam praktiknya tidak semua negara menghormatinya, jadi kami melonggarkan pembatasan itu di sini. Nomor khusus nasional tidak diizinkan. Referensi: - 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 |
Kode singkat. Referensi: - https://en.wikipedia.org/wiki/Short_code |
ShortCode
Objek yang mewakili kode pendek, yaitu nomor telepon yang biasanya jauh lebih pendek daripada nomor telepon biasa dan dapat digunakan untuk menyampaikan pesan melalui sistem MMS dan SMS, serta untuk panggilan singkat (misalnya, "Text 611 untuk melihat sisa waktu rencana Anda.").
Kode singkat dibatasi untuk suatu wilayah dan tidak dapat dihubungi secara internasional, yang berarti kode singkat yang sama dapat tersedia di wilayah yang berbeda, dengan penggunaan dan harga yang berbeda, meskipun wilayah tersebut memiliki kode panggilan negara yang sama (misalnya AS dan Kanada).
Kolom | |
---|---|
region_code |
Wajib. Kode wilayah BCP-47 lokasi tempat panggilan ke kode singkat ini dapat dilakukan, seperti "US" dan "BB". Referensi: - http://www.unicode.org/reports/tr35/#unicode_region_subtag |
number |
Wajib. Digit kode pendek, tanpa awalan plus ('+') atau kode panggilan negara, misalnya "611". |
PostalAddress
Merepresentasikan alamat pos, mis. untuk pengiriman pos atau alamat pembayaran. Dengan mempertimbangkan alamat pos, layanan pos dapat mengirimkan item ke lokasi, P.O. Box, atau yang serupa. Hal ini tidak dimaksudkan untuk membuat model lokasi geografis (jalan, kota, gunung).
Dalam penggunaan umum, alamat akan dibuat melalui input pengguna atau dari mengimpor data yang ada, tergantung pada jenis prosesnya.
Saran tentang input / pengeditan alamat: - Gunakan widget alamat yang mendukung internasionalisasi seperti https://github.com/google/libaddressinput) - Pengguna tidak boleh diberi elemen UI untuk memasukkan atau mengedit kolom di luar negara tempat kolom tersebut digunakan.
Untuk panduan selengkapnya tentang cara menggunakan skema ini, lihat: https://support.google.com/business/answer/6397478
Kolom | |
---|---|
revision |
Revisi skema Semua revisi baru harus kompatibel dengan revisi lama. |
region_code |
Wajib. Kode wilayah CLDR negara/wilayah alamat. Hal ini tidak pernah disimpulkan dan bergantung pada pengguna untuk memastikan nilainya benar. Lihat https://cldr.unicode.org/ dan https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk detailnya. Contoh: "CH" untuk Swiss. |
language_code |
Opsional. Kode bahasa BCP-47 konten alamat ini (jika diketahui). Ini sering kali merupakan bahasa UI formulir input atau diharapkan sesuai dengan salah satu bahasa yang digunakan di negara/wilayah alamat, atau padanannya dalam transliterasi. Hal ini dapat memengaruhi pemformatan di negara tertentu, tetapi tidak penting bagi keakuratan data dan tidak akan memengaruhi validasi atau operasi terkait non-pemformatan lainnya. Jika nilai ini tidak diketahui, sebaiknya dihilangkan (bukan menentukan default yang mungkin salah). Contoh: "zh-Hant", "ja", "ja-Latn", "en". |
postal_code |
Opsional. Kode pos alamat. Tidak semua negara menggunakan atau mewajibkan keberadaan kode pos, tetapi jika kode pos digunakan, kode pos tersebut dapat memicu validasi tambahan dengan bagian alamat lainnya (misalnya, validasi negara bagian/kode pos di Amerika Serikat). |
sorting_code |
Opsional. Kode pengurutan tambahan khusus negara. Ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilai dapat berupa string seperti "CEDEX", secara opsional diikuti dengan angka (mis. "CEDEX 7"), atau hanya angka saja, yang mewakili "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi), atau "indikator kantor pos" (mis. Côte d'Ivoire). |
administrative_area |
Opsional. Subdivisi administratif tertinggi yang digunakan untuk alamat pos suatu negara atau wilayah. Misalnya, ini dapat berupa negara bagian, provinsi, oblast, atau prefektur. Khususnya, untuk Spanyol, ini adalah provinsi dan bukan komunitas otonom (misalnya "Barcelona" dan bukan "Catalonia"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Misalnya, di Swiss, kolom ini harus dibiarkan tidak terisi. |
locality |
Opsional. Secara umum mengacu pada bagian kota dari alamat tersebut. Contoh: US city, IT comune, UK post city. Di wilayah di dunia dengan lokalitas tidak didefinisikan dengan baik atau tidak cocok dengan struktur ini, kosongkan lokalitas dan gunakan address_lines. |
sublocality |
Opsional. Sublokalitas alamat. Misalnya, ini dapat berupa kawasan, kota besar, distrik. |
address_lines[] |
Baris alamat tidak terstruktur yang menggambarkan tingkat alamat yang lebih rendah. Karena nilai dalam address_lines tidak memiliki informasi jenis dan terkadang dapat berisi beberapa nilai dalam satu kolom (misalnya "Austin, TX"), urutan barisnya harus jelas. Urutan baris alamat harus berupa "urutan amplop" untuk negara/wilayah alamat. Di tempat yang dapat bervariasi (misalnya, Jepang), address_language digunakan untuk membuatnya eksplisit (misalnya, "ja" untuk pengurutan besar-ke-kecil dan "ja-Latn" atau "en" untuk kecil-ke-besar). Dengan cara ini, baris alamat yang paling spesifik dapat dipilih berdasarkan bahasa. Representasi struktural minimum yang diizinkan dari sebuah alamat terdiri dari region_code dengan semua informasi yang tersisa yang ditempatkan di address_lines. Anda dapat memformat alamat seperti itu secara kira-kira tanpa geocoding, tetapi tidak ada alasan semantik yang dapat dibuat untuk setiap komponen alamat hingga setidaknya sebagian di-resolve. Membuat alamat yang hanya berisi region_code dan address_lines, dan kemudian geocoding adalah cara yang direkomendasikan untuk menangani alamat yang benar-benar tidak terstruktur (daripada menebak bagian alamat mana yang harus berupa lokalitas atau wilayah administratif). |
recipients[] |
Opsional. Penerima di alamat. Dalam keadaan tertentu, kolom ini dapat berisi informasi multibaris. Misalnya, mungkin ada informasi "mengurus". |
organization |
Opsional. Nama organisasi di alamat. |
TimeOfDay
Mewakili waktu. Tanggal dan zona waktu tidak signifikan atau ditentukan di tempat lain. API dapat memilih untuk memungkinkan detik kabisat. Jenis terkait adalah google.type.Date
dan google.protobuf.Timestamp
.
Kolom | |
---|---|
hours |
Jam dalam format 24 jam. Harus dari 0 hingga 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti waktu tutup bisnis. |
minutes |
Menit dalam jam. Harus dari 0 hingga 59. |
seconds |
Detik dalam waktu. Biasanya harus dari 0 hingga 59. API dapat mengizinkan nilai 60 jika memungkinkan lompatan-detik. |
nanos |
Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999. |
TimeZone
Merepresentasikan zona waktu dari Database Zona Waktu IANA.
Kolom | |
---|---|
id |
Zona waktu Database Zona Waktu IANA, misalnya "America/New_York". |
version |
Opsional. Nomor versi Database Zona Waktu IANA, misalnya, "2019a". |