LineItem

1 element zamówienia zawiera 1 branżę. Zamówienie lub koszyk może zawierać wiele elementów zamówienia z tej samej branży. Podrzędne elementy zamówienia, dodatki itp. powinny być zdefiniowane jako pionowe w zależności od przypadków użycia. Uwaga: 1. Jeśli nie określono inaczej, wszystkie ciągi znaków na wszystkich poziomach muszą mieć mniej niż 1000 znaków. 2. Jeśli nie określono inaczej, liczba wszystkich pól powtarzanych na wszystkich poziomach musi być mniejsza niż 50. 3. Wszystkie sygnatury czasowe na wszystkich poziomach (jeśli zostały podane) muszą być prawidłowymi sygnaturami czasowymi.

Zapis JSON
{
  "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.
}
Pola
id

string

Wymagane: identyfikator elementu zamówienia przypisany przez sprzedawcę. Służy do identyfikowania istniejącego elementu zamówienia podczas stosowania częściowych aktualizacji. Maksymalna dozwolona długość to 64 znaki.

name

string

nazwa pozycji widniejąca na potwierdzeniu. Maksymalna dozwolona długość to 100 znaków.

userVisibleStateLabel
(deprecated)

string

Rola wycofana. Zamiast tego użyj stanu na poziomie branży. W przypadku zakupów użyj np. PurchaseOrderExtension.status. Etykieta widoczna dla użytkownika stanu tego elementu zamówienia.

provider

object (Merchant)

Dostawca konkretnego elementu zamówienia, jeśli różni się od ogólnego zamówienia. Przykład: zamówienie Expedia z ANA dostawcy elementu zamówienia.

priceAttributes[]

object (PriceAttribute)

Cena i dostosowania na poziomie elementu zamówienia.

followUpActions[]

object (Action)

Działania związane z elementem zamówienia.

recipients[]

object (UserInfo)

Klienci na poziomie elementu zamówienia może się różnić od kupującego na poziomie zamówienia. Przykład: użytkownik X dokonał rezerwacji w restauracji na imię i nazwisko użytkownika Y.

image

object (Image)

Mały obraz powiązany z tym elementem (jeśli taki istnieje).

description

string

Opis elementu zamówienia.

notes[]

string

Dodatkowe uwagi dotyczące tego konkretnego elementu zamówienia, na przykład zasady anulowania.

disclosures[]

object (Disclosure)

Oświadczenia związane z tym elementem zamówienia.

vertical
(deprecated)

object

Wycofane: zamiast tego użyj kategorii. Wymagane: semantyczna zawartość elementu zamówienia według jego typu lub branży. Każda branża powinna zawierać własne szczegóły realizacji zamówienia. Musi to być jedna z tych wartości: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.

Pole sumy verticals. Wymagane: semantyczna zawartość elementu zamówienia według jego typu lub branży. Każda branża powinna zawierać własne szczegóły realizacji zamówienia. verticals może mieć tylko jedną z tych wartości:
purchase

object (PurchaseItemExtension)

Zamówienia na towary, jedzenie itp.

reservation

object (ReservationItemExtension)

Rezerwacje, np. w restauracji, strzyżeniu itp.

PurchaseItemExtension

Treść elementu zamówienia w kategorii Zakup.

Zapis JSON
{
  "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)
  }
}
Pola
status

enum (PurchaseStatus)

Wymagany: stan na poziomie elementu zamówienia.

userVisibleStatusLabel

string

Wymagane: użytkownik widzi etykietę/ciąg znaków stanu. Maksymalna dozwolona długość to 50 znaków.

type

enum (PurchaseType)

Wymagany: typ zakupu.

productId
(deprecated)

string

Identyfikator produktu lub oferty powiązany z tym elementem zamówienia.

quantity

integer

Liczba sztuk produktu.

unitMeasure

object (MerchantUnitMeasure)

Miara jednostki. Określa rozmiar produktu w wybranych jednostkach. Rozmiar w połączeniu z aktywną ceną służy do określenia ceny jednostkowej.

returnsInfo

object (PurchaseReturnsInfo)

Zwraca informacje o tym elemencie zamówienia. Jeśli zasada jest nieskonfigurowana, ten element zamówienia dziedziczy informacje o zwrotach na poziomie zamówienia.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informacje o realizacji tego elementu zamówienia. Jeśli nie jest skonfigurowana, ten element zamówienia dziedziczy informacje o realizacji na poziomie zamówienia.

itemOptions[]

object (ItemOption)

dodatkowe dodatki lub elementy podrzędne;

extension

object

dodatkowe pola wymienione między sprzedawcą a Google.

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.

productDetails

object (ProductDetails)

Informacje o produkcie.

MerchantUnitMeasure

Miara ceny jednostkowej sprzedawcy.

Zapis JSON
{
  "measure": number,
  "unit": enum (Unit)
}
Pola
measure

number

Wartość: przykład 1.2.

unit

enum (Unit)

Jednostka: przykładowa wartość POUND, GRAM.

ItemOption

Reprezentuje dodatki lub elementy podrzędne.

Zapis JSON
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Pola
id

string

W przypadku opcji dotyczących produktów: unikalny identyfikator produktu.

name

string

Nazwa opcji.

prices[]

object (PriceAttribute)

Łączna cena opcji.

note

string

Uwaga dotycząca opcji.

quantity

integer

Jeśli chodzi o opcje dotyczące produktów i liczby,

productId

string

Identyfikator produktu lub oferty powiązany z tą opcją.

subOptions[]

object (ItemOption)

Aby zdefiniować inne zagnieżdżone opcje podrzędne.

ProductDetails

Informacje o produkcie.

Zapis JSON
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
Pola
productId

string

Identyfikator produktu lub oferty powiązany z tym elementem zamówienia.

gtin

string

Globalny numer jednostki handlowej produktu. Przydatne, jeśli w Merchant Center nie ma parametru offerId. Opcjonalnie:

plu

string

Kody wyszukiwania cen, nazywane potocznie kodami PLU, numerami PLU, PLU, kodami produkcyjnymi lub etykietami, to system liczb, które jednoznacznie identyfikują produkty hurtowe sprzedawane w sklepach spożywczych i supermarketach.

productType

string

Kategoria produktu zdefiniowana przez sprzedawcę. Na przykład: „Ekran główny > Sklep spożywczy > Nabiał Jajka > Mleko > Mleko pełne”

productAttributes

map (key: string, value: string)

Podane przez sprzedawcę informacje o produkcie, np. { "allergen": "peanut" }. Przydatne, jeśli w Merchant Center nie ma parametru offerId. Opcjonalnie:

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ReservationItemExtension

Treść elementu zamówienia dla zamówień rezerwacji, takich jak restauracja, strzyżenie itp. Następny identyfikator: 15.

Zapis JSON
{
  "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: ...,
    ...
  }
}
Pola
status

enum (ReservationStatus)

Wymagany: stan rezerwacji.

userVisibleStatusLabel

string

Wymagane: użytkownik widzi etykietę/ciąg znaków stanu. Maksymalna dozwolona długość to 50 znaków.

type

enum (ReservationType)

typ rezerwacji. Wartość może być nieskonfigurowana, jeśli żadna z opcji typów nie jest dostępna.

reservationTime

object (Time)

godzina wykonania usługi lub zdarzenia. Może to być zakres czasu, data lub dokładna data i godzina.

userAcceptableTimeRange

object (Time)

akceptowalny dla użytkownika.

confirmationCode

string

Kod potwierdzenia tej rezerwacji.

partySize

integer

Liczba osób.

staffFacilitators[]

object (StaffFacilitator)

Opiekun personelu, który będzie obsługiwać rezerwację. Np. Fryzjer

location

object (Location)

Lokalizacja usługi lub zdarzenia.

extension

object

dodatkowe pola wymienione między sprzedawcą a Google.

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.

StaffFacilitator

Informacje o sprzedawcy.

Zapis JSON
{
  "name": string,
  "image": {
    object (Image)
  }
}
Pola
name

string

Imię i nazwisko opiekuna personelu. Np. „Jan Kowalski”

image

object (Image)

Zdjęcia wykonawcy.