Index
Date
(Meldung)DayOfWeek
(Aufzählung)Interval
(Meldung)PhoneNumber
(Meldung)PhoneNumber.ShortCode
(Meldung)PostalAddress
(Meldung)TimeOfDay
(Meldung)TimeZone
(Meldung)
Datum
Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Tageszeit und Zeitzone werden entweder an anderer Stelle angegeben oder sind unbedeutend. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes darstellen:
- Ein vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null.
- Ein Monat und ein Tag mit einem Jahr von 0 (z. B. ein Jahrestag).
- Ein Jahr für sich alleine, mit einem Monat und einem Tag von null.
- Ein Jahr und ein Monat mit 0 Tag (z. B. dem Ablaufdatum einer Kreditkarte).
Ähnliche Typen:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Felder | |
---|---|
year |
Jahr des Datums. Muss zwischen 1 und 9999 liegen oder 0, um ein Datum ohne Jahr anzugeben. |
month |
Monat eines Jahres. Muss zwischen 1 und 12 liegen oder 0, um ein Jahr ohne Monat und Tag anzugeben. |
day |
Tag im Monat. Muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein, oder 0, um ein Jahr allein oder ein Jahr und Monat anzugeben, bei dem der Tag nicht von Bedeutung ist. |
DayOfWeek
Steht für einen Wochentag.
Enums | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
Der Wochentag ist nicht angegeben. |
MONDAY |
Montag |
TUESDAY |
Dienstag |
WEDNESDAY |
Mittwoch |
THURSDAY |
Donnerstag |
FRIDAY |
Freitag |
SATURDAY |
Samstag |
SUNDAY |
Sonntag |
Intervall
Stellt ein Zeitintervall dar, das als Zeitstempelstart (einschließlich) und als Zeitstempelende (ausschließlich) codiert ist.
Der Beginn muss kleiner oder gleich dem Ende sein. Wenn der Startwert mit dem Ende übereinstimmt, ist das Intervall leer (entspricht keiner Zeit). Wenn sowohl Start als auch Ende nicht angegeben sind, entspricht das Intervall einer beliebigen Zeit.
Felder | |
---|---|
start_time |
Optional. Inklusiver Start des Intervalls. Wenn angegeben, muss ein Zeitstempel, der mit diesem Intervall übereinstimmt, mit dem Start übereinstimmen oder danach liegen. |
end_time |
Optional. Exklusives Ende des Intervalls. Wenn angegeben, muss ein Zeitstempel, der mit diesem Intervall übereinstimmt, vor dem Ende liegen. |
PhoneNumber
Ein Objekt, das eine Telefonnummer darstellt, das sich als API-Übermittlungsformat eignet.
Diese Darstellung:
sollte nicht für die sprachspezifische Formatierung einer Telefonnummer verwendet werden, z. B. "+1 (650) 253-0000 Durchwahl 123".
nicht auf effiziente Speicherung ausgelegt ist.
- Möglicherweise nicht für Anrufe geeignet – zum Parsen der Nummer sollten spezialisierte Bibliotheken (siehe Referenzen) verwendet werden
Wenn Sie diese Zahl sinnvoll nutzen möchten und sie beispielsweise für verschiedene Anwendungsfälle formatieren möchten, müssen Sie sie zuerst in ein i18n.phonenumbers.PhoneNumber
-Objekt konvertieren.
In Java wäre das beispielsweise:
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()); }
Referenz(en): – https://github.com/google/libphonenumber
Felder | |
---|---|
extension |
Durchwahl der Telefonnummer Die Erweiterung ist in den ITU-Empfehlungen nicht standardisiert, mit der Ausnahme, dass sie als Zahlenreihe mit maximal 40 Ziffern definiert ist. Neben Ziffern können hier einige andere Wählzeichen, wie „,“ (Wartezeit) oder „#“, gespeichert werden. Erweiterungen mit Kurzcodes werden derzeit in keiner Region verwendet. Dieses Feld wird daher normalerweise nur in Verbindung mit einer E.164-Nummer festgelegt. Sie wird getrennt von der E.164-Nummer gespeichert, um in Zukunft Kurzcode-Erweiterungen zu ermöglichen. |
Union-Feld kind . Erforderlich. Entweder eine normale Nummer oder ein Kurzcode. Zu einem der unten stehenden Elemente können in Zukunft neue Felder hinzugefügt werden. Kunden sollten daher Telefonnummern ignorieren, für die keines der Felder, für die sie codiert sind, festgelegt ist. Für kind ist nur einer der folgenden Werte zulässig: |
|
e164_number |
Die Telefonnummer, dargestellt als führendes Pluszeichen ('+'), gefolgt von einer Telefonnummer im ITU E.164-Format, die aus der Landesvorwahl (ein bis drei Ziffern) und der Nummer des Abonnenten ohne zusätzliche Leerzeichen oder Formatierungen besteht, z.B.: - richtig: "+15552220123" - Falsch: "+1 (555) 222-01234 x123". Das ITU E.164-Format beschränkt letztere auf 12 Ziffern, aber in der Praxis respektieren nicht alle Länder dies, daher lockern wir diese Beschränkung an dieser Stelle. Rein nationale Nummern sind nicht zulässig. Quellen: – 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 |
Ein Kurzcode. Referenz(en): – https://en.wikipedia.org/wiki/Short_code |
ShortCode
Ein Objekt, das eine Kurzwahl darstellt.Dabei handelt es sich um eine Telefonnummer, die normalerweise viel kürzer als normale Telefonnummern ist und zum Adressieren von Nachrichten in MMS- und SMS-Systemen sowie für abgekürzte Anrufe verwendet werden kann (z. B. „SMS 611 senden, um zu sehen, wie viele Minuten Ihr Tarif noch übrig ist“).
Kurzcodes sind auf eine Region beschränkt und nicht international erreichbar. Das bedeutet, dass dieselbe Kurzwahl in verschiedenen Regionen mit unterschiedlicher Nutzung und unterschiedlichen Preisen existieren kann, auch wenn diese Regionen denselben Ländercode haben (z. B. USA und Kanada).
Felder | |
---|---|
region_code |
Erforderlich. Der BCP-47-Regionscode des Standorts, an dem Anrufe an diesen Kurzcode getätigt werden können, z. B. „US“ oder „BB“. Referenz(en): – http://www.unicode.org/reports/tr35/#unicode_region_subtag |
number |
Erforderlich. Die Kurzcode-Ziffern ohne vorangestelltes Pluszeichen ('+') oder Landesvorwahl, z.B. "611". |
PostalAddress
Stellt eine Postadresse dar, z. B. für Postzustellungs- oder Zahlungsadressen. Mit einer Postadresse kann ein Postdienst Artikel an eine Einrichtung, ein Postfach oder eine andere Adresse liefern. Sie stellt kein Modell eines geografischen Standorts (Straßen, Städte, Berge) dar.
Normalerweise wird eine Adresse je nach Prozesstyp durch eine Nutzereingabe oder den Import vorhandener Daten erstellt.
Hinweise zur Eingabe / Bearbeitung von Adressen: – Verwenden Sie ein für die Internationalisierung geeignetes Widget, z. B. https://github.com/google/libaddressinput. Nutzern sollten außerhalb der Länder, in denen dieses Feld verwendet wird, keine UI-Elemente zur Eingabe oder Bearbeitung von Feldern angezeigt werden.
Weitere Informationen zur Verwendung dieses Schemas finden Sie unter https://support.google.com/business/answer/6397478.
Felder | |
---|---|
revision |
Die Schemaversion von Alle neuen Überarbeitungen müssen abwärtskompatibel zu alten Überarbeitungen sein. |
region_code |
Erforderlich. CLDR-Regionscode des Landes bzw. der Region der Adresse. Er wird nie abgeleitet. Der Nutzer muss sicherstellen, dass der Wert richtig ist. Weitere Informationen finden Sie unter https://cldr.unicode.org/ und https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Beispiel: "CH" für die Schweiz. |
language_code |
Optional. BCP-47-Sprachencode des Inhalts dieser Adresse, falls bekannt. Dies ist oft die Sprache der UI des Eingabeformulars oder die Sprache, die mit einer der verwendeten Sprachen des Landes bzw. der Region mit der Adresse oder der entsprechenden Transliteration übereinstimmt. In bestimmten Ländern hat dies Auswirkungen auf die Formatierung. Es ist jedoch nicht entscheidend für die Richtigkeit der Daten und hat niemals Auswirkungen auf Validierungen oder andere nicht formatierungsbezogene Vorgänge. Wenn dieser Wert nicht bekannt ist, sollte er weggelassen werden. Das ist besser, als einen möglicherweise falschen Wert anzugeben. Beispiele: "zh-Hant", "ja", "ja-Latn", "en" |
postal_code |
Optional. Postleitzahl der Adresse. Postleitzahlen werden nicht in allen Ländern verwendet oder benötigt. Dort, wo sie verwendet werden, können sie weitere Validierungsvorgänge für andere Adressteile nach sich ziehen, z. B. die Validierung von Bundesstaat/Postleitzahl in den USA. |
sorting_code |
Optional. Zusätzlicher länderspezifischer Sortiercode. Dieser wird nur für wenige Regionen genutzt. Wenn er verwendet wird, ist der Wert entweder ein String wie "CEDEX", optional gefolgt von einer Ziffer (z. B. "CEDEX 7"), oder nur eine Ziffer für den Sektorcode (Jamaika), den Zustellbereichsindikator (Malawi) oder den Postamtindikator (z. B. Elfenbeinküste). |
administrative_area |
Optional. Höchste administrative Untergliederung, die für Postadressen eines Landes oder einer Region verwendet wird. Dies kann beispielsweise ein Bundesland, eine Provinz, eine Oblast oder eine Präfektur sein. In Spanien ist dies beispielsweise die Provinz und nicht das autonome Gebiet, also z. B. "Barcelona" und nicht "Katalonien". In vielen Ländern werden in der Postadresse keine Verwaltungsgebiete verwendet. Für die Schweiz etwa sollte dieses Feld leer gelassen werden. |
locality |
Optional. Bezieht sich in der Regel auf die Stadt-/Ortsangabe der Adresse. Beispiele: Stadt in den USA, italienische Gemeinde, Post Town in Großbritannien. Lassen Sie in Regionen der Welt, in denen Lokalitäten nicht hinreichend definiert sind oder nicht dieser Struktur entsprechen, diese Angabe leer und verwenden Sie stattdessen "address_Lines". |
sublocality |
Optional. Unterlokalität der Adresse. Dies können beispielsweise Stadtviertel, Stadtteile und Bezirke sein. |
address_lines[] |
Unstrukturierte Adresszeilen, mit denen die unteren Ebenen einer Adresse beschrieben werden. Da die Werte in Adresszeilen keine Typinformationen beinhalten und manchmal mehrere Werte in einem einzigen Feld enthalten sind, z. B. "Austin, TX", muss die Zeilenreihenfolge deutlich erkennbar sein. Die Reihenfolge der Adresszeilen sollte der Adresse auf einem Briefumschlag für das Land bzw. die Region entsprechen. An Orten, an denen es keine einheitliche Reihenfolge gibt, z. B. in Japan, wird "address_language" verwendet, um dies klar zu machen (z. B. "ja" für die Reihenfolge groß zu klein und "ja-Latn" oder "en" für die Reihenfolge klein zu groß). Auf diese Weise kann die spezifischste Zeile einer Adresse sprachabhängig ausgewählt werden. Die Mindestangabe für eine zulässige strukturierte Darstellung einer Adresse besteht aus einem "region_code" und allen verbleibenden Informationen in "address_lines". Eine solche Adresse kann weitgehend angenähert ohne Geocodierung formatiert werden. Es wäre jedoch erst dann eine semantische Argumentation zu einer der Adresskomponenten möglich, wenn diese zumindest teilweise aufgelöst wird. Es empfiehlt sich, für vollständig unstrukturierte Adressen eine Adresse mit einem "region_Code" und "adress_Lines" zu erstellen und danach eine Geocodierung dafür durchzuführen. So muss nicht geraten werden, welche Teile der Adresse Orte oder administrative Gebiete darstellen. |
recipients[] |
Optional. Der Empfänger an der Adresse. Dieses Feld kann in bestimmten Fällen mehrere Zeilen lange Informationen enthalten. Beispielsweise kann es Informationen der Art "wohnhaft bei" enthalten. |
organization |
Optional. Der Name der Organisation an der Adresse. |
TimeOfDay
Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date
und google.protobuf.Timestamp
.
Felder | |
---|---|
hours |
Stunden im 24-Stunden-Format. Sollte zwischen 0 und 23 liegen. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen. |
minutes |
Minuten der Zeitangabe. Muss zwischen 0 und 59 liegen. |
seconds |
Sekunden der Zeitangabe. Muss normalerweise zwischen 0 und 59 liegen. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt. |
nanos |
Sekundenbruchteile in Nanosekunden. Muss zwischen 0 und 999.999.999 liegen. |
TimeZone
Stellt eine Zeitzone aus der IANA-Zeitzonendatenbank dar.
Felder | |
---|---|
id |
Zeitzone aus der IANA-Zeitzonendatenbank, z. B. "Amerika/New_York". |
version |
Optional. Versionsnummer der IANA-Zeitzonendatenbank, z. B. "2019a". |