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 über den 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

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.

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

enum (PaymentType)

Die Art der Zahlung.

paymentMethodDisplayName

string

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

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.

PurchaseError

Fehler, bei denen ein Auftrag abgelehnt werden kann.

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

integer

Jetzt verfügbar. Anwendbar bei AVAILABILITY_CHANGED

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

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

EventCharacter

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

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

enum (Type)

Typ der Ereignisfigur, z. B. Schauspieler oder Regisseur

name

string

Namen der Figur.

image

object (Image)

Bilder der Charaktere