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

Inhalt

Wrapper für Werbebuchungen.

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

object (LineItem)

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

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 durch 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
}
Felder
paymentType

enum (PaymentType)

Die Art der Zahlung.
paymentMethodDisplayName

string

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

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.

PurchaseError

Fehler, aufgrund derer ein Auftrag abgelehnt werden kann.

JSON-Darstellung 
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}
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

integer

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

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 des Ereignisses.
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.

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