Order

Bestellentität. Hinweis: 1. Alle Strings auf allen Ebenen müssen kürzer als 1.000 Zeichen sein, sofern nicht anders angegeben. 2. Alle wiederkehrenden Felder auf allen Ebenen müssen kleiner als 50 sein, sofern nicht anders angegeben. 3. Alle Zeitstempel auf allen Ebenen, sofern angegeben, müssen gültige Zeitstempel sein.

JSON-Darstellung
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
Felder
googleOrderId

string

Von Google zugewiesene Bestell-ID.

merchantOrderId

string

Erforderlich: Dem Händler zugewiesene interne Bestell-ID. Diese ID muss eindeutig sein und ist für nachfolgende Auftragsaktualisierungen erforderlich. Diese ID kann auf die angegebene googleOrderId oder einen anderen eindeutigen Wert festgelegt werden. Hinweis: Die ID, die Nutzern angezeigt wird, ist die userVisibleOrderId, die ein anderer, nutzerfreundlicherer Wert sein kann. Die maximal zulässige Länge beträgt 128 Zeichen.

userVisibleOrderId

string

Die an den Nutzer gerichtete ID, die auf die aktuelle Bestellung verweist. Diese ID muss mit der ID übereinstimmen, die in anderen Kontexten für diese Bestellung angezeigt wird, z. B. für Websites, Apps und E-Mails.

userVisibleStateLabel
(deprecated)

string

Eingestellt: Verwenden Sie stattdessen den Status „OrderExtensions“. Für den Nutzer sichtbares Label für den Status dieser Bestellung.

buyerInfo

object (UserInfo)

Informationen zum Käufer.

image

object (Image)

Mit der Bestellung verknüpftes Bild.

createTime

string (Timestamp format)

Erforderlich: Datum und Uhrzeit der Auftragserstellung.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

Datum und Uhrzeit der letzten Aktualisierung der Bestellung. Erforderlich für OrderUpdate.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

transactionMerchant

object (Merchant)

Händler, der den Bezahlvorgang vereinfacht hat. Dies kann sich von einem Anbieter auf Werbebuchungsebene unterscheiden. Beispiel: Expedia-Auftrag mit Werbebuchung von ANA

contents

object (Contents)

Erforderlich: Auftragsinhalt, der eine Gruppe von Werbebuchungen ist.

priceAttributes[]

object (PriceAttribute)

Preise, Rabatte, Steuern usw.

followUpActions[]

object (Action)

Folgeaktionen auf Auftragsebene.

paymentData

object (PaymentData)

Zahlungsbezogene Daten für die Bestellung.

termsOfServiceUrl

string

Ein Link zu den Nutzungsbedingungen, die für die Bestellung bzw. vorgeschlagene Bestellung gelten.

note

string

Mit einer Bestellung verknüpfte Notizen.

promotions[]

object (Promotion)

Alle Angebote, die mit dieser Bestellung verknüpft sind.

disclosures[]

object (Disclosure)

Mit dieser Anordnung verbundene Offenlegungen.

vertical
(deprecated)

object

Eingestellt: Verwenden Sie stattdessen Branchen. Diese Eigenschaften gelten für alle Werbebuchungen, sofern sie in einer Werbebuchung nicht überschrieben werden. Diese Branche muss dem Branchentyp auf Werbebuchungsebene entsprechen. Mögliche Werte: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

Union-Feld verticals. Diese Eigenschaften gelten für alle Werbebuchungen, sofern sie in einer Werbebuchung nicht überschrieben werden. Diese Branche muss dem Branchentyp auf Werbebuchungsebene entsprechen. Für verticals ist nur einer der folgenden Werte zulässig:
purchase

object (PurchaseOrderExtension)

Auftrag

ticket

object (TicketOrderExtension)

Ticketbestellung

UserInfo

Informationen zum Nutzer. Hiermit werden Informationen über den Nutzer dargestellt, der mit einer Bestellung verknüpft ist.

JSON-Darstellung
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
Felder
email

string

E-Mail-Adresse des Nutzers, z. B.: janedoe@gmail.com.

firstName

string

Vorname des Nutzers

lastName

string

Nachname des Nutzers

displayName

string

Der Anzeigename des Nutzers kann vom Vor- oder Nachnamen abweichen.

phoneNumbers[]

object (PhoneNumber)

Telefonnummern des Nutzers

PhoneNumber

Standardmäßige Darstellung der Telefonnummer

JSON-Darstellung
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
Felder
e164PhoneNumber

string

Telefonnummer im E.164-Format gemäß der Empfehlung E.164 der International Telecommunication Union (ITU). Wiki-Link: https://en.wikipedia.org/wiki/E.164

extension

string

Erweiterungen sind in den ITU-Empfehlungen nicht standardisiert, mit der Ausnahme, dass sie als Zahlenreihe mit maximal 40 Ziffern definiert sind. Sie wird hier als String definiert, um die mögliche Verwendung einer führenden Null in der Erweiterung zu berücksichtigen (Unternehmen haben hierzu volle Freiheit, da es keinen Standard gibt). Neben Ziffern, einige andere Wahlzeichen wie "," (Wartezeit) können hier gespeichert werden. Beispiel: xxx-xxx-xxxx ext. 123, „123“ ist die Erweiterung.

preferredDomesticCarrierCode

string

Der Code zur Auswahl des Mobilfunkanbieters, der beim Anrufen dieser Telefonnummer im Inland bevorzugt wird. Das gilt auch für Codes, die in einigen Ländern gewählt werden müssen, wenn Sie vom Festnetz zum Mobiltelefon aus anrufen oder umgekehrt. In Kolumbien etwa wird durch eine „3“ muss vor der eigentlichen Telefonnummer gewählt werden, wenn Sie von einem Mobiltelefon zu einem Festnetztelefon im Inland anrufen, und umgekehrt. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

Dies ist die "bevorzugte" d. h. andere Codes können auch funktionieren.

Bild

Ein Bild, das auf der Karte angezeigt wird.

JSON-Darstellung
{
  "url": string,
  "accessibilityText": string,
  "height": number,
  "width": number
}
Felder
url

string

Die Quell-URL des Bildes. Bilder können das Format JPG, PNG und GIF haben (animiert und nicht animiert). Beispiel: https://www.agentx.com/logo.png. Erforderlich.

accessibilityText

string

Eine Textbeschreibung des Bildes, das für Barrierefreiheit verwendet werden soll, z.B. Screenreadern. Erforderlich.

height

number

Die Höhe des Bilds in Pixeln Optional.

width

number

Die Breite des Bilds in Pixeln Optional.

Händler

Händler des Einkaufswagens/der Bestellung/der Werbebuchung.

JSON-Darstellung
{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
Felder
id

string

Optionale ID, die dem Händler zugewiesen wird (sofern vorhanden).

name

string

Der Name des Händlers, z. B. "Panera-Brot".

image

object (Image)

Das mit dem Händler verknüpfte Bild.

phoneNumbers[]

object (PhoneNumber)

Telefonnummern des Händlers

address

object (Location)

Adresse des Händlers.

Standort

Container, der einen Standort darstellt.

JSON-Darstellung
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
Felder
coordinates

object (LatLng)

Geografische Koordinaten. Erfordert [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

formattedAddress

string

Anzeigeadresse, z.B. „1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA“. Erfordert [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

zipCode

string

Postleitzahl. Erfordert [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] oder [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

city

string

Stadt. Erfordert [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] oder [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

postalAddress

object (PostalAddress)

Postanschrift. Erfordert [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] oder [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

name

string

Name des Orts.

phoneNumber

string

Telefonnummer des Standorts, z.B. Kontaktnummer des Geschäftsstandorts oder Telefonnummer des Lieferorts

notes

string

Notizen zum Ort.

placeId

string

placeId wird mit der Places API verwendet, um Details zu einem Ort abzurufen. Weitere Informationen finden Sie unter https://developers.google.com/places/web-service/place-id.

LatLng

Ein Objekt, das ein Wertepaar aus Längen- und Breitengrad darstellt. Es wird als Paar von Double-Werten ausgedrückt, die für den Breitengrad und den Längengrad stehen. Sofern nicht anders angegeben, muss dieser Wert dem WGS84-Standard entsprechen. Die Werte müssen in normalisierten Bereichen liegen.

JSON-Darstellung
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.

longitude

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

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 Adresseingabe/-bearbeitung: Verwenden Sie ein i18n-fähiges Adress-Widget wie https://github.com/google/libaddressinput. Nutzer sollten außerhalb der Länder, in denen dieses Feld verwendet wird, keine UI-Elemente zur Eingabe oder Bearbeitung von Feldern sehen.

Weitere Informationen zur Verwendung dieses Schemas finden Sie unter https://support.google.com/business/answer/6397478.

JSON-Darstellung
{
  "revision": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Felder
revision

number

Die Schemaversion von PostalAddress. Die Einstellung muss 0 lauten, was der aktuellen Überarbeitung entspricht.

Alle neuen Überarbeitungen müssen abwärtskompatibel zu alten Überarbeitungen sein.

regionCode

string

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 http://cldr.unicode.org/ und http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Beispiel: "CH" für die Schweiz

languageCode

string

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"

postalCode

string

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.

sortingCode

string

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).

administrativeArea

string

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

string

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 "addressLines".

sublocality

string

Optional. Unterlokalität der Adresse. Dies können beispielsweise Stadtviertel, Stadtteile und Bezirke sein.

addressLines[]

string

Offene Adresszeilen, mit denen nachgeordnete Bereiche einer Adresse beschrieben werden können.

Da die Werte in "addressLines" 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 "regionCode" und allen verbleibenden Informationen in "addressLines". 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 "regionCode" und "adressLines" 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[]

string

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

string

Optional. Der Name der Organisation an der Adresse.

Inhalt

Wrapper für Werbebuchungen.

JSON-Darstellung
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
Felder
lineItems[]

object (LineItem)

Liste der Auftragspositionen Mindestens 1 line_item ist erforderlich, höchstens 50 ist zulässig. Alle Werbebuchungen müssen zur selben Branche gehören.

LineItem

Eine Werbebuchung enthält eine Branche. Ein Auftrag oder ein Einkaufswagen kann mehrere Werbebuchungen derselben Branche enthalten. Unterwerbebuchungen/Add-ons usw. sollten je nach Anwendungsfall in vertikalen Protokollen definiert werden. Hinweis: 1. Alle Strings auf allen Ebenen müssen kürzer als 1.000 Zeichen sein, sofern nicht anders angegeben. 2. Alle wiederkehrenden Felder auf allen Ebenen müssen kleiner als 50 sein, sofern nicht anders angegeben. 3. Alle Zeitstempel auf allen Ebenen, sofern angegeben, müssen gültige Zeitstempel sein.

JSON-Darstellung
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}
Felder
id

string

Erforderlich: Dem Händler zugewiesene Kennung für die Werbebuchung. Wird verwendet, um vorhandene Positionen beim Anwenden von Teilaktualisierungen zu identifizieren. Die maximal zulässige Länge beträgt 64 Zeichen.

name

string

Name der Position, wie auf dem Beleg angegeben. Die maximal zulässige Länge beträgt 100 Zeichen.

userVisibleStateLabel
(deprecated)

string

Verworfen. Verwenden Sie stattdessen den Status auf Branchenebene. Verwenden Sie beispielsweise für Käufe „PurchaseOrderExtension.status“. Für den Nutzer sichtbares Label für den Status dieser Werbebuchung.

provider

object (Merchant)

Der Anbieter der jeweiligen Werbebuchung, falls dieser vom Gesamtauftrag abweicht Beispiel: Expedia-Auftrag mit Werbebuchungsanbieter ANA

priceAttributes[]

object (PriceAttribute)

Preis und Anpassungen auf Werbebuchungsebene.

followUpActions[]

object (Action)

Folgeaktionen in der Werbebuchung

recipients[]

object (UserInfo)

Kunden auf Werbebuchungsebene. Diese kann sich vom Käufer auf Auftragsebene unterscheiden. Beispiel: Nutzer X hat eine Restaurantreservierung unter dem Namen von Nutzer Y vorgenommen.

image

object (Image)

Kleines Bild, das mit diesem Element verknüpft ist, falls vorhanden.

description

string

Werbebuchungsbeschreibung.

notes[]

string

Zusätzliche Hinweise, die für diese bestimmte Position gelten, z. B. Stornierungsrichtlinien

disclosures[]

object (Disclosure)

Mit dieser Werbebuchung verknüpfte Offenlegungen.

vertical
(deprecated)

object

Eingestellt: Verwenden Sie stattdessen Branchen. Erforderlich: Semantische Inhalte der Werbebuchung basierend auf ihrem Typ/der Branche. Für jede Branche sollten eigene Details zur Auftragsausführung angegeben werden. Muss einer der folgenden Werte sein: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

Union-Feld verticals. Erforderlich: Semantische Inhalte der Werbebuchung basierend auf ihrem Typ/der Branche. Für jede Branche sollten eigene Details zur Auftragsausführung angegeben werden. Für verticals ist nur einer der folgenden Werte zulässig:
purchase

object (PurchaseItemExtension)

Bestellungen wie Waren, Lebensmittel usw.

reservation

object (ReservationItemExtension)

Reservierungsbestellungen wie Restaurant, Haarschnitt usw.

PriceAttribute

Preisattribut eines Auftrags oder einer Werbebuchung.

JSON-Darstellung
{
  "type": enum (Type),
  "name": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": number
  // End of list of possible types for union field spec.
}
Felder
type

enum (Type)

Erforderlich: Art des Geldattributs.

name

string

Erforderlich: Der vom Nutzer angezeigte String des Preisattributs. Wird vom Händler gesendet und lokalisiert.

state

enum (State)

Erforderlich: Preisangabe: Schätzung vs. tatsächlicher Wert.

taxIncluded

boolean

Gibt an, ob der Preis Steuern beinhaltet.

Union-Feld spec. Stellt entweder einen Geldbetrag oder einen Milliprozentsatz dar. Für spec ist nur einer der folgenden Werte zulässig:
amount

object (Money)

Geldbetrag.

amountMillipercentage
(deprecated)

number

Die Prozentsatzspezifikation, auf ein Tausendstel eines Prozentsatzes. Beispiel: 8, 750% wird als 8.750 dargestellt. Negative Prozentsätze stehen für prozentuale Rabatte. Dieses Feld wird eingestellt. Wenn ein solider Anwendungsfall erforderlich ist, können Sie weitere Inhalte hinzufügen.

Typ

Der Geldtyp.

Enums
TYPE_UNSPECIFIED Der Typ ist nicht angegeben. Clients sollten dies nicht explizit festlegen müssen.
REGULAR Regulärer Anzeigepreis vor Anwendung von Rabatten usw.
DISCOUNT Wird von der Zwischensumme subtrahiert.
TAX Wird zur Zwischensumme addiert.
DELIVERY Wird zur Zwischensumme addiert.
SUBTOTAL Zwischensumme, bevor einige Gebühren hinzugefügt werden können.
FEE Etwaige zusätzliche Gebühr.
GRATUITY Wird zur Zwischensumme addiert.
TOTAL Angezeigter Preis des Auftrags oder der Werbebuchung

Status

Stellt den Preisstatus dar.

Enums
STATE_UNSPECIFIED Nicht angegeben.
ESTIMATE Der Preis ist nur eine Schätzung.
ACTUAL Der tatsächliche Preis, der dem Nutzer in Rechnung gestellt wird.

Geld

Stellt einen Geldbetrag mit Währungstyp dar.

JSON-Darstellung
{
  "currencyCode": string,
  "amountInMicros": string
}
Felder
currencyCode

string

Der aus drei Buchstaben bestehende Währungscode gemäß ISO 4217.

amountInMicros

string (int64 format)

Betrag in Mikroeinheiten. Dieses Feld sollte beispielsweise auf 1990000 für 1, 99 $festgelegt werden.

Aktion

Eine mit dem Auftrag oder der Werbebuchung verknüpfte Folgeaktion.

JSON-Darstellung
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
Felder
type

enum (Type)

Erforderlich: Aktionstyp.

title

string

Titel oder Label der Aktion, der bzw. der dem Nutzer angezeigt wird. Die maximal zulässige Länge beträgt 100 Zeichen.

openUrlAction

object (OpenUrlAction)

Erforderliche Maßnahmen

actionMetadata

object (ActionMetadata)

Mit einer Aktion verknüpfte Metadaten.

Typ

Mögliche Folgemaßnahmen

Enums
TYPE_UNSPECIFIED Nicht spezifizierte Aktion.
VIEW_DETAILS Aktion „Bestelldetails ansehen“.
MODIFY Bestelländerung ändern.
CANCEL Bestellaktion abbrechen.
RETURN Aktion für Rückgabeanfrage.
EXCHANGE Aktion für Austauschbestellung.
EMAIL

E-Mail-Aktion Die Typen EMAIL und CALL wurden eingestellt. openUrlAction.url kann als Telefonnummer oder E-Mail verwendet werden.

CALL

Anrufaktion.

REORDER Aktion zum Neuanordnen.
REVIEW Bestellaktion überprüfen.
CUSTOMER_SERVICE Wenden Sie sich an den Kundenservice.
FIX_ISSUE Leiten Sie zur Behebung des Problems zur Website oder App des Händlers weiter.
DIRECTION Link zur Wegbeschreibung.

OpenUrlAction

Öffnet die angegebene URL.

JSON-Darstellung
{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
Felder
url

string

Das URL-Feld, entweder http- oder https-URLs zum Öffnen einer mit Apps verknüpften App oder einer Webseite

androidApp

object (AndroidApp)

Informationen zur Android-App, wenn die URL voraussichtlich von einer Android-App bereitgestellt wird.

urlTypeHint

enum (UrlTypeHint)

Gibt einen Hinweis für den URL-Typ an.

AndroidApp

Spezifikation der Android-App für Einschränkungen für die Auftragsausführung

JSON-Darstellung
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
Felder
packageName

string

Paketname Der Paketname muss bei der Android-Auftragsausführung angegeben werden.

versions[]

object (VersionFilter)

Wenn mehrere Filter angegeben sind, wird bei jeder Filterübereinstimmung die Anwendung ausgelöst.

VersionFilter

VersionFilter sollte eingeschlossen werden, wenn bestimmte Versionen der App erforderlich sind.

JSON-Darstellung
{
  "minVersion": number,
  "maxVersion": number
}
Felder
minVersion

number

Code der Mindestversion oder 0 (einschließlich).

maxVersion

number

Max. Versionscode, einschließlich. Der berücksichtigte Bereich ist [minVersion:maxVersion]. Ein Nullbereich impliziert jede Version. Beispiele: Wenn Sie eine einzelne Version angeben möchten, verwenden Sie: [target_version:target_version]. Wenn Sie eine Version angeben möchten, lassen Sie minVersion und maxVersion nicht angegeben. Wenn Sie alle Versionen bis zur maxVersion angeben möchten, lassen Sie minVersion nicht angegeben. Wenn Sie alle Versionen aus minVersion angeben möchten, lassen Sie maxVersion nicht angegeben.

UrlTypeHint

Verschiedene Arten von URL-Hinweisen

Enums
URL_TYPE_HINT_UNSPECIFIED Ohne Angabe
AMP_CONTENT Eine URL, die direkt auf AMP-Inhalte oder eine kanonische URL verweist, die über <link rel="amphtml"> auf AMP-Inhalte verweist.

ActionMetadata

Zugehörige Metadaten pro Aktion.

JSON-Darstellung
{
  "expireTime": string
}
Felder
expireTime

string (Timestamp format)

Zeitpunkt, zu dem diese Aktion abläuft.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

Offenlegung

Offenlegung von Produkten, Dienstleistungen oder Richtlinien, die dem Nutzer angezeigt werden können.

JSON-Darstellung
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
Felder
title

string

Titel der Offenlegung. Beispiel: „Sicherheitsinformationen“.

disclosureText

object (DisclosureText)

Inhalt der Offenlegung. Weblinks sind zulässig.

presentationOptions

object (DisclosurePresentationOptions)

Darstellungsoptionen für die Offenlegung.

DisclosureText

Stellt einen Nur-Text mit Weblinks dar.

JSON-Darstellung
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
Felder
template

string

Anzuzeigender Text mit Platzhaltern wie "{0}" und "{1}" für jeden Textlink, der eingefügt werden soll. Beispiel: „WARNUNG: Bei diesem Produkt können Sie mit Chemikalien in Kontakt kommen, die dem US-Bundesstaat Kalifornien nachweislich Krebs verursachen. Weitere Informationen finden Sie unter {0}." Dieser Offenlegungstext darf keine werbeähnlichen oder anzeigenähnlichen Inhalte enthalten.

DisclosurePresentationOptions

Optionen für die Darstellung einer Offenlegung.

JSON-Darstellung
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
Felder
presentationRequirement

enum (PresentationRequirement)

Die Offenlegungspflicht.

initiallyExpanded

boolean

Ob der Inhalt der Offenlegung anfangs erweitert werden soll Sie ist standardmäßig minimiert.

PresentationRequirement

Anforderung zur Darstellung der Offenlegung.

Enums
REQUIREMENT_UNSPECIFIED Nicht spezifizierte Anforderung. Sollte nicht explizit festgelegt werden.
REQUIREMENT_OPTIONAL Die Offenlegung ist optional. Sie können übersprungen werden, wenn das Gerät die Anzeige von Offenlegungen nicht unterstützt.
REQUIREMENT_REQUIRED Die Offenlegung ist erforderlich. Wenn das Gerät die Anzeige von Offenlegungen nicht unterstützt, wird die Unterhaltung an das Smartphone gesendet.

PurchaseItemExtension

Positionsinhalte der Branche „Kauf“.

JSON-Darstellung
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": number,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}
Felder
status

enum (PurchaseStatus)

Erforderlich: Status auf Werbebuchungsebene.

userVisibleStatusLabel

string

Erforderlich: Für den Nutzer sichtbares Label/String für den Status. Die maximal zulässige Länge beträgt 50 Zeichen.

type

enum (PurchaseType)

Erforderlich: Art des Kaufs.

productId
(deprecated)

string

Die mit dieser Position verknüpfte Produkt- oder Angebots-ID.

quantity

number

Menge des Artikels.

unitMeasure

object (MerchantUnitMeasure)

Mengeneinheit. Gibt die Größe des Artikels in ausgewählten Einheiten an. Anhand der Größe wird zusammen mit dem aktiven Preis der Preis pro Einheit bestimmt.

returnsInfo

object (PurchaseReturnsInfo)

Gibt Informationen für diese Position zurück. Wenn die Richtlinie nicht konfiguriert ist, werden Informationen auf Auftragsebene für diese Werbebuchung übernommen.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informationen zur Ausführung für diese Werbebuchung. Wenn die Richtlinie nicht konfiguriert ist, werden Informationen zur Auftragsausführung auf Auftragsebene für diese Werbebuchung übernommen.

itemOptions[]

object (ItemOption)

Zusätzliche Add-ons oder Unterelemente.

extension

object

Zusätzliche Felder, die zwischen dem Händler und Google ausgetauscht werden

Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

productDetails

object (ProductDetails)

Details zum Produkt

PurchaseStatus

Kaufstatus, der mit einem Auftrag oder einer bestimmten Position verknüpft ist.

Enums
PURCHASE_STATUS_UNSPECIFIED Status nicht angegeben.
READY_FOR_PICKUP Abholbereit.
SHIPPED Versandt.
DELIVERED Zugestellt.
OUT_OF_STOCK Nicht auf Lager.
IN_PREPARATION IN_PREPARATION unterschiedliche Bedeutungen haben. Bei der FOOD-Bestellung könnte es sein, dass das Essen zubereitet wird. Im Einzelhandel könnte das beispielsweise der Fall sein, dass ein Artikel verpackt wird.
CREATED Der Auftrag wird erstellt.
CONFIRMED Der Händler hat die Bestellung bestätigt.
REJECTED Der Händler hat die Bestellung oder Werbebuchung abgelehnt.
RETURNED Der Artikel wurde vom Nutzer zurückgegeben.
CANCELLED Der Auftrag oder die Werbebuchung wurde vom Nutzer storniert.
CHANGE_REQUESTED Der Benutzer hat eine Änderung an der Bestellung angefordert und der Integrator verarbeitet diese Änderung. Die Bestellung sollte in einen anderen Status verschoben werden, nachdem die Anfrage verarbeitet wurde.

PurchaseType

Die Kaufkategorie.

Enums
PURCHASE_TYPE_UNSPECIFIED Unbekannter Wert.
RETAIL Dazu gehören Käufe wie physische Waren.
FOOD Dazu gehört auch der Kauf von Essensbestellungen.
GROCERY Lebensmittelkauf.
MOBILE_RECHARGE Kauf eines Prepaid-Guthabens für die Aufladung von Mobilfunkguthaben.

MerchantUnitMeasure

„Mengeneinheit für Grundpreis“ des Händlers.

JSON-Darstellung
{
  "measure": number,
  "unit": enum (Unit)
}
Felder
measure

number

Wert: Beispiel 1.2.

unit

enum (Unit)

Einheit: Beispiel POUND, GRAM.

Einheit

Enums
UNIT_UNSPECIFIED Einheit nicht angegeben.
MILLIGRAM Milligramm.
GRAM Gramm.
KILOGRAM Kilogramm.
OUNCE Unze.
POUND Pfund.

PurchaseReturnsInfo

Gibt Informationen zurück, die mit einem Auftrag oder einer bestimmten Werbebuchung verknüpft sind.

JSON-Darstellung
{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}
Felder
isReturnable

boolean

Bei „true“ ist die Rückgabe zulässig.

daysToReturn

number

Die Rückgabe ist innerhalb dieser Anzahl von Tagen möglich.

policyUrl

string

Link zu den Rückgabebedingungen.

PurchaseFulfillmentInfo

Informationen zur Ausführung, die mit einem Auftrag oder einer bestimmten Werbebuchung verknüpft sind.

JSON-Darstellung
{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}
Felder
id

string

Eindeutige Kennung für diese Dienstleistungsoption.

fulfillmentType

enum (Type)

Erforderlich: Der Typ der Auftragsausführung.

expectedFulfillmentTime

object (Time)

Ein Fenster, wenn ein Zeitraum angegeben ist, oder ETA, wenn eine einzelne Zeit angegeben ist. Voraussichtliche Liefer- oder Abholzeit.

expectedPreparationTime

object (Time)

Ein Fenster, wenn ein Zeitraum angegeben ist, oder ETA, wenn eine einzelne Zeit angegeben ist. Die geschätzte Zeit für die Zubereitung des Essens. Einmalig.

location

object (Location)

Abhol- oder Lieferort.

expireTime

string (Timestamp format)

Zeitpunkt, zu dem diese Auftragsausführungsoption abläuft.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

price

object (PriceAttribute)

Kosten dieser Option.

fulfillmentContact

object (UserInfo)

Nutzerkontakt für diese Auftragsausführung.

shippingMethodName

string

Name der Versandart, die vom Nutzer ausgewählt wurde.

storeCode

string

Geschäftscode des Standorts. Beispiel: Walmart ist der Händler und storeCode ist der Walmart-Shop, in dem die Auftragsausführung stattgefunden hat. https://support.google.com/business/answer/3370250?ref_topic=4596653.

pickupInfo

object (PickupInfo)

Zusätzliche Informationen zur Auswahl der Bestellung. Dieses Feld ist nur verfügbar, wenn der Ausführungstyp PICKUP lautet.

Typ

Ausführungstyp.

Enums
TYPE_UNSPECIFIED Der Typ ist nicht angegeben.
DELIVERY Diese Bestellung wird geliefert.
PICKUP Diese Bestellung muss abgeholt werden.

Zeit

Zeitkonstruktion zur Darstellung der Zeit eines Ereignisses, die verwendet werden soll, wenn dem Nutzer eine Bestellung angezeigt wird.

JSON-Darstellung
{
  "timeIso8601": string
}
Felder
timeIso8601

string

Stellt die Zeit eines Bestellereignisses wie Reservierungszeit, Lieferzeit usw. dar. Es könnte sich dabei um eine Dauer (Start- und Endzeit), nur das Datum oder die Uhrzeit handeln. Alle unterstützten Formate finden Sie unter https://en.wikipedia.org/wiki/ISO_8601.

PickupInfo

Details zur Abholung einer Bestellung. Sie enthält Details wie den Abholtyp und gegebenenfalls zusätzliche Metadaten zu jedem Typ.

JSON-Darstellung
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
Felder
pickupType

enum (PickupType)

Abholoption, z. B. IM GESCHÄFT, VORHERIGE usw.

curbsideInfo

object (CurbsideInfo)

Spezifische Angaben zur Abholung vor dem Laden. Wenn für pickupType nicht „CURBSIDE“ angegeben ist, wird dieses Feld ignoriert.

checkInInfo[]

object (CheckInInfo)

Liste der verschiedenen Methoden, die vom Partner zur Unterstützung des Check-ins unterstützt werden.

PickupType

Liste der unterstützten Abholtypen.

Enums
UNSPECIFIED Abholtyp nicht angegeben.
INSTORE Essen im Restaurant abholen.
CURBSIDE Parken Sie Ihr Fahrzeug an einem ausgewiesenen Parkplatz vor dem Restaurant, dann lieferte jemand das Essen.

CurbsideInfo

Details dazu, wie die Bestellung vor dem Laden möglich wäre

JSON-Darstellung
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
Felder
curbsideFulfillmentType

enum (CurbsideFulfillmentType)

Partner benötigen zusätzliche Informationen, um Bestellungen zur Abholung vor dem Laden zu ermöglichen. Abhängig davon, welche Art der Auftragsausführung ausgewählt wurde, werden entsprechende Details vom Nutzer erhoben.

userVehicle

object (Vehicle)

Fahrzeugdetails des Nutzers, der die Bestellung aufgibt.

CurbsideFulfillmentType

Mögliche Werte der Typen für die Abholung vor dem Laden.

Enums
UNSPECIFIED Typ der Auftragsausführung vor dem Laden nicht angegeben.
VEHICLE_DETAIL Fahrzeugdetails für die leichtere Abholung vor dem Laden erforderlich.

Fahrzeug

Details zu einem Fahrzeug

JSON-Darstellung
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
Felder
make

string

Fahrzeugmarke (z.B. „Honda“). Dies wird dem Nutzer angezeigt und muss lokalisiert werden. Erforderlich.

model

string

Fahrzeugmodell (z.B. „Grom“). Dies wird dem Nutzer angezeigt und muss lokalisiert werden. Erforderlich.

licensePlate

string

Kfz-Kennzeichen (z.B. „1ABC234“). Erforderlich.

colorName

string

Name der Fahrzeugfarbe, z. B. Schwarz (optional)

image

object (Image)

URL zu einem Foto des Fahrzeugs. Das Foto wird mit einer Größe von ungefähr 256 x 256 Pixel angezeigt. Muss eine JPG- oder PNG-Datei sein. Optional.

CheckInInfo

Vom Partner erforderliche Metadaten, um eine Check-in-Methode zu unterstützen.

JSON-Darstellung
{
  "checkInType": enum (CheckInType)
}
Felder
checkInType

enum (CheckInType)

Methode zum Senden von Anweisungen zum Einchecken.

CheckInType

Verschiedene Methoden zum Senden von Check-in-Anweisungen.

Enums
CHECK_IN_TYPE_UNSPECIFIED Unbekannter Wert.
EMAIL Check-In-Informationen werden per E-Mail gesendet.
SMS Check-In-Informationen werden per SMS gesendet.

ItemOption

Add-ons oder Unterelemente

JSON-Darstellung
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": number,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Felder
id

string

Eindeutige Artikel-ID bei Optionen, bei denen es sich um Artikel handelt.

name

string

Optionsname.

prices[]

object (PriceAttribute)

Gesamtpreis der Option.

note

string

Hinweis zur Option.

quantity

number

Bei Optionen, bei denen es sich um Artikel handelt, Menge.

productId

string

Die Produkt- oder Angebots-ID, die mit dieser Option verknüpft ist.

subOptions[]

object (ItemOption)

Zum Definieren anderer verschachtelter Unteroptionen.

ProductDetails

Details zum Produkt

JSON-Darstellung
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
Felder
productId

string

Die mit dieser Position verknüpfte Produkt- oder Angebots-ID.

gtin

string

Global Trade Item Number des Produkts. Dies ist hilfreich, wenn das Attribut „offerId“ nicht im Merchant Center vorhanden ist. Optional.

plu

string

Preissuchcodes, auch als PLU-Codes, PLU-Nummern, PLUs, Produktcodes oder Etiketten für Lebensmittel bezeichnet, sind ein Zahlensystem, das unverpackte Waren, die in Lebensmittelgeschäften und Supermärkten verkauft werden, eindeutig identifizieren.

productType

string

Vom Händler definierte Produktkategorie. Beispiel: "Startseite > Lebensmittel > Milchprodukte und Eier > Milch > Vollmilch

productAttributes

map (key: string, value: string)

Vom Händler bereitgestellte Details zum Produkt, z.B. { &quot;allergen&quot;: &quot;peanut&quot; }. Dies ist hilfreich, wenn das Attribut „offerId“ nicht im Merchant Center vorhanden ist. Optional.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ReservationItemExtension

Werbebuchungsinhalte für Reservierungsbestellungen wie Restaurant, Friseur usw. Nächste ID: 15.

JSON-Darstellung
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": number,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
Felder
status

enum (ReservationStatus)

Erforderlich: Reservierungsstatus.

userVisibleStatusLabel

string

Erforderlich: Für den Nutzer sichtbares Label/String für den Status. Die maximal zulässige Länge beträgt 50 Zeichen.

type

enum (ReservationType)

Art der Reservierung. Kann nicht festgelegt werden, wenn keine der Typoptionen anwendbar ist.

reservationTime

object (Time)

Zeitpunkt, zu dem der Dienst/das Ereignis planmäßig stattfinden soll. Dabei kann es sich um einen Zeitraum, ein Datum oder ein genaues Datum und eine genaue Uhrzeit handeln.

userAcceptableTimeRange

object (Time)

Zeitraum, der für den Nutzer akzeptabel ist.

confirmationCode

string

Bestätigungscode für diese Reservierung.

partySize

number

Die Anzahl der Personen.

staffFacilitators[]

object (StaffFacilitator)

Personalunterstützer, die die Reservierung durchführen. Beispiel: Der Friseur.

location

object (Location)

Ort der Dienstleistung/Veranstaltung.

extension

object

Zusätzliche Felder, die zwischen dem Händler und Google ausgetauscht werden

Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

ReservationStatus

Status der Reservierung.

Enums
RESERVATION_STATUS_UNSPECIFIED Unbekannter Status.
PENDING Die Reservierung steht aus.
CONFIRMED Die Reservierung ist bestätigt.
CANCELLED Die Reservierung wurde vom Nutzer storniert.
FULFILLED Die Reservierung wurde ausgeführt.
CHANGE_REQUESTED Reservierungsänderung angefordert
REJECTED Die Reservierung wurde vom Integrator entweder abgelaufen oder abgelehnt.

ReservationType

Art der Reservierung.

Enums
RESERVATION_TYPE_UNSPECIFIED Nicht definierter Typ.
RESTAURANT Reservierung für Restaurant.
HAIRDRESSER Reservierung eines Friseurs.

StaffFacilitator

Informationen zum Servicemitarbeiter.

JSON-Darstellung
{
  "name": string,
  "image": {
    object (Image)
  }
}
Felder
name

string

Name der moderierenden Person Beispiel: „Max Mustermann“

image

object (Image)

Bilder des Künstlers

PaymentData

Zahlungsdaten zu einer Bestellung.

JSON-Darstellung
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
Felder
paymentResult

object (PaymentResult)

Zahlungsergebnis, das vom Integrator für den Abschluss einer Transaktion verwendet wird. Dieses Feld wird von Actions on Google ausgefüllt, wenn der Bezahlvorgang von Actions-on-Google verwaltet wird.

paymentInfo

object (PaymentInfo)

Zahlungsinformationen zur Bestellung, die für die Nutzerinteraktion nützlich sind

PaymentResult

Das Zahlungsergebnis, das vom Integrator für den Abschluss einer Transaktion verwendet wird.

JSON-Darstellung
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
Felder
Union-Feld result. Es werden entweder Google Payment-Daten oder die Händlerzahlungsmethode angegeben. Für result ist nur einer der folgenden Werte zulässig:
googlePaymentData

string

Von Google bereitgestellte Daten zur Zahlungsmethode. Wenn Ihr Zahlungsabwickler hier als von Google unterstützter Zahlungsabwickler aufgeführt ist: https://developers.google.com/pay/api/ Rufen Sie den Link zu Ihrem Zahlungsabwickler auf, um weitere Informationen zu erhalten. Einzelheiten zur Nutzlast finden Sie in der folgenden Dokumentation. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

Vom Händler/Aktion angegebene Zahlungsmethode vom Nutzer ausgewählt.

PaymentInfo

Zahlungsinformationen zu der aufgegebenen Bestellung Dieses Proto erfasst Informationen, die für die nutzerseitige Interaktion nützlich sind.

JSON-Darstellung
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Felder
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

Die angezeigten Informationen der Zahlungsmethode, die für die Transaktion verwendet wurde.

paymentMethodProvenance

enum (PaymentMethodProvenance)

Herkunft der für die Transaktion verwendeten Zahlungsmethode Der Nutzer hat möglicherweise dieselbe Zahlungsmethode bei Google und beim Händler registriert.

PaymentMethodDisplayInfo

Das Zahlungsergebnis, das vom Integrator für den Abschluss einer Transaktion verwendet wird.

JSON-Darstellung
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}
Felder
paymentType

enum (PaymentType)

Die Art der Zahlung.

paymentMethodDisplayName

string

Für den Nutzer sichtbarer Name der Zahlungsmethode. Beispiel: VISA **** 1234 Girokonto **** 5678

paymentMethodVoiceName

string

Name der Zahlungsmethode, der dem Nutzer für sprachgesteuerte Assistant-Geräte vorgelesen wird. Beispiele: „Visum mit den Endziffern eins zwei drei vier“ oder „Girokonto mit den Endziffern fünf sechs siebenacht“. Hinweis: Dies ist der sprachoptimierte String, der anstelle von "paymentMethodDisplayName" für Geräte mit Sprachassistenten verwendet wird. Wenn dieser String nicht festgelegt ist, wird „paymentMethodDisplayName“ an den Nutzer vorgelesen.

PaymentType

PaymentType gibt die Zahlungsart an, die für die vom Händler bereitgestellte Zahlungsmethode verwendet wird. Die Aktion muss auch einen Anzeigenamen für die Zahlungsmethode enthalten.

Enums
PAYMENT_TYPE_UNSPECIFIED Zahlungsmethode nicht angegeben.
PAYMENT_CARD Eine Kredit-/Debit- oder Prepaidkarte
BANK Die Zahlungsmethode ist ein Bankkonto.
LOYALTY_PROGRAM Die Zahlungsmethode ist ein Treuepunkteprogramm.
CASH Als Zahlungsmethode wird Bargeld verwendet.
GIFT_CARD Die Zahlungsmethode ist eine Geschenkkarte.
WALLET Drittanbieter-Wallet, z.B. PayPal

PaymentMethodProvenance

Die Herkunft der Zahlungsmethode, die für die Transaktion verwendet wurde

Enums
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED Herkunft ist nicht angegeben.
PAYMENT_METHOD_PROVENANCE_GOOGLE Herkunft ist Google.
PAYMENT_METHOD_PROVENANCE_MERCHANT Herkunft ist Händler.

Angebot

Aktionen/Angebote, die dem Einkaufswagen hinzugefügt wurden.

JSON-Darstellung
{
  "coupon": string
}
Felder
coupon

string

Erforderlich: Gutscheincode, der auf dieses Angebot angewendet wurde.

PurchaseOrderExtension

Bestellerweiterung für die Branche „Käufe“. Diese Eigenschaften gelten für alle Werbebuchungen innerhalb des Auftrags, sofern sie nicht in einer Werbebuchung überschrieben werden.

JSON-Darstellung
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
Felder
status

enum (PurchaseStatus)

Erforderlich: Gesamtstatus der Bestellung.

userVisibleStatusLabel

string

Für den Nutzer sichtbares Label/String für den Status. Die maximal zulässige Länge beträgt 50 Zeichen.

type

enum (PurchaseType)

Erforderlich: Art des Kaufs.

returnsInfo

object (PurchaseReturnsInfo)

Rückgabeinformationen zur Bestellung.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informationen zur Ausführung der Bestellung.

extension

object

Zusätzliche Felder, die zwischen dem Händler und Google ausgetauscht werden

Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

purchaseLocationType

enum (PurchaseLocationType)

Ort des Kaufs (im Geschäft / online)

errors[]

object (PurchaseError)

Optional: Fehler, aufgrund derer diese Bestellung abgelehnt wurde.

PurchaseLocationType

Standorttyp des Kaufs.

Enums
UNSPECIFIED_LOCATION Unbekannter Wert.
ONLINE_PURCHASE Alle Käufe, die online gekauft wurden.
INSTORE_PURCHASE Alle Käufe im Geschäft

PurchaseError

Fehler, aufgrund derer ein Auftrag abgelehnt werden kann.

JSON-Darstellung
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": number
}
Felder
type

enum (ErrorType)

Erforderlich: Dies ist der Grund, aus dem eine Bestellung vom Händler abgelehnt wird.

description

string

Zusätzliche Fehlerbeschreibung.

entityId

string

Die Entitäts-ID, die dem Fehler entspricht. Ein Beispiel hierfür ist „LineItemId“/„ItemOptionId“.

updatedPrice

object (PriceAttribute)

Relevant im Fall des Fehlertyps PRICE_CHANGED / INORRECT_PRICE.

availableQuantity

number

Jetzt verfügbare Menge. Anwendbar im Fall von AVAILABILITY_CHANGED.

ErrorType

Mögliche Fehlertypen.

Enums
ERROR_TYPE_UNSPECIFIED Unbekannter Fehler
NOT_FOUND Entity nicht gefunden. Kann Artikel, FulfillmentOption, Promotion sein. Entitäts-ID erforderlich.
INVALID Entitätsdaten ungültig. „Item“, „FulfillmentOption“ oder „Promotion“. Entitäts-ID erforderlich.
AVAILABILITY_CHANGED Artikel nicht verfügbar oder nicht genügend Artikel, um die Anfrage zu erfüllen. Entitäts-ID erforderlich.
PRICE_CHANGED Der Artikelpreis unterscheidet sich vom Preis in der Artikelentität. Entitäts-ID und aktualisierter Preis erforderlich.
INCORRECT_PRICE Preisfehler bei Gebühren, Gesamtbetrag. Entitäts-ID und aktualisierter Preis erforderlich.
REQUIREMENTS_NOT_MET Einschränkungen beim Annehmen der Bestellung nicht erfüllt, z. B. Mindestbestellmenge usw.
TOO_LATE FulfillmentOption abgelaufen.
NO_CAPACITY Keine verfügbare Dienstkapazität.
INELIGIBLE Nutzer ist nicht berechtigt, Bestellungen aufzugeben (auf die schwarze Liste gesetzt)
OUT_OF_SERVICE_AREA Die Lieferung an die gewünschte Adresse ist aufgrund von Grenzen usw. nicht möglich.
CLOSED Das Restaurant ist bei der Bestellung geschlossen.
PROMO_NOT_APPLICABLE Allgemeiner Fehlercode, um alle Fälle abzufangen, in denen der Gutscheincode nicht angewendet werden kann, wenn keiner der unten genannten passt. Fügen Sie den Gutscheincode als Entitäts-ID hinzu.
PROMO_NOT_RECOGNIZED Der Gutscheincode wurde vom Partner nicht erkannt. Fügen Sie den Gutscheincode als Entitäts-ID hinzu.
PROMO_EXPIRED Das Angebot konnte nicht angewendet werden, da es abgelaufen ist. Fügen Sie den Gutscheincode als Entitäts-ID hinzu.
PROMO_USER_INELIGIBLE Der aktuelle Nutzer kann diesen Gutschein nicht einlösen. Fügen Sie den Gutscheincode als Entitäts-ID hinzu.
PROMO_ORDER_INELIGIBLE Für die aktuelle Bestellung ist dieser Gutschein nicht verfügbar. Fügen Sie den Gutscheincode als Entitäts-ID hinzu.
UNAVAILABLE_SLOT Der Slot für Vorbestellungen ist nicht verfügbar.
FAILED_PRECONDITION Einschränkungen beim Annehmen der Bestellung nicht erfüllt, z. B. Mindestbestellmenge usw.
PAYMENT_DECLINED Ungültige Zahlung.
MERCHANT_UNREACHABLE Händler ist nicht erreichbar. Das ist hilfreich, wenn ein Partner ein Aggregator ist und den Händler nicht erreichen kann.

TicketOrderExtension

Inhalte für Ticketbestellungen wie Filme, Sport usw. bestellen

JSON-Darstellung
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
Felder
ticketEvent

object (TicketEvent)

Das Ereignis wurde auf alle Werbebuchungstickets angewendet.

TicketEvent

Stellt ein einzelnes Ereignis dar.

JSON-Darstellung
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
Felder
type

enum (Type)

Erforderlich: Typ der Ticketveranstaltung, z.B. Film, Konzert.

name

string

Erforderlich: Name des Ereignisses. Handelt es sich bei dem Ereignis beispielsweise um einen Film, sollte hier der Name des Films angegeben werden.

description

string

Beschreibung der Veranstaltung.

url

string

URL zu den Ereignisinformationen.

location

object (Location)

Der Ort, an dem das Ereignis stattfindet, oder eine Organisation.

eventCharacters[]

object (EventCharacter)

Die Zeichen, die sich auf dieses Ereignis beziehen. Dies können Regisseure oder Schauspieler eines Filmereignisses, Darsteller eines Konzerts usw. sein.

startDate

object (Time)

Start.

endDate

object (Time)

Ende.

doorTime

object (Time)

Beginn; kann vom Beginn der Veranstaltung abweichen. z.B. Die Veranstaltung beginnt um 09:00 Uhr, der Einlass ist jedoch 8:30 Uhr.

Typ

Der Typ des Ereignisses.

Enums
EVENT_TYPE_UNKNOWN Unbekannter Ereignistyp.
MOVIE Film
CONCERT Konzert.
SPORTS Sport

EventCharacter

Ein Ereigniszeichen, z.B. Organisator, Künstler usw.

JSON-Darstellung
{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
Felder
type

enum (Type)

Typ des Ereigniszeichens, z.B. Schauspieler oder Regisseur.

name

string

Name des Zeichens.

image

object (Image)

Bilder der Charaktere

Typ

Zeichentyp

Enums
TYPE_UNKNOWN Unbekannter Typ.
ACTOR Akteur:
PERFORMER Künstler.
DIRECTOR Einen Regisseur
ORGANIZER Organisator.