Order

Auftragsentität. Hinweis: 1. Sofern nicht anders angegeben, müssen alle Strings auf allen Ebenen weniger als 1.000 Zeichen lang sein. 2. Sofern nicht anders angegeben, müssen alle wiederkehrenden Felder auf allen Ebenen kleiner als 50 sein. 3. Falls angegeben, müssen alle Zeitstempel auf allen Ebenen 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 Aktualisierungen der Bestellung erforderlich. Diese ID kann auf die angegebene googleOrderId oder einen anderen eindeutigen Wert festgelegt werden. Beachten Sie, dass die ID, die Nutzern präsentiert wird, die uservisibleOrderId ist, bei der es sich möglicherweise um einen anderen, nutzerfreundlicheren Wert handelt. Die maximal zulässige Länge beträgt 128 Zeichen.

userVisibleOrderId

string

Die für den Nutzer sichtbare ID, die auf die aktuelle Bestellung verweist. Diese ID sollte mit der ID übereinstimmen, die in anderen Kontexten wie Websites, Apps und E-Mails für diese Bestellung angezeigt wird.

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 des Auftrags. 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 ermöglicht hat. Dieser kann sich von einem Anbieter auf Werbebuchungsebene unterscheiden. Beispiel: Expedia-Auftrag mit Werbebuchung von ANA

contents

object (Contents)

Erforderlich: Auftragsinhalte, die eine Gruppe von Werbebuchungen sind.

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/den vorgeschlagenen Auftrag gelten.

note

string

Notizen, die einer Bestellung zugeordnet sind.

promotions[]

object (Promotion)

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

disclosures[]

object (Disclosure)

Offenlegungen im Zusammenhang mit dieser Bestellung.

vertical
(deprecated)

object

Eingestellt: Verwenden Sie stattdessen Branchen. Diese Eigenschaften gelten für alle Werbebuchungen, sofern sie nicht in einer Werbebuchung ü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 mit Feldern eines beliebigen Typs. 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 nicht in einer Werbebuchung ü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. Dieses Feld wird verwendet, um Informationen des Nutzers darzustellen, 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

Anzeigename des Nutzers, der sich vom Vor- oder Nachnamen unterscheiden kann

phoneNumbers[]

object (PhoneNumber)

Telefonnummern des Nutzers

PhoneNumber

Standarddarstellung der Telefonnummer.

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

string

Telefonnummer im E.164-Format, wie in der Empfehlung E.164 der International Telecommunication Union (ITU) definiert. Wiki-Link: https://en.wikipedia.org/wiki/E.164

extension

string

Die Erweiterung ist in den ITU-Empfehlungen nicht standardisiert, mit der Ausnahme, dass sie als Zahlenfolge mit einer maximalen Länge von 40 Ziffern definiert ist. Er wird hier als String definiert, um die mögliche Verwendung einer führenden Null in der Erweiterung zu berücksichtigen. Organisationen haben dabei völlige Freiheit, da kein Standard definiert ist. Neben Ziffern können hier auch andere Wählzeichen wie „,“ gespeichert werden, die eine Wartezeit anzeigen. Beispiel: In xxx-xxx-xxxx Durchwahl 123 ist „123“ die Durchwahl.

preferredDomesticCarrierCode

string

Der Code zur Auswahl des Mobilfunkanbieters, der bei Anrufen dieser Telefonnummer im Inland bevorzugt wird Dazu gehören auch Codes, die in einigen Ländern gewählt werden müssen, wenn Sie von Festnetz- zu Mobiltelefonen anrufen oder umgekehrt. In Kolumbien muss zum Beispiel bei Anrufen von einem Mobiltelefon zu einem inländischen Festnetz und umgekehrt eine „3“ vor der Telefonnummer gewählt werden. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

Hierbei handelt es sich um den „bevorzugten“ Code, d. h., andere Codes können ebenfalls verwendet werden.

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, die für Barrierefreiheit verwendet werden soll, z.B. Screenreader. Erforderlich.

height

number

Die Höhe des Bilds in Pixeln Optional.

width

number

Die Breite des Bilds in Pixeln Optional.

Händler

Händler für den Einkaufswagen/die Bestellung/die 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 ist, falls vorhanden.

name

string

Der Name des Händlers, z. B. „Panera Bread“.

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)

Geokoordinaten: Erfordert die Berechtigung [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

formattedAddress

string

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

zipCode

string

Postleitzahl. Erfordert die Berechtigung [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 die Berechtigung [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 die Berechtigung [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 Unternehmensstandorts oder Telefonnummer des Lieferorts

notes

string

Hinweise 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 in Ländern, in denen dieses Feld verwendet wird, keine UI-Elemente für die 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 Auftragswerbebuchungen. Mindestens 1 Werbebuchung ist erforderlich, höchstens 50. Alle Werbebuchungen müssen zur selben Branche gehören.

LineItem

Eine Werbebuchung enthält eine Branche. Ein Auftrag oder Einkaufswagen kann mehrere Werbebuchungen derselben Branche enthalten. Unterwerbebuchungen, Add-ons usw. sollten je nach Anwendungsfall in vertikalen Proto-Dateien definiert werden. Hinweis: 1. Sofern nicht anders angegeben, müssen alle Strings auf allen Ebenen weniger als 1.000 Zeichen lang sein. 2. Sofern nicht anders angegeben, müssen alle wiederkehrenden Felder auf allen Ebenen kleiner als 50 sein. 3. Falls angegeben, müssen alle Zeitstempel auf allen Ebenen 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 ID für die Werbebuchung. Wird verwendet, um eine vorhandene Werbebuchung bei der Anwendung 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

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

provider

object (Merchant)

Der Anbieter der jeweiligen Werbebuchung, falls abweichend vom Gesamtauftrag Beispiel: Expedia-Auftrag bei Werbebuchungstyp „ANA“

priceAttributes[]

object (PriceAttribute)

Preis und Anpassungen auf Werbebuchungsebene

followUpActions[]

object (Action)

Follow-up-Aktionen für Werbebuchung.

recipients[]

object (UserInfo)

Für Kunden auf Werbebuchungsebene kann dieser Wert vom Käufer auf Auftragsebene abweichen. Beispiel: Nutzer X hat eine Restaurantreservierung unter dem Namen von Nutzer Y vorgenommen.

image

object (Image)

Kleines, mit diesem Element verknüpftes Bild, falls vorhanden

description

string

Beschreibung der Werbebuchung.

notes[]

string

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

disclosures[]

object (Disclosure)

Offenlegungen im Zusammenhang mit dieser Position.

vertical
(deprecated)

object

Eingestellt: Verwenden Sie stattdessen Branchen. Erforderlich: Semantischer Content der Werbebuchung basierend auf Typ/Branche Jede Branche sollte eigene Details zur Auftragsausführung enthalten. 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 mit Feldern eines beliebigen Typs. 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: Semantischer Content der Werbebuchung basierend auf Typ/Branche Jede Branche sollte eigene Details zur Auftragsausführung enthalten. Für verticals ist nur einer der folgenden Werte zulässig:
purchase

object (PurchaseItemExtension)

Bestellungen wie Waren, Essen usw.

reservation

object (ReservationItemExtension)

Reservierungsbestellungen wie Restaurant, Friseur usw.

PriceAttribute

Preisattribut einer Bestellung oder 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: Attribut für die Art des Geldes.

name

string

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

state

enum (State)

Erforderlich: Status des Preises: Schätzung vs. tatsächlicher Preis

taxIncluded

boolean

Gibt an, ob der Preis inklusive Steuern ist.

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

object (Money)

Geldbetrag.

amountMillipercentage
(deprecated)

number

Die Prozentspezifikation zu 1/1000 Prozent. Beispiel: 8,750% wird als 8.750 dargestellt, negative Prozentsätze für Rabatte in Prozent. Dieses Feld wird verworfen. Wenn ein solider Anwendungsfall erforderlich ist, können Sie das Video wieder hinzufügen.

Typ

Der Geldtyp.

Enums
TYPE_UNSPECIFIED Der Typ ist nicht angegeben. Clients sollten ihn nicht explizit festlegen.
REGULAR Regulärer Preis, bevor Rabatte angewendet werden.
DISCOUNT Wird von der Zwischensumme abgezogen.
TAX Wird der Zwischensumme hinzugefügt.
DELIVERY Wird der Zwischensumme hinzugefügt.
SUBTOTAL Zwischensumme, bevor Gebühren anfallen können.
FEE Etwaige zusätzliche Gebühren.
GRATUITY Wird der Zwischensumme hinzugefügt.
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 Tatsächlicher Preis, der dem Nutzer berechnet wird.

Geldbetrag

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 als 1990000 für 1, 99 $festgelegt werden.

Aktion

Eine Folgeaktion in Bezug auf den Auftrag oder die Werbebuchung.

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

enum (Type)

Erforderlich: Art der Aktion.

title

string

Titel oder Label der Aktion, 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 angegebene Aktion.
VIEW_DETAILS Aktion „Bestelldetails ansehen“.
MODIFY Aktion zum Ändern der Bestellung.
CANCEL Bestellaktion abbrechen.
RETURN Aktion für Rückgabebestellung.
EXCHANGE Aktion für Anzeigenplattform-Bestellung.
EMAIL

E-Mail-Aktion. Die Typen EMAIL und CALL werden nicht mehr unterstützt. openUrlAction.url kann als Telefonnummer oder E-Mail-Adresse verwendet werden.

CALL

Anrufaktion.

REORDER Aktion „Neu anordnen“.
REVIEW Bestellaktion überprüfen.
CUSTOMER_SERVICE Kundenservice kontaktieren.
FIX_ISSUE Verweisen Sie auf die Website oder App des Händlers, um das Problem zu beheben.
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, das einen der folgenden Werte annehmen kann: – HTTP- oder HTTPS-URLs zum Öffnen einer mit der App 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 bei der 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 die Anwendung durch jede Filterübereinstimmung ausgelöst.

VersionFilter

VersionFilter sollte einbezogen werden, wenn bestimmte Versionen der Anwendung erforderlich sind.

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

number

Mindestversionscode oder 0 (einschließlich).

maxVersion

number

Code für die maximale Version (einschließlich). Der berücksichtigte Bereich ist [minVersion:maxVersion]. Ein Nullbereich gilt für jede Version. Beispiele: Um eine einzelne Version anzugeben, verwenden Sie: [target_version:target_version]. Wenn Sie eine beliebige Version angeben möchten, lassen Sie „minVersion“ und „maxVersion“ nicht angegeben. Wenn Sie alle Versionen bis „maxVersion“ angeben möchten, geben Sie „minVersion“ nicht an. Wenn Sie alle Versionen aus „minVersion“ angeben möchten, geben Sie für „maxVersion“ keine Angabe.

UrlTypeHint

Verschiedene Arten von URL-Hinweisen.

Enums
URL_TYPE_HINT_UNSPECIFIED Ohne Angabe
AMP_CONTENT URL, die direkt auf AMP-Inhalte verweist, oder auf eine kanonische URL, 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

Informationen zu 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 erlaubt.

presentationOptions

object (DisclosurePresentationOptions)

Darstellungsoptionen für die Offenlegung.

DisclosureText

Stellt einen einfachen 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 einzufügenden Textlink. Beispiel: „WARNUNG: Dieses Produkt kann Chemikalien ausgesetzt werden, die laut dem US-Bundesstaat Kalifornien Krebs verursachen können. Weitere Informationen finden Sie unter {0}." Dieser Offenlegungstext darf keine Werbeinhalte 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 Offenlegung muss vorgelegt werden.

initiallyExpanded

boolean

Gibt an, ob der Inhalt der Offenlegung anfangs erweitert werden soll. Standardmäßig ist sie zunächst minimiert.

PresentationRequirement

Voraussetzung für die Präsentation der Offenlegung.

Enums
REQUIREMENT_UNSPECIFIED Nicht angegebene Anforderung. Sollte nicht explizit festgelegt werden.
REQUIREMENT_OPTIONAL Die Offenlegung ist optional. Sie kann übersprungen werden, wenn das Gerät die Anzeige von Offenlegungen nicht unterstützt.
REQUIREMENT_REQUIRED Die Offenlegung ist erforderlich. Wenn das Gerät die Darstellung von Offenlegungen nicht unterstützt, wird für das Gespräch eine Punt-to-Phone-Antwort ausgeführt.

PurchaseItemExtension

Artikelinhalte der Kaufbranche.

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

Produkt- oder Angebots-ID, die dieser Werbebuchung zugeordnet ist.

quantity

number

Menge des Artikels

unitMeasure

object (MerchantUnitMeasure)

Maßeinheit. Gibt die Größe des Artikels in ausgewählten Einheiten an. Die Größe ergibt zusammen mit dem aktiven Preis den Preis pro Einheit.

returnsInfo

object (PurchaseReturnsInfo)

Gibt Informationen zu dieser Werbebuchung zurück. Wenn kein Wert festgelegt ist, übernimmt diese Werbebuchung Rückgabeinformationen auf Auftragsebene.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informationen zur Auftragsausführung für diese Werbebuchung. Wenn kein Wert festgelegt ist, übernimmt diese Werbebuchung Informationen zur Auftragsausführung auf Auftragsebene.

itemOptions[]

object (ItemOption)

Zusätzliche Add-ons oder Unterobjekte.

extension

object

Alle zusätzlichen Felder, die zwischen Händler und Google ausgetauscht werden

Ein Objekt mit Feldern eines beliebigen Typs. 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" kann in einem anderen Kontext unterschiedliche Bedeutungen haben. Bei der FOOD-Bestellung könnte es sein, dass das Essen vorbereitet wird. Im Einzelhandel könnte es 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 den Auftrag oder die Werbebuchung abgelehnt.
RETURNED Der Artikel wurde vom Nutzer zurückgegeben.
CANCELLED Der Auftrag oder die Werbebuchung wurde vom Nutzer storniert.
CHANGE_REQUESTED Der Nutzer hat eine Änderung an der Bestellung angefordert und der Integrator verarbeitet diese Änderung. Die Bestellung sollte nach der Verarbeitung der Anfrage in einen anderen Status verschoben werden.

PurchaseType

Die Kaufkategorie.

Enums
PURCHASE_TYPE_UNSPECIFIED Unbekannter Wert.
RETAIL Dazu gehören Käufe wie physische Waren.
FOOD Dazu gehören auch Essensbestellungen.
GROCERY Einkauf von Lebensmitteln.
MOBILE_RECHARGE Kauf eines Prepaidguthabens.

MerchantUnitMeasure

Mengeneinheit des Preises pro Einheit 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 ein 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 Tage möglich.

policyUrl

string

Link zu den Rückgabebedingungen.

PurchaseFulfillmentInfo

Informationen zur Auftragsausführung, die mit einem Auftrag oder einer bestimmten Position 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 Serviceoption.

fulfillmentType

enum (Type)

Erforderlich: Der Auftragsausführungstyp.

expectedFulfillmentTime

object (Time)

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

expectedPreparationTime

object (Time)

Ein Fenster, wenn ein Zeitraum angegeben ist, oder eine ETA, wenn eine einzelne Zeit angegeben ist. Voraussichtliche Zeit für die Zubereitung des Essens. Einmalig bevorzugt.

location

object (Location)

Abhol- oder Lieferort.

expireTime

string (Timestamp format)

Zeit, zu der 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 Versandmethode, die der Nutzer ausgewählt hat.

storeCode

string

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

pickupInfo

object (PickupInfo)

Zusätzliche Informationen zur Auswahl der Bestellung. Dieses Feld ist nur anwendbar, wenn der Auftragsausführungstyp PICKUP ist.

Typ

Ausführungstyp.

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

Zeit

Zeitkonstrukt zur Darstellung der Zeit eines Ereignisses, das beim Anzeigen einer Bestellung für den Nutzer verwendet werden soll.

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

string

Stellt eine Bestellereigniszeit wie die Reservierungszeit, die Lieferzeit usw. dar. Dabei kann es sich um eine Dauer (Start- und Endzeit), nur das Datum, die Uhrzeit usw. 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 für jeden Typ.

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

enum (PickupType)

Abholoption, z. B. INSTORE, CURBSIDE usw.

curbsideInfo

object (CurbsideInfo)

Spezifische Details zu den Informationen zum Straßenrand. Wenn pickupType nicht „CURBSIDE“ ist, wird dieses Feld ignoriert.

checkInInfo[]

object (CheckInInfo)

Liste der verschiedenen Methoden, die vom Partner für den Check-in unterstützt werden.

PickupType

Liste der unterstützten Abholtypen.

Enums
UNSPECIFIED Abholtyp nicht angegeben.
INSTORE Essen im Restaurant abholen.
CURBSIDE Parken Sie das Fahrzeug an einer ausgewiesenen Stelle vor dem Restaurant, damit dort Essen geliefert wird.

CurbsideInfo

Details dazu, wie die Bestellung vor dem Laden abgewickelt wird

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 vom ausgewählten Auftragsausführungstyp werden entsprechende Daten vom Nutzer erhoben.

userVehicle

object (Vehicle)

Fahrzeugdetails des Nutzers, der die Bestellung aufgibt.

CurbsideFulfillmentType

Mögliche Werte der Auftragsausführungstypen vor dem Laden.

Enums
UNSPECIFIED Art der Auftragsausführung vor dem Laden nicht angegeben.
VEHICLE_DETAIL Für die Abholung vor dem Laden sind Fahrzeugdetails 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“). Dieser wird dem Nutzer angezeigt und muss lokalisiert werden. Erforderlich.

model

string

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

licensePlate

string

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

colorName

string

Farbname des Fahrzeugs, z. B. Schwarz (optional).

image

object (Image)

URL zu einem Foto des Fahrzeugs. Das Foto wird mit einer Größe von etwa 256 x 256 Pixel angezeigt. Muss im JPG- oder PNG-Format vorliegen. Optional.

CheckInInfo

Metadaten, die vom Partner benötigt werden, um eine Check-in-Methode zu unterstützen.

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

enum (CheckInType)

Methode zum Senden von Check-in-Anweisungen.

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

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

string

Für Optionen, die Artikel sind, die eindeutige Artikel-ID

name

string

Optionsname.

prices[]

object (PriceAttribute)

Gesamtpreis der Option.

note

string

Hinweis zu der Option.

quantity

number

Für Optionen, nämlich Artikel, Menge

productId

string

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

Produkt- oder Angebots-ID, die dieser Werbebuchung zugeordnet ist.

gtin

string

Global Trade Item Number des Produkts. Dies ist hilfreich, wenn im Merchant Center keine Angebots-ID vorhanden ist. Optional.

plu

string

Preissuchcodes, allgemein als PLU-Codes, PLU-Nummern, PLUs, Produkcodes oder Etiketten bezeichnet, sind ein Zahlensystem, das in Lebensmittelgeschäften und Supermärkten verkaufte Großpackungen eindeutig identifiziert.

productType

string

Vom Händler definierte Produktkategorie. Beispiel: „Startseite > Lebensmittel > Milchprodukte & Eier > Milch > Vollmilch“

productAttributes

map (key: string, value: string)

Vom Händler bereitgestellte Details zum Produkt, z.B. { "allergen": "erdnuss" }. Nützlich, wenn im Merchant Center keine Angebots-ID 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 Reservierungsaufträge 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 sein, wenn keine der Typoptionen anwendbar ist.

reservationTime

object (Time)

Uhrzeit, zu der die Dienstleistung bzw. das Ereignis geplant ist. Dabei kann es sich um einen Zeitraum, ein Datum oder ein genaues Datum und eine 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)

Moderatoren, die für die Reservierung zuständig sind. Beispiel: Der Friseur.

location

object (Location)

Ort der Dienstleistung/Veranstaltung

extension

object

Alle zusätzlichen Felder, die zwischen Händler und Google ausgetauscht werden

Ein Objekt mit Feldern eines beliebigen Typs. 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 Nicht angegebener Status.
PENDING Die Reservierung steht aus.
CONFIRMED Die Reservierung ist bestätigt.
CANCELLED Die Reservierung wird vom Nutzer storniert.
FULFILLED Die Reservierung wurde erfüllt.
CHANGE_REQUESTED Änderung der Reservierung wurde angefordert
REJECTED Die Reservierung ist entweder abgelaufen oder wurde vom Integrator abgelehnt.

ReservationType

Art der Reservierung.

Enums
RESERVATION_TYPE_UNSPECIFIED Nicht definierter Typ.
RESTAURANT Restaurantreservierung.
HAIRDRESSER Reservierung beim Friseur.

StaffFacilitator

Informationen zur Soldaten.

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

string

Der Name der moderierenden Person. Beispiel: „Max Mustermann“

image

object (Image)

Bilder des Künstlers

PaymentData

Zahlungsdaten 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 Interaktion mit dem Nutzer hilfreich sind.

PaymentResult

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 sind entweder Google-Zahlungsdaten oder die Zahlungsmethode des Händlers angegeben. Für result ist nur einer der folgenden Werte zulässig:
googlePaymentData

string

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

merchantPaymentMethodId

string

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

PaymentInfo

Zahlungsinformationen zur aufgegebenen Bestellung Dieses Proto erfasst Informationen, die für die Interaktion mit Nutzenden nützlich sind.

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

object (PaymentMethodDisplayInfo)

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

paymentMethodProvenance

enum (PaymentMethodProvenance)

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

PaymentMethodDisplayInfo

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 auf Geräten mit Sprachassistenten vorgelesen wird. Beispiele: „Visum mit den Endziffern eins zwei drei vier“ oder „Girokonto mit den Endziffern fünf sechs sieben acht“. Hinweis: Dies ist der sprachoptimierte String, der anstelle des paymentMethodDisplayName für Geräte mit Sprachassistenten verwendet wird. Wenn dieser String nicht festgelegt ist, wird „paymentMethodDisplayName“ dem Nutzer ausgesprochen.

PaymentType

PaymentType gibt das Zahlungsmittel an, das 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 Zahlungsart 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 gilt Bargeld.
GIFT_CARD Die Zahlungsmethode ist eine Geschenkkarte.
WALLET Drittanbieter-Wallet, z.B. PayPal

PaymentMethodProvenance

Gibt die Herkunft der Zahlungsmethode an, die für die Transaktion verwendet wurde.

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

Werbung

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

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

string

Erforderlich: Gutscheincode, der auf dieses Angebot angewendet wird.

PurchaseOrderExtension

Bestellerweiterung für die Kaufbranche. Diese Eigenschaften gelten für alle Werbebuchungen im Auftrag, sofern sie in einer Werbebuchung nicht ü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 für die Bestellung.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informationen zur Auftragsausführung für die Bestellung.

extension

object

Alle zusätzlichen Felder, die zwischen Händler und Google ausgetauscht werden

Ein Objekt mit Feldern eines beliebigen Typs. 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 wurden online gekauft.
INSTORE_PURCHASE Alle Käufe im Geschäft.

PurchaseError

Fehler, bei denen ein Auftrag abgelehnt werden kann.

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

enum (ErrorType)

Erforderlich: Gibt den genauen Grund an, warum eine Bestellung vom Händler abgelehnt wird.

description

string

Zusätzliche Fehlerbeschreibung.

entityId

string

Entitäts-ID, die dem Fehler entspricht. Beispiel: „LineItemId“ oder „ItemOptionId“.

updatedPrice

object (PriceAttribute)

Relevant bei dem Fehlertyp PRICE_CHANGED / INCORRECT_PRICE.

availableQuantity

number

Jetzt verfügbar. Anwendbar bei AVAILABILITY_CHANGED

ErrorType

Mögliche Fehlertypen.

Enums
ERROR_TYPE_UNSPECIFIED Unbekannter Fehler
NOT_FOUND Entität nicht gefunden, könnte Artikel, FulfillmentOption oder Promotion sein. Entitäts-ID erforderlich.
INVALID Entitätsdaten ungültig. könnten Artikel, FulfillmentOption oder Promotion sein. 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 Elemententität. Die Entitäts-ID und der aktualisierte Preis sind erforderlich.
INCORRECT_PRICE Preisfehler in den Gebühren, insgesamt. Die Entitäts-ID und der aktualisierte Preis sind erforderlich.
REQUIREMENTS_NOT_MET Bedingungen für die Annahme der Bestellung nicht erfüllt – Mindestbestellmenge usw.
TOO_LATE Auftragsausführungsoption abgelaufen.
NO_CAPACITY Keine Dienstkapazität verfügbar.
INELIGIBLE Nutzer kann keine Bestellung aufgeben (auf schwarzer Liste).
OUT_OF_SERVICE_AREA Lieferung an die gewünschte Adresse aufgrund von Grenzregelungen usw. nicht möglich.
CLOSED Das Restaurant ist während der Bestellung geschlossen.
PROMO_NOT_APPLICABLE Generischer Fehlercode, um alle Fälle zu erfassen, in denen der Gutscheincode nicht eingelöst wird, falls keiner der folgenden Punkte zutrifft. 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, weil 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 Dieser Gutschein kann nicht für die aktuelle Bestellung eingelöst werden. Fügen Sie den Gutscheincode als Entitäts-ID hinzu.
UNAVAILABLE_SLOT Der Slot für die Vorbestellungen ist nicht verfügbar.
FAILED_PRECONDITION Bedingungen für die Annahme der Bestellung nicht erfüllt - Mindestbestellmenge für Warenkorb usw.
PAYMENT_DECLINED Ungültige Zahlung.
MERCHANT_UNREACHABLE Der Händler ist nicht erreichbar. Das ist hilfreich, wenn ein Partner ein Aggregator ist und den Händler nicht erreichen konnte.

TicketOrderExtension

Bestelle Inhalte für Ticketbestellungen wie Kino, Sport usw.

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

object (TicketEvent)

Das Ereignis, das auf alle Werbebuchungstickets angewendet wurde.

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: Art des Ticketereignisses, z. B. Film, Konzert

name

string

Erforderlich: Name des Ereignisses Wenn das Ereignis beispielsweise ein Film ist, sollte dies der Filmname sein.

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 im Zusammenhang mit diesem Ereignis. Das können Regisseure oder Schauspieler eines Filmereignisses oder Darsteller eines Konzerts sein.

startDate

object (Time)

Start.

endDate

object (Time)

Ende.

doorTime

object (Time)

Eintrittszeitpunkt, der sich von der Startzeit der Veranstaltung unterscheiden kann, z. B. um 9:00 Uhr, aber um 8:30 Uhr.

Typ

Der Typ des Ereignisses.

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

EventCharacter

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

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

enum (Type)

Typ des Ereignischarakters, z. B. Schauspieler oder Regisseur

name

string

Name der Figur.

image

object (Image)

Bilder der Charaktere

Typ

Zeichentyp.

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