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 Werbebuchung, 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.

PurchaseItemExtension

Positionsinhalte der Branche „Kauf“.

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

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

integer

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

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.

ItemOption

Add-ons oder Unterelemente

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

integer

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. { "allergen": "peanut" }. 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": 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 werden, wenn keine der Typoptionen anwendbar ist.
reservationTime

object (Time)

Zeitpunkt, zu dem die Dienstleistung/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

integer

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

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