- JSON-Darstellung
- ActionPlatform
- ActionLinkType
- OrderOnlineMetadata
- FulfillmentOption
- FulfillmentType
- AvailableDay
- Datum
- FeeDetails
- NoFee
- MinimumFee
- FixedFee
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount
- Geld
- MoneyRange
- QuantitativeValue
- RangeValue
- DurationRange
- AdvanceOrderDetails
- EventMetadata
- Oberfläche
Eine Aktions-URL mit zugehöriger Sprache, Liste der Länder, auf die sie eingeschränkt ist, und optionaler Plattform, die angibt, auf welcher Plattform die Aktion ausgeführt werden soll
| JSON-Darstellung |
|---|
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum ( |
| Felder | |
|---|---|
url |
Die URL des Einstiegspunkts dieses ActionLinks |
language |
Das BCP-47-Tag für die Sprache, in der die Inhalte aus diesem URI verfügbar sind |
restrictedCountry[] |
Der ISO 3166-1 Alpha-2-Ländercode. Lass das Feld leer, wenn die Sichtbarkeit nicht eingeschränkt werden soll |
platform |
Die Plattform, auf der die Aktion ausgeführt werden soll. Ist dieses Feld nicht konfiguriert, wird ACTION_PLATFORM_WEB_APPLICATION als Fallback verwendet |
actionLinkType |
Vordefinierter Aktionstyp |
orderOnlineMetadata |
Metadaten für den Link „Online bestellen“. Unterstützt Aktionen mit ActionLinkType ACTION_LINK_TYPE_SHOP_ONLINE. |
foodOrderingMetadata |
Metadaten für Links zur Essensbestellung. Unterstützt die Aktionstypen: * |
eventMetadata |
Zusätzliche Informationen zum Aktionslink, die nur für die Veranstaltungsbranche gelten. |
ActionPlatform
Die Plattform, auf der die Aktion ausgeführt wird. Webanwendung ist das allgemeine Fallback. Es wird empfohlen, mindestens einen ActionLink mit ACTION_PLATFORM_WEB_APPLICATION zu verwenden. Links mit Android und iOS als Plattform werden nur im jeweiligen System verwendet.
| Optionen | |
|---|---|
ACTION_PLATFORM_UNSPECIFIED |
Die Plattform wurde nicht angegeben. |
ACTION_PLATFORM_WEB_APPLICATION |
Die Plattform für die Aktion ist das Web im Allgemeinen. |
ACTION_PLATFORM_MOBILE_WEB |
Die Plattform für die Aktion ist das Web auf Mobilgeräten. |
ACTION_PLATFORM_ANDROID |
Die Plattform für die Aktion ist Android OS. |
ACTION_PLATFORM_IOS |
Die Plattform für die Aktion ist iOS. |
ActionLinkType
Vordefinierter Aktionstyp für einen ActionLink.
| Optionen | |
|---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
Der ActionLink-Typ ist nicht angegeben. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
Der ActionLink-Typ ist "Einen Termin vereinbaren". |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
Der ActionLink-Typ ist "Einen Onlinetermin vereinbaren". |
ACTION_LINK_TYPE_ORDER_FOOD |
Der ActionLink-Typ ist "Essen zur Lieferung oder zum Abholen bestellen". |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
Der ActionLink-Typ ist "Essen zur Lieferung bestellen". |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
Der ActionLink-Typ ist "Essen zum Mitnehmen bestellen". |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
Der ActionLink-Typ ist "Einen Tisch im Restaurant reservieren". |
ACTION_LINK_TYPE_SHOP_ONLINE |
Der ActionLink-Typ ist „Einkaufen“. Die Bestellung kann geliefert oder abgeholt werden oder beides. |
OrderOnlineMetadata
Metadaten für einen ActionLink vom Typ „Online bestellen“.
| JSON-Darstellung |
|---|
{
"fulfillmentOption": [
{
object ( |
| Felder | |
|---|---|
fulfillmentOption[] |
Verfügbare Auftragsausführungsoptionen für einen Link zur Onlinebestellung. |
FulfillmentOption
Die Erfüllungsoption für einen ActionLink vom Typ „Online bestellen“.
| JSON-Darstellung |
|---|
{ "fulfillmentType": enum ( |
| Felder | |
|---|---|
fulfillmentType |
Erforderlich. Der Auftragsausführungstyp. |
availableDay[] |
Erforderlich. Eine Liste der Tage, an denen diese Erfüllungsmethode verfügbar ist (vorzugsweise mindestens zwei). |
feeDetails |
Erforderlich. Gebührendetails für die Ausführungsmethode. |
minimumOrder |
Erforderlich. Mindestbestellmenge für die mit dem ActionLink verknüpfte Erfüllungsmethode. |
FulfillmentType
Der Erfüllungstyp, der einem Aktionslink zugeordnet ist.
| Enums | |
|---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
Der Fulfillment-Typ ist nicht angegeben. |
FULFILLMENT_TYPE_DELIVERY |
Der Auftragsausführungstyp ist „Lieferung“. |
FULFILLMENT_TYPE_PICKUP |
Der Auftragsausführungstyp ist „Abholung“. |
AvailableDay
Verfügbarkeit auf Tagesebene.
| JSON-Darstellung |
|---|
{
"fulfillmentDate": {
object ( |
| Felder | |
|---|---|
fulfillmentDate |
Erforderlich. Ein verfügbares Datum für eine Erfüllungsmethode. Wird in der Zeitzone des Händlers angegeben. |
lastOrderingTime |
Erforderlich. UNIX-Zeitstempel. Der letzte Zeitpunkt, zu dem ein Nutzer Artikel über Wenn fulfillmentDate beispielsweise 2020-08-10 ist, bedeutet ein lastOrderingTime-Wert von 2020-08-10 18:00, dass ein Kunde die Bestellung bis 18:00 Uhr am selben Tag aufgeben muss, um sie am 10.08.2020 zu erhalten. – Ein „lastOrderingTime“-Wert von 2020-08-08 20:00 bedeutet, dass ein Kunde die Bestellung bis 20:00 Uhr zwei Tage vor dem 10.08.2020 aufgeben muss, um sie am 10.08.2020 zu erhalten. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
Datum
Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes darstellen:
- Ein ganzes Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind
- Einen Monat und einen Tag mit einem Jahr von 0 (z. B. einen Jahrestag)
- Ein Jahr für sich allein, also mit einem Monat und einem Tag von 0
- Ein Jahr und einen Monat mit einem Tag von 0 (z. B. ein Ablaufdatum der Kreditkarte)
Ähnliche Typen:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| JSON-Darstellung |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Felder | |
|---|---|
year |
Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahreszahl angegeben wird. |
month |
Monat eines Jahres. Der Wert muss zwischen 1 und 12 liegen. Er kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird. |
day |
Tag eines Monats. Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Er kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht relevant ist. |
FeeDetails
Gebührendetails für die Erfüllungsmethode, die mit dem ActionLink verknüpft ist.
| JSON-Darstellung |
|---|
{ // Union field |
| Felder | |
|---|---|
Union-Feld fee_details. Gebührenmodell für die Auftragsausführungsmethode. Für fee_details ist nur einer der folgenden Werte zulässig: |
|
noFee |
Für die Auftragsausführungsmethode fallen keine Gebühren an. |
baseFee |
Die mit der Erfüllungsmethode verbundene Grundgebühr. |
fixedFee |
Die Pauschalgebühr, die mit der Erfüllungsmethode verknüpft ist. |
NoFee
Dieser Typ hat keine Felder.
Für die mit dem Aktionslink verknüpfte Ausführungsmethode ist keine Gebühr erforderlich.
MinimumFee
Die Mindestgebühr, die für die mit dem Aktionslink verknüpfte Erfüllungsmethode erforderlich ist.
| JSON-Darstellung |
|---|
{
"baseFeeAmount": {
object ( |
| Felder | |
|---|---|
baseFeeAmount |
Erforderlich. Der Betrag der Grundgebühr für die Auftragsausführungsmethode. |
FixedFee
Die Pauschalgebühr, die für die mit dem Aktionslink verknüpfte Erfüllungsmethode erforderlich ist.
| JSON-Darstellung |
|---|
{
"amount": {
object ( |
| Felder | |
|---|---|
amount |
Erforderlich. Der Betrag der Pauschalgebühr für die Auftragsausführungsmethode. |
FoodOrderingMetadata
Metadaten für ActionLinks für Essensbestellungen.
| JSON-Darstellung |
|---|
{ "feeDetails": [ { object ( |
| Felder | |
|---|---|
feeDetails[] |
Details zu Gebühren, die dem Nutzer zusätzlich zum Gesamtbetrag des Artikels in Rechnung gestellt werden. Wiederholen Sie den Vorgang für verschiedene Gebührenarten wie Servicegebühr, Liefergebühr usw. |
advanceOrderDetails |
Details zur erweiterten Bestellunterstützung, auch bekannt als „Vorbestellung“, bei der Nutzer eine Bestellung für die Ausführung zu einem späteren Zeitpunkt aufgeben können. |
Union-Feld fulfillment_duration_options. Dauer der Auftragsabwicklung ab der Bestellbestätigung. Bei Lieferbestellungen die Zeit bis zur Lieferung der Speisen. Bei Abholbestellungen die Zeit, bis das Essen abgeholt werden kann. Für fulfillment_duration_options ist nur einer der folgenden Werte zulässig: |
|
fulfillmentLeadTimeDuration |
Feste Dauer. Beispiel: 30 Min. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „ |
fulfillmentLeadTimeDurationRange |
Ein Bereich für die Dauer. Beispiele: * 30 bis 45 Minuten * Mehr als 30 Minuten * Weniger als 50 Minuten |
FeeDetails
Gebührendetails.
| JSON-Darstellung |
|---|
{ "type": enum ( |
| Felder | |
|---|---|
type |
Gebührenart. (erforderlich) |
feeAmount |
Gebührenbetrag entweder in der Währung der Einheit, als Prozentsatz des Warenkorbwerts oder als Kombination aus beidem. (erforderlich) |
FeeType
Gebührenart.
| Enums | |
|---|---|
FEE_TYPE_UNSPECIFIED |
Gebührentyp nicht angegeben. |
DELIVERY |
Für Liefergebühren. |
SERVICE |
Für Servicegebühren. |
FeeAmount
FeeAmount-Beispiele: * Feste Gebühr: 0 $ (keine Gebühr), 1,50 $ * Bereich der festen Gebühr: 1,00 $ (Minimum), 3,00 $ (Maximum), 5,00–6,00 $ * Prozentsatz der Warenkorbgröße: 15,5 %, 10–20 %, 10 % (Minimum), 15 % (Maximum) * Kombination aus Bereich und Prozentsatz: 25,5 % und 2,50 $ (Minimum), 25,5 % und 4,50 $ (Maximum), 10 % und 1,50–2,50 $, 10,5–20 % und 2,50–3,50 $
| JSON-Darstellung |
|---|
{ "cartPercentage": { object ( |
| Felder | |
|---|---|
cartPercentage |
Gebühr als Prozentsatz des Warenkorbwerts. Unterstützt einen Bereich (begrenzt und unbegrenzt) oder einen festen Prozentsatz. Der Wert sollte zwischen 0 und 100 liegen. Beispiele: * Fest 5,5% * Mindestens 5,5% * Höchstens 5,5% * 4,5% bis 5,5% |
Union-Feld amount_options. Optionen zum Angeben eines Geldbetrags. Für amount_options ist nur einer der folgenden Werte zulässig: |
|
amount |
Fester Betrag. Beispiel: 3,5 USD. |
amountRange |
Betragsbereich. Beispiele: * 3,50 $ bis 5,50 $ * Mindestens 3,50 $ * Höchstens 5,50 $ |
amountUnknown |
Unbekannter Betrag. |
Geld
Stellt einen Geldbetrag mit Währungstyp dar.
| JSON-Darstellung |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| Felder | |
|---|---|
currencyCode |
Der aus drei Buchstaben bestehende Währungscode gemäß ISO 4217 |
units |
Die ganzen Einheiten des Betrags. Beispiel: Wenn |
nanos |
Anzahl der Nanoeinheiten (10^-9) des Betrags. Der Wert muss im Bereich von -999.999.999 bis +999.999.999 liegen. Wenn |
MoneyRange
Wrapper für einen Bereich von Geldbeträgen, der begrenzt oder unbegrenzt sein kann. Es muss mindestens einer der Werte „minAmount“ und „maxAmount“ angegeben werden.
| JSON-Darstellung |
|---|
{ "minAmount": { object ( |
| Felder | |
|---|---|
minAmount |
Mindestbetrag |
maxAmount |
Höchstbetrag |
QuantitativeValue
Wrapper für einen numerischen Wert, der ein Bereich oder ein fester Wert sein kann. QuantitativeValue-Beispiele: * Einzelner Wert: value: 10.5 * Begrenzter Bereich: valueRange {minValue: 5.5, maxValue 10.5} * Untergrenze: valueRange {minValue: 5.5} * Obergrenze: valueRange {maxValue: 10.5}
| JSON-Darstellung |
|---|
{ // Union field |
| Felder | |
|---|---|
Union-Feld value_options. (erforderlich) Für value_options ist nur einer der folgenden Werte zulässig: |
|
value |
Ein einzelner Wert. Beispiel: 5.6 |
valueRange |
Ein Wertebereich, der auch offen oder begrenzt sein kann. Beispiele: * Mindestens 5,5 * Höchstens 5,5 * 5,5 bis 6,5 |
RangeValue
Wertebereich, sodass minValue < maxValue. Es muss mindestens eines der Felder minValue und maxValue angegeben werden.
| JSON-Darstellung |
|---|
{ "minValue": number, "maxValue": number } |
| Felder | |
|---|---|
minValue |
Minimalwert. |
maxValue |
Höchstwert. |
DurationRange
Wrapper für einen Zeitraum, der begrenzt oder unbegrenzt sein kann. Es ist mindestens einer der Werte „minDuration“ und „maxDuration“ erforderlich.
| JSON-Darstellung |
|---|
{ "minDuration": string, "maxDuration": string } |
| Felder | |
|---|---|
minDuration |
Mindestdauer Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „ |
maxDuration |
Maximale Dauer. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „ |
AdvanceOrderDetails
Support für Vorbestellungen
| JSON-Darstellung |
|---|
{ "isSupported": boolean } |
| Felder | |
|---|---|
isSupported |
„True“, wenn Vorbestellungen (auch als „Order Ahead“ bezeichnet) unterstützt werden. (erforderlich) |
EventMetadata
Zusätzliche Informationen zum Aktionslink, die nur für die Veranstaltungsbranche gelten.
| JSON-Darstellung |
|---|
{
"surface": enum ( |
| Felder | |
|---|---|
surface |
Vordefinierte Ereignisoberfläche für einen ActionLink. Dies wird nur für die Kategorie „Veranstaltungen“ verwendet. |
Plattform/Oberfläche
Vordefinierte Ereignisoberfläche für einen ActionLink. Dies wird nur für die Kategorie „Veranstaltungen“ verwendet.
| Enums | |
|---|---|
SURFACE_UNSPECIFIED |
Die Oberfläche wurde nicht angegeben. |
SURFACE_SEARCH |
Der ActionLink ist das Buchen eines Veranstaltungstickets in der Suche. |
SURFACE_YOUTUBE |
Der ActionLink dient zum Buchen eines Veranstaltungstickets auf YouTube. |
SURFACE_ADS |
Der Aktionslink ist ein Klick auf eine Anzeige für das Event. |