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

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.

PurchaseItemExtension

Artikelinhalte der Kaufbranche.

JSON-Darstellung 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": integer,
  "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

integer

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.

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.

ItemOption

Add-ons oder Unterobjekte.

JSON-Darstellung 
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "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

integer

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": integer,
  "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)

die für den Nutzer akzeptabel sind.
confirmationCode

string

Bestätigungscode für diese Reservierung.
partySize

integer

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

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