- 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 |
restricted |
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 |
action |
Vordefinierter Aktionstyp |
order |
Metadaten für den Link zur Onlinebestellung. Unterstützt Aktionen mit dem ActionLinkType ACTION_LINK_TYPE_SHOP_ONLINE. |
food |
Metadaten für Links zur Onlinebestellung von Lebensmitteln Unterstützte Aktionstypen: * |
event |
Zusätzliche Informationen zum Aktionslink, der für die Ereignisbranche spezifisch ist. |
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 „Einkäufe bestellen“, kann „Lieferung“ oder „Abholung“ oder beides sein. |
OrderOnlineMetadata
Metadaten für einen Link zu einer Online-Aktionsbestellung.
JSON-Darstellung |
---|
{
"fulfillmentOption": [
{
object ( |
Felder | |
---|---|
fulfillment |
Verfügbare Auftragsausführungsoptionen für einen Link zur Onlinebestellung. |
FulfillmentOption
Die Option für die Abwicklung eines Online-Aktionslinks.
JSON-Darstellung |
---|
{ "fulfillmentType": enum ( |
Felder | |
---|---|
fulfillment |
Erforderlich. Der Auftragsausführungstyp. |
available |
Erforderlich. Eine Liste der Tage, an denen diese Abwicklungsmethode verfügbar ist (bevorzugt mindestens zwei). |
fee |
Erforderlich. Gebührendetails für die Ausführungsmethode. |
minimum |
Erforderlich. Mindestbestellwert für die mit dem ActionLink verknüpfte Ausführungsmethode. |
FulfillmentType
Der Ausführungstyp, der einem Aktionslink zugeordnet ist.
Enums | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
Der Ausführungstyp 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 | |
---|---|
fulfillment |
Erforderlich. Ein verfügbares Datum für eine Auftragsausführungsmethode. Wird als Zeitzone des Händlers angenommen. |
last |
Erforderlich. Unix-Zeitstempel. Das letzte Mal, an dem ein Nutzer bis zum Wenn das fulfillmentDate beispielsweise der 10. August 2020 ist, bedeutet ein Wert von „2020-08-10 18:00“ für „lastOrderingTime“, dass ein Kunde die Bestellung bis 18:00 Uhr am selben Tag aufgeben muss, um sie am 10. August 2020 zu erhalten. - Ein lastOrderingTime-Wert von 2020-08-08 20:00 bedeutet, dass ein Kunde, der seine Bestellung am 10.08.2020 erhalten möchte, zwei Tage vorher bis 20:00 Uhr eine Bestellung aufgeben muss. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
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 wird relativ zum gregorianischen Kalender angegeben. Dies kann Folgendes darstellen:
- Ein vollständiges Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind.
- Ein Monat und ein Tag mit einem Jahr von 0 (z. B. ein Jahrestag).
- Ein Jahr für sich, mit dem Wert „0“ für Monat und Tag.
- Ein Jahr und ein Monat mit dem Wert „0“ für den Tag (z. B. das Ablaufdatum einer Kreditkarte).
Ähnliche Typen:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON-Darstellung |
---|
{ "year": integer, "month": integer, "day": integer } |
Felder | |
---|---|
year |
Jahr des Datums. Muss zwischen 1 und 9999 liegen oder 0, um ein Datum ohne Jahr anzugeben. |
month |
Monat eines Jahres. Die Angabe muss zwischen 1 und 12 liegen. Sie kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird. |
day |
Tag des Monats. 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, wenn der Tag nicht von Bedeutung ist. |
FeeDetails
Gebührendetails für die mit dem Aktionslink verknüpfte Auftragsausführungsmethode.
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: |
|
no |
Für die Auftragsausführungsmethode fallen keine Gebühren an. |
base |
Die Grundgebühr für die Auftragsausführung. |
fixed |
Die mit der Ausführungsmethode verbundene feste Gebühr. |
Keine Gebühr
Dieser Typ hat keine Felder.
Für die mit dem Aktionslink verknüpfte Auftragsausführungsmethode fallen keine Gebühren an.
MinimumFee
Die für die mit dem Aktionslink verknüpfte Ausführungsmethode erforderliche Mindestgebühr.
JSON-Darstellung |
---|
{
"baseFeeAmount": {
object ( |
Felder | |
---|---|
base |
Erforderlich. Der Grundgebühr für die Auftragsausführungsmethode. |
FixedFee
Die für die mit der Aktionsverknüpfung verknüpfte Ausführungsmethode erforderliche feste Gebühr.
JSON-Darstellung |
---|
{
"amount": {
object ( |
Felder | |
---|---|
amount |
Erforderlich. Der Betrag der Pauschalgebühr für die Auftragsausführungsmethode. |
FoodOrderingMetadata
Metadaten für ActionLinks zur Essensbestellung
JSON-Darstellung |
---|
{ "feeDetails": [ { object ( |
Felder | |
---|---|
fee |
Details zu den Gebühren, die dem Nutzer zusätzlich zum Gesamtpreis des Artikels in Rechnung gestellt werden. Wird für verschiedene Arten von Gebühren wie Servicegebühren, Liefergebühren usw. wiederholt. |
advance |
Details zum erweiterten Bestellsupport, auch als „Vorab bestellen“ bezeichnet, bei dem Nutzer eine Bestellung später als derzeit ausführen können. |
Union-Feld fulfillment_duration_options . Dauer der Auftragsausführung ab Bestellbestätigung. Bei Lieferbestellungen die Zeit bis zur Lieferung des Essens. Bei Bestellungen zur Abholung: Zeitspanne, bis die Speisen zur Abholung bereit sind. Für fulfillment_duration_options ist nur einer der folgenden Werte zulässig: |
|
fulfillment |
Feste Dauer. Beispiel: 30 Minuten. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
fulfillment |
Einen Zeitraum. 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) |
fee |
Der Gebührenbetrag kann entweder in der Währung der Einheit, als Prozentsatz des Warenkorbwerts oder als Kombination aus beiden angegeben werden. (erforderlich) |
FeeType
Gebührentyp.
Enums | |
---|---|
FEE_TYPE_UNSPECIFIED |
Gebührentyp nicht angegeben. |
DELIVERY |
Für Liefergebühren. |
SERVICE |
Für Servicegebühren. |
FeeAmount
FeeAmount
Beispiele: * Pauschalgebühr: 0 € (keine Gebühr), 1,5 € * Pauschalgebühr – Spanne: 1,0 € (Minimum), 3,0 € (Maximum), 5,0–6,0 € * Prozentsatz der Warenkorbgröße: 15,5 %, 10–20 %, 10 % (Minimum), 15 % (Maximum) * Kombination aus Spanne und Prozentsatz: 25,5 % und 2,5 € (Minimum), 25,5 % und 4,5 € (Maximum), 10 % und 1,5–2,5 €, 10,5–20 % und 2,5–3,5 €
JSON-Darstellung |
---|
{ "cartPercentage": { object ( |
Felder | |
---|---|
cart |
Gebühr in Prozent des Warenkorbwerts. Es wird ein Bereich (begrenzt und unbegrenzt) oder ein fester Prozentsatz unterstützt. Der Wert sollte zwischen 0 und 100 liegen. Beispiele: * Fester Wert 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,50 € |
amount |
Betragsbereich. Beispiele: * 3,50 $ bis 5,50 $ * Mindestens 3,50 $ * Höchstens 5,50 $ |
amount |
Unbekannter Betrag. |
Geld
Stellt einen Geldbetrag mit Währungstyp dar.
JSON-Darstellung |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Felder | |
---|---|
currency |
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 eines Geldbetrags, der begrenzt oder unbegrenzt sein könnte. Es muss mindestens ein Wert für „minAmount“ und „maxAmount“ angegeben werden.
JSON-Darstellung |
---|
{ "minAmount": { object ( |
Felder | |
---|---|
min |
Mindestbetrag |
max |
Höchstbetrag. |
QuantitativeValue
Ummantelung für einen numerischen Wert, der ein Bereich oder ein fester Wert sein kann. QuantitativeValue
Beispiele: * Singularwert: value: 10.5
* Begrenzter Bereich: valueRange {minValue: 5.5, maxValue 10.5}
* Untere Grenze: valueRange {minValue: 5.5}
* Obere Grenze: valueRange {maxValue: 10.5}
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld value_options . (erforderlich) value_options kann nur einer der folgenden Werte sein: |
|
value |
Ein einzelner Wert. Beispiel: 5,6 |
value |
Ein Wertebereich, der auch offen oder begrenzt sein kann. Beispiele: * Mindestens 5,5 * Höchstens 5,5 * 5,5 bis 6,5 |
RangeValue
Wertebereich, in dem minValue
< maxValue
. Erfordert mindestens minValue
und maxValue
.
JSON-Darstellung |
---|
{ "minValue": number, "maxValue": number } |
Felder | |
---|---|
min |
Minimalwert. |
max |
Höchstwert. |
DurationRange
Wrapper für einen Zeitraum, der begrenzt oder unbegrenzt sein kann. Mindestens eine der Optionen „minDuration“ und „maxDuration“ ist erforderlich.
JSON-Darstellung |
---|
{ "minDuration": string, "maxDuration": string } |
Felder | |
---|---|
min |
Mindestdauer. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
max |
Maximale Dauer. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
AdvanceOrderDetails
Für Hilfe bei Vorbestellungen
JSON-Darstellung |
---|
{ "isSupported": boolean } |
Felder | |
---|---|
is |
„True“, wenn Vorbestellungen 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, die einem Aktionslink zugeordnet ist. Diese Option wird nur für die Branche „Ereignisse“ verwendet. |
Plattform/Oberfläche
Vordefinierte Ereignisoberfläche, die mit einem ActionLink verknüpft ist. Diese Option wird nur für die Branche „Ereignisse“ verwendet.
Enums | |
---|---|
SURFACE_UNSPECIFIED |
Die Oberfläche ist nicht angegeben. |
SURFACE_SEARCH |
Über den Aktionslink wird in der Google Suche ein Veranstaltungsticket gebucht. |
SURFACE_YOUTUBE |
Über den Aktionslink kannst du ein Veranstaltungsticket in YouTube buchen. |
SURFACE_ADS |
Der ActionLink ist ein Klick auf eine Anzeige für das Ereignis. |