Package google.type

Dizin

Tarih

Doğum günü gibi takvim tarihlerinin tamamını veya bir kısmını temsil eder. Saat ve saat dilimi başka bir yerde belirtilmiş veya önemsizdir. Tarih, Gregoryen takvimine göredir. Bu durum aşağıdakilerden birini gösterebilir:

  • Sıfır olmayan yıl, ay ve gün değerleri içeren tam tarih.
  • Sıfır yılı olan bir ay ve gün (ör. yıldönümü).
  • Ay ve gün bilgisi olmayan bir yıl.
  • Sıfır gün içeren bir yıl ve ay (ör. kredi kartının son kullanma tarihi).

İlgili türler:

Alanlar
year

int32

Tarihin yılı. 1 ile 9999 arasında veya yıl olmadan tarih belirtmek için 0 olmalıdır.
month

int32

Yılın ayı. 1 ile 12 arasında veya ay ve gün olmadan bir yıl belirtmek için 0 olmalıdır.
day

int32

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. 0 değerini kullanarak da yıl veya gününün önemli olmadığı bir yıl ve ay belirtebilirsiniz.

HaftanınGünü

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 ona eşit olmalıdır. Başlangıç bitişe eşit olduğunda aralık boş olur (hiçbir zamanla eşleşmez). Hem başlangıç hem de bitiş belirtilmediğinde aralık herhangi bir zamanla eşleşir.

Alanlar
start_time

Timestamp

İsteğe bağlıdır. Aranın dahili başlangıcı.

Belirtilmişse bu aralıkla eşleşen bir Zaman Damgası'nın başlangıçla aynı veya başlangıçtan sonra olması gerekir.
end_time

Timestamp

İsteğe bağlıdır. Aranın bitiş zamanı (girilen tarihler dahil değil).

Belirtilirse bu aralıkla eşleşen bir zaman damgasının bitişten önce olması gerekir.

Telefon Numarası

API kablo biçimi olarak uygun olan, telefon numarasını temsil eden bir nesne.

Bu beyan:

  • "+1 (650) 253-0000 dahili 123" gibi bir telefon numarasının yerel ayara özgü biçimlendirilmesi için kullanılmamalıdır.

  • Verimli depolama için tasarlanmamıştır.

  • numara çevirme için uygun olmayabilir. Bu amaçla numarayı ayrıştırmak için özel kitaplıklar (referanslara bakın) kullanılmalıdır.

Bu sayıyla anlamlı bir işlem yapmak (ör. çeşitli kullanım alanları için biçimlendirmek) için önce 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

string

Telefon numarasının uzantısı. Uzatma, maksimum 40 basamaklı bir sayı dizisi olarak tanımlanması dışında ITU önerilerinde standartlaştırılmamıştır. Burada, rakamlar dışında "," (bekleme) veya "#" gibi bazı numara çevirme karakterleri de saklanabilir.

Şu anda hiçbir bölgenin kısa kod içeren uzantılar kullanmadığını unutmayın. Bu nedenle, bu alan normalde yalnızca bir E.164 numarasıyla birlikte ayarlanır. Gelecekte kısa kod uzantılarına izin vermek için E.164 numarasından ayrı tutulur.
Birlik alanı kind. Zorunlu. Normal bir numara veya kısa kod. Gelecekte aşağıdaki oneof alanına yeni alanlar eklenebilir. Bu nedenle, istemciler kodladıkları alanların hiçbirinin ayarlanmadığı telefon numaralarını yoksaymalıdır. kind yalnızca aşağıdakilerden biri olabilir:
e164_number

string

Başında artı işareti ("+") bulunan telefon numarası, ardından ülke arama kodu (1 ila 3 haneli) ve abone numarasından oluşan, ek boşluk veya biçimlendirme içermeyen, rahat bir ITU E.164 biçimi kullanan telefon numarası. Örneğin: - doğru: "+15552220123" - yanlış: "+1 (555) 222-01234 x123".

ITU E.164 biçiminde ülke kodu 12 haneli olarak sınırlandırılmıştır ancak uygulamada tüm ülkeler bu sınırlamaya uymadığından burada bu kısıtlamayı gevşettik. Yalnızca ülke içi numaralara izin verilmez.

Kaynaklar: - 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

Kısa kod.

Referanslar: - https://en.wikipedia.org/wiki/Short_code

ShortCode

Kısa kodları temsil eden bir nesne. Kısa kod, genellikle normal telefon numaralarından çok daha kısa olan ve MMS ile SMS sistemlerindeki mesajları adreslemek için kullanılabilen bir telefon numarasıdır. Ayrıca kısa kod, kısa numarayla arama yapmak için de kullanılabilir (ör. "Planınızda kalan dakika sayısını öğrenmek için 611'e kısa mesaj gönderin.").

Kısa kodlar bir bölgeyle sınırlıdır ve uluslararası olarak aranamaz. Bu, aynı kısa kodun farklı bölgelerde, aynı ülke arama kodunu (ör. ABD ve Kanada) paylaşsalar bile farklı kullanım ve fiyatlandırmayla mevcut olabileceği anlamına gelir.

Alanlar
region_code

string

Zorunlu. Bu kısa koda arama yapılabilen konumun BCP-47 bölge kodu ("US" ve "BB" gibi).

Referanslar: - http://www.unicode.org/reports/tr35/#unicode_region_subtag
number

string

Zorunlu. Başında artı ("+") veya ülke arama kodu olmadan kısa kod basamakları. Örneğin, "611".

PostalAddress

Posta adresini temsil eder. Örneğin, posta teslimatı veya ödeme adresleri için. Posta hizmetleri, posta adresi verilen bir tesise, posta kutusuna veya benzeri bir yere ürün teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemek için tasarlanmamıştır.

Normal kullanımda, adresler işlem türüne bağlı olarak kullanıcı girişi veya mevcut verilerin içe aktarılmasıyla oluşturulur.

Adres girişi / düzenlemeyle ilgili öneriler: - https://github.com/google/libaddressinput gibi uluslararası kullanıma hazır bir adres widget'ı kullanın. - Kullanıcılara, ilgili alanın kullanıldığı ülkeler dışındaki alanların girişi veya düzenlenmesi için kullanıcı arayüzü öğeleri sunulmamalıdır.

Bu şemanın nasıl kullanılacağıyla ilgili daha fazla bilgi için https://support.google.com/business/answer/6397478 adresini ziyaret edin.

Alanlar
revision

int32

PostalAddress öğesinin şema düzeltmesi. Bu değer, en son düzeltme olan 0 olarak ayarlanmalıdır.

Tüm yeni düzeltmeler, eski düzeltmelerle geriye dönük uyumlu olmalıdır.
region_code

string

Zorunlu. Adresin bulunduğu ülke/bölgenin CLDR bölge kodu. Bu durum hiçbir zaman çıkarılmaz ve değerin doğru olduğundan emin olmak kullanıcıya bağlıdır. Ayrıntılar için https://cldr.unicode.org/ ve https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html adresine bakın. Örnek: İsviçre için "CH".
language_code

string

İsteğe bağlıdır. 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 veya bunların transkript eşdeğerleriyle eşleşmesi beklenir. Bu durum, belirli ülkelerdeki biçimlendirmeyi etkileyebilir ancak verilerin doğruluğu açısından kritik değildir ve hiçbir zaman doğrulama işlemlerini veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez.

Bu değer bilinmiyorsa yanlış olabilecek bir varsayılan değer belirtmek yerine atlanmalıdır.

Örnekler: "zh-Hant", "ja", "ja-Latn", "en".
postal_code

string

İsteğe bağlıdır. Adresin posta kodu. Posta kodları her ülkede kullanılmaz veya zorunlu tutulmaz ancak kullanıldıkları yerlerde adresin diğer bölümleriyle birlikte ek doğrulama tetiklenebilir (ör. ABD'de eyalet/posta kodu doğrulaması).
sorting_code

string

İsteğe bağlıdır. Ülkeye özgü ek sıralama kodu. Bu, çoğu bölgede kullanılmaz. Kullanıldığı yerlerde değer, "CEDEX" gibi bir dizedir ve isteğe bağlı olarak bir sayı (ör. "CEDEX 7") ekler veya "sektör kodu"nu (Jamaika), "teslimat bölgesi göstergesini" (Malavi) ya da "posta ofisi göstergesini" (ör. Fildişi Sahili) temsil eden tek bir sayıdır.
administrative_area

string

İsteğe bağlıdır. Bir ülke veya bölgenin posta adresleri için kullanılan en yüksek idari alt birim. Örneğin, bu bir eyalet, il, oblast veya idari bölge olabilir. İspanya'da bu, özerk topluluk değil ildir (örneğin, "Katalonya" değil "Barselona"). Birçok ülkede posta adreslerinde idari bölge kullanılmaz. Örneğin İsviçre'de bu alan doldurulmamalıdır.
locality

string

İsteğe bağlıdır. Genellikle adresin şehir/kasaba kısmını ifade eder. Örnekler: ABD'de şehir, İtalya'da komün, Birleşik Krallık'ta posta bölgesi. Yerelliklerin iyi tanımlanmadığı veya bu yapıya iyi uymadığı dünyanın bölgelerinde locality alanını boş bırakın ve address_lines alanını kullanın.
sublocality

string

İsteğe bağlıdır. Adresin alt mahallesi. Örneğin, mahalleler, semtler, ilçeler bu kapsamdadır.
address_lines[]

string

Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları.

address_lines alanındaki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden fazla değer içerebildiğinden (ör. "Austin, TX"), satır sırasının net olması önemlidir. Adres satırlarının sırası, adresin bulunduğu ülke/bölge için "zarf sırası" olmalıdır. Bunun değişebileceği yerlerde (ör. Japonya), address_language özelliği açıkça belirtmek için kullanılır (ör. büyükten küçüğe sıralama için "ja" ve küçükten büyüğe sıralama için "ja-Latn" veya "en"). Bu sayede, bir adresin en spesifik satırı dile göre seçilebilir.

Bir adrese izin verilen minimum yapısal temsil, geri kalan tüm bilgilerin address_lines alanına yerleştirildiği bir region_code alanından oluşur. Bu tür bir adres, coğrafi kodlama olmadan çok yaklaşık olarak biçimlendirilebilir ancak en azından kısmen çözülene kadar adres bileşenlerinin hiçbiri hakkında anlamsal bir çıkarım yapılamaz.

Tamamen yapılandırılmamış adresleri işlemek için önerilen yöntem, yalnızca region_code ve address_lines içeren bir adres oluşturmak ve ardından coğrafi kodlama yapmaktır (adresin hangi bölümlerinin yerel yönetim bölgeleri veya idari bölgeler olması gerektiğini tahmin etmek yerine).
recipients[]

string

İsteğe bağlıdır. Adresteki alıcı. Bu alan, belirli durumlarda çok satırlık bilgiler içerebilir. Örneğin, "teslim edilecek kişi" bilgilerini içerebilir.
organization

string

İsteğe bağlıdır. Adresteki kuruluşun adı.

TimeOfDay

Günün bir saatini temsil eder. Tarih ve saat dilimi önemli değil veya başka bir yerde belirtilmiş. Bir API, saniye atlamalarına izin vermeyi seçebilir. İlgili türler google.type.Date ve google.protobuf.Timestamp'dur.

Alanlar
hours

int32

Bir günün 24 saatlik biçimindeki saatleri. 0'dan büyük veya 0'a eşit ve genellikle 23'ten küçük veya 23'e eşit olmalıdır. Bir API, işletmenin kapanma zamanı gibi senaryolar için "24:00:00" değerine izin vermeyi seçebilir.
minutes

int32

Bir saatin dakikaları. 0'dan büyük veya 0'a eşit ve 59'dan küçük olmalıdır.
seconds

int32

Bir dakikanın saniyeleri. 0'dan büyük veya 0'a eşit ve genellikle 59'dan küçük veya 59'a eşit olmalıdır. Bir API, saniye atlamalarına izin veriyorsa 60 değerine izin verebilir.
nanos

int32

Nanosaniye cinsinden saniye kesirlerini belirtir. 0'dan büyük veya 0'a eşit ve 999.999.999'dan küçük veya buna eşit olmalıdır.

TimeZone

IANA Saat Dilimi Veritabanı'ndaki bir saat dilimini temsil eder.

Alanlar
id

string

IANA Saat Dilimi Veritabanı saat dilimi. Örneğin, "Amerika/New_York".
version

string

İsteğe bağlıdır. IANA Saat Dilimi Veritabanı sürüm numarası. Örneğin, "2019a".