LineItem

Jeden element zamówienia zawiera 1 branżę. Zamówienie lub koszyk może zawierać wiele elementów zamówienia tej samej branży. Podrzędne elementy zamówienia, dodatki itp. powinny być zdefiniowane w protosach pionowych w zależności od przypadków użycia. Uwaga: 1. Jeśli nie określono inaczej, żaden ciąg znaków na każdym poziomie musi 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 są określone) 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

nazwy elementu zamówienia w takiej samej postaci jak na potwierdzeniu. Maksymalna dozwolona długość to 100 znaków.
userVisibleStateLabel
(deprecated)

string

Rola wycofana. Użyj stanu na poziomie branży. Na przykład w przypadku zakupów należy użyć parametru purchaseOrderExtension.status. Etykieta widoczna dla użytkownika wskazująca stan tego elementu zamówienia.
provider

object (Merchant)

Dostawca danego elementu zamówienia, jeśli jest inny niż cały zamówienie. 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)

Dalsze działania związane z elementem zamówienia.
recipients[]

object (UserInfo)

klientów na poziomie elementu zamówienia, może on być inny niż kupujący na poziomie zamówienia. Przykład: użytkownik X dokonał rezerwacji w restauracji pod nazwą 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 elementu zamówienia, np. zasady anulowania;
disclosures[]

object (Disclosure)

Oświadczenia powiązane z tym elementem zamówienia.
vertical
(deprecated)

object

Wycofane: używaj branż. Wymagane: semantyczne treści elementu zamówienia określone na podstawie jego typu lub branży. Każda branża powinna mieć własne szczegóły realizacji zamówienia. Musi mieć jedną 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: semantyczne treści elementu zamówienia określone na podstawie jego typu lub branży. Każda branża powinna mieć własne szczegóły realizacji zamówienia. verticals może mieć tylko jedną z tych wartości:
purchase

object (PurchaseItemExtension)

Zamówienia takie jak towary, jedzenie itp.
reservation

object (ReservationItemExtension)

Rezerwacje w restauracji, strzyżeniu itp.

PurchaseItemExtension

Zawartość elementu zamówienia z branży zakupów.

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)

Wymagane: stan na poziomie elementu zamówienia.
userVisibleStatusLabel

string

Wymagane: etykieta/ciąg znaków widoczna dla użytkownika. Maksymalna dozwolona długość to 50 znaków.
type

enum (PurchaseType)

Wymagany: typ zakupu.
productId
(deprecated)

string

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

integer

Liczba sztuk produktu.
unitMeasure

object (MerchantUnitMeasure)

Miara jednostkowa. Określa rozmiar produktu w wybranych jednostkach. Rozmiar wraz z aktywną ceną służy do określania ceny jednostkowej.
returnsInfo

object (PurchaseReturnsInfo)

Zwraca informacje o tym elemencie zamówienia. Jeśli nie jest skonfigurowana, ten element zamówienia dziedziczy zwracane informacje 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

Wszelkie 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 przez sprzedawcę.

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

number

Wartość: przykład 1.2.
unit

enum (Unit)

Jednostka: przykład 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, które są elementami, unikalny identyfikator elementu.
name

string

Nazwa opcji.
prices[]

object (PriceAttribute)

Łączna cena opcji.
note

string

Uwagi na temat opcji.
quantity

integer

W przypadku opcji, które są elementami, liczba sztuk.
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 elementem zamówienia.
gtin

string

Globalny numer jednostki handlowej produktu. Ta opcja jest przydatna, jeśli w Merchant Center nie ma atrybutu offerId. Opcjonalnie.
plu

string

Kody wyszukiwania cen, powszechnie nazywane kodami PLU, numerami PLU, PLU, kody do produkcji lub etykiety, to system liczb, które jednoznacznie identyfikują produkty sprzedawane hurtowo w sklepach spożywczych i supermarketach.
productType

string

Kategoria produktu zdefiniowana przez sprzedawcę. Przykład: „Dom > Spożywcze > Nabiał i jajka > Mleko > Mleko pełnotłuste”
productAttributes

map (key: string, value: string)

Podane przez sprzedawcę informacje o produkcie, np. { "allergen": "peanut" }. Ta opcja jest przydatna, jeśli w Merchant Center nie ma atrybutu offerId. Opcjonalnie.

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

ReservationItemExtension

Zawartość elementu zamówienia dla zamówień z rezerwacją, takich jak restauracja, fryzjer 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)

Wymagane: stan rezerwacji.
userVisibleStatusLabel

string

Wymagane: etykieta/ciąg znaków widoczna dla użytkownika. Maksymalna dozwolona długość to 50 znaków.
type

enum (ReservationType)

typ rezerwacji. Wartość może być nieskonfigurowana, jeśli nie ma zastosowania żadna z opcji typu.
reservationTime

object (Time)

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

object (Time)

przedział czasu akceptowalny dla użytkownika.
confirmationCode

string

Kod potwierdzenia rezerwacji.
partySize

integer

Liczba osób.
staffFacilitators[]

object (StaffFacilitator)

Opiekunowie personelu, którzy będą obsługiwać rezerwację. Np. Fryzjer.
location

object (Location)

Lokalizacja usługi lub zdarzenia.
extension

object

Wszelkie 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 osobie obsługującej.

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

string

Imię i nazwisko opiekuna pracownika. Np. „Jan Kowalski”
image

object (Image)

Obrazy wykonawcy.