Dizin
Date
(message)DayOfWeek
(enum)Interval
(message)PhoneNumber
(message)PhoneNumber.ShortCode
(message)PostalAddress
(message)TimeOfDay
(message)TimeZone
(message)
Tarih
Takvimin tamamını veya bir kısmını temsil eder (ör. doğum günü). Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:
- Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
- Sıfır yıllı bir ay ve gün (örneğin, bir yıl dönümü).
- Tek başına bir yıl, sıfır ay ve sıfır gün.
- Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartı son kullanma tarihi).
İlgili türler:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Alanlar | |
---|---|
year |
Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarihi belirtmek için 0 arasında olmalıdır. |
month |
Bir yılın ayı. 1 ile 12 arasında veya ay ve gün içermeyen bir yılı belirtmek için 0 arasında olmalıdır. |
day |
Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Yalnızca yılı belirtmek için 0 değerini veya günün önemli olmadığı bir yılı ve ayı belirtmek için 0 değerini girin. |
DayOfWeek
Haftanın bir gününü temsil eder.
Sıralamalar | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
Haftanın günü belirtilmemiş. |
MONDAY |
Pazartesi |
TUESDAY |
Salı |
WEDNESDAY |
Çarşamba |
THURSDAY |
Perşembe |
FRIDAY |
Cuma |
SATURDAY |
Cumartesi |
SUNDAY |
Pazar |
Aralık
Zaman damgası başlangıcı (dahil) ve Zaman damgası sonu (hariç) olarak kodlanmış bir zaman aralığını temsil eder.
Başlangıç, bitişten küçük veya bitişe eşit olmalıdır. Başlangıç, bitişle aynı olduğunda aralık boş olur (zaman ile eşleşmez). Hem başlangıç hem de bitiş belirtilmemişse aralık herhangi bir zamanla eşleşir.
Alanlar | |
---|---|
start_time |
İsteğe bağlı. Aralığın kapsayıcı başlangıcı. Belirtilirse bu aralıkla eşleşen bir zaman damgasının başlangıçla aynı veya başlangıçtan sonra olması gerekir. |
end_time |
İsteğe bağlı. Aralığın özel bitişi. Belirtilirse bu aralıkla eşleşen bir zaman damgasının sonundan önce olması gerekir. |
PhoneNumber
Telefon numarasını temsil eden ve API kablo biçimine uygun bir nesne.
Bu temsil:
bir telefon numarasının yerel ayara özel biçimlendirmesi için (ör. "+1 (650) 253-0000 dahili: 123" gibi) kullanılmamalıdır.
verimli depolama için tasarlanmamıştır
- Arama için uygun olmayabilir; numarayı bu amaçla ayrıştırmak için özel kitaplıklar (referanslara bakın) kullanılmalıdır
Bu sayıyla anlamlı bir işlem yapmak (örneğin, çeşitli kullanım alanlarında biçimlendirmek) için bu sayıyı önce bir i18n.phonenumbers.PhoneNumber
nesnesine dönüştürün.
Örneğin, Java'da bu şöyle olur:
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()); }
Referanslar: - https://github.com/google/libphonenumber
Alanlar | |
---|---|
extension |
Telefon numarasının uzantısı. Maksimum 40 haneli bir sayı dizisi olarak tanımlananlar haricinde bu uzantı, ITU önerilerinde standartlaştırılmamıştır. Rakamlar dışında, "," (beklemeyi belirten) veya "#" gibi diğer karakter karakterleri de burada depolanabilir. Şu anda hiçbir bölgede kısa kod içeren uzantılar kullanılmadığından, bu alanın normalde yalnızca E.164 numarasıyla birlikte ayarlandığını unutmayın. Bu numara, gelecekte kısa kod uzantılarına olanak tanımak için E.164 numarasından ayrı olarak tutulur. |
Birleştirme alanı kind . Zorunlu. Normal bir sayı veya kısa bir kod. Gelecekte aşağıdaki alanlara yeni alanlar eklenebilir. Bu nedenle, müşteriler, kodlanan alanlardan hiçbirinin ayarlanmadığı telefon numaralarını yoksaymalıdır. kind şunlardan yalnızca biri olabilir: |
|
e164_number |
Başında artı işareti ('+') bulunan, hemen ardından ülke arama kodu (1 ila 3 haneli) ve abone numarasından oluşan rahat bir ITU E.164 biçimi kullanılan, boşluk ya da biçimlendirme içermeyen bir telefon numarasıdır.Ör.: - doğru: "+15552220123" - yanlış: "+1 (555) 222-01234 x123". ITU E.164 biçiminde ikinci değer 12 basamakla sınırlandırılmıştır. Ancak pratikte tüm ülkeler buna saygı göstermemektedir. Dolayısıyla, burada kısıtlamayı gevşetiyoruz. Yalnızca ulusal numaralara izin verilmez. Referanslar: - 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 |
Kısa bir kod. Referanslar: - https://en.wikipedia.org/wiki/Short_code |
ShortCode
Kısa kodu temsil eden bir nesne.Bu, genellikle normal telefon numaralarından çok daha kısa olan ve MMS ile SMS sistemlerindeki mesajları yanıtlamak için ve kısaltılmış arama işlemlerinde kullanılabilir (ör. "Planınızda kaç dakikanız kaldığını öğrenmek için 611'e mesaj gönderin.").
Kısa kodlar bölgeyle sınırlıdır ve uluslararası olarak aranabilir değildir.Diğer bir deyişle, aynı ülke arama kodunu (ör. US ve CA) paylaşsa bile aynı kısa kod farklı bölgelerde, farklı kullanım ve fiyatlandırmayla bulunabilir.
Alanlar | |
---|---|
region_code |
Zorunlu. Bu kısa koda çağrılabilecek konumun BCP-47 bölge kodu (ör. "US" ve "BB"). Referanslar: - http://www.unicode.org/reports/tr35/#unicode_region_subtag |
number |
Zorunlu. Başında artı ('+) işareti veya ülke arama kodu olmayan, ör. "611" gibi kısa kod rakamları. |
PostalAddress
Bir posta adresini (ör. posta teslimatı veya ödeme adresleri için) temsil eder. Bir posta hizmeti, posta adresi verildiğinde bir yere, posta kutusuna veya benzer bir yere ürün teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemesi amaçlanmamıştır.
Normal kullanımda adres, işlemin türüne bağlı olarak kullanıcı girişi aracılığıyla ya da mevcut verilerin içe aktarılmasıyla oluşturulur.
Adres girişi / düzenleme ile ilgili öneri: - https://github.com/google/libaddressinput gibi uluslararası kullanıma hazır bir adres widget'ı kullanın) - Kullanıcılara, alanın kullanıldığı ülkeler dışındaki alanların girilmesi veya düzenlenmesi için kullanıcı arayüzü öğeleri sunulmamalıdır.
Bu şemanın nasıl kullanılacağıyla ilgili daha fazla yardım için lütfen bkz: https://support.google.com/business/answer/6397478
Alanlar | |
---|---|
revision |
Tüm yeni düzeltmeler eski düzeltmelerle geriye dönük olarak uyumlu olmalıdır. |
region_code |
Zorunlu. Adresin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Bu durum hiçbir zaman tahmin edilmez ve değerin doğru olup olmadığını kontrol etmek kullanıcıya bağlıdır. Ayrıntılı bilgi için https://cldr.unicode.org/ ve https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html inceleyin. Örnek: İsviçre için "CH". |
language_code |
İsteğe bağlı. Bu adresin içeriğinin BCP-47 dil kodu (biliniyorsa). Bu genellikle giriş formunun kullanıcı arayüzü dilidir veya adresin ülkesinde/bölgesinde kullanılan dillerden biriyle ya da harf çevirisi yapılmış eşdeğerleriyle eşleşmesi beklenir. Bu, belirli ülkelerde biçimlendirmeyi etkileyebilir ancak verilerin doğruluğu açısından kritik öneme sahip değildir ve hiçbir zaman doğrulamayı veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez. Bu değer bilinmiyorsa yanlış olabilecek bir varsayılan belirtmek yerine belirtilmemelidir. Örnekler: "zh-Hant", "ja", "ja-Latn", "en". |
postal_code |
İsteğe bağlı. Adresin posta kodu. Bazı ülkeler posta kodlarını kullanmaz veya gerekli kılmaz, ancak kullanıldıkları yerde adresin diğer kısımlarında ek doğrulama (ör. ABD'de eyalet/posta kodu doğrulaması) tetiklenebilir. |
sorting_code |
İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu ad çoğu bölgede kullanılmaz. Kullanıldığı durumlarda değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya yalnızca "sektör kodu" (Jamaika), "teslimat bölgesi göstergesi" (Malavi) veya "postane göstergesi"ni (ör. Fildişi Sahili) temsil eden tek bir sayıdır. |
administrative_area |
İsteğe bağlı. Bir ülke veya bölgenin posta adresleri için kullanılan en yüksek idari alt bölüm. Örneğin bu bir eyalet, il, oblast veya vilayet olabilir. Özellikle, İspanya için bu, özerk topluluk değil, ildir (örneğin, "Katalonya" değil "Barselona"). Birçok ülke, posta adreslerinde idari bölge kullanmaz. Ör. İsviçre'de bu alan doldurulmamalıdır. |
locality |
İsteğe bağlı. Genellikle adresin şehir/ilçe bölümünü ifade eder. Örnekler: ABD şehri, BT komünü, Birleşik Krallık posta şehri. Dünyada konumların iyi tanımlanmadığı veya bu yapıya pek uygun olmadığı bölgelerde, konum alanını boş bırakın ve address_lines kullanın. |
sublocality |
İsteğe bağlı. Adresin alt konumu. Örneğin; mahalle, kaza, ilçe olabilir. |
address_lines[] |
Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları. address_lines içindeki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden çok değer (ör. "Austin, TX") içerebileceğinden satır sırasının açık olması önemlidir. Adres satırlarının sırası, adresin ülkesi/bölgesi için "zarf siparişi" olmalıdır. Bu özelliğin değişebileceği yerlerde (ör. Japonya), açık hale getirmek için address_language kullanılır (ör. büyükten küçüğe sıralama için "ja", küçükten büyüğe sıralama için "ja-Latn" ya da "en"). Bu şekilde, bir adresin en spesifik satırı dile göre seçilebilir. Bir adresin izin verilen minimum yapısal gösterimi, geri kalan tüm bilgilerin adres_satırları içine yerleştirildiği bir region_code [bölge_kodu] değerinden oluşur. Böyle bir adres, coğrafi kodlama olmadan yaklaşık olarak yaklaşık olarak biçimlendirilebilir ancak en azından kısmen çözümlenene kadar hiçbir adres bileşeni hakkında anlamsal çıkarımda bulunulamaz. Yalnızca bölge_kodu ve adres_satırları içeren bir adres oluşturduktan sonra coğrafi kodlama, tamamen yapılandırılmamış adresleri yönetmek için önerilen yöntemdir (adresin hangi bölümlerinin yerel bölgeler veya idari alanlar olması gerektiğini tahmin etmek yerine). |
recipients[] |
İsteğe bağlı. Adresteki alıcı. Bu alan, belirli durumlarda çok satırlı bilgiler içerebilir. Örneğin, "bakım" bilgileri içerebilir. |
organization |
İsteğe bağlı. Adresteki kuruluşun adı. |
TimeOfDay
Günün saatini temsil eder. Tarih ve saat dilimi önemli değil veya başka bir yerde belirtilmiş. Bir API, artık saniyeye izin vermeyi seçebilir. İlgili türler: google.type.Date
ve google.protobuf.Timestamp
.
Alanlar | |
---|---|
hours |
24 saat biçiminde günün saatleri. 0 ile 23 arasında olmalıdır. API, işletmenin kapanış saati gibi senaryolarda "24:00:00" değerine izin vermeyi seçebilir. |
minutes |
Günün saatindeki dakikalar. 0 ile 59 arasında olmalıdır. |
seconds |
Saniye cinsinden dakika. Normalde 0 ile 59 arasında olmalıdır. Bir API, artık saniyeye izin veriyorsa 60 değerine izin verebilir. |
nanos |
Nanosaniye cinsinden saniyenin kesirleri. 0 ile 999.999.999 arasında olmalıdır. |
TimeZone
IANA Saat Dilimi Veritabanı'ndan bir saat dilimini temsil eder.
Alanlar | |
---|---|
id |
IANA Saat Dilimi Veritabanı saat dilimi, ör. "America/New_York". |
version |
İsteğe bağlı. IANA Saat Dilimi Veritabanı sürüm numarası, ör. "2019a". |