LineItem

Satu item baris berisi satu kategori. Pesanan atau keranjang dapat memiliki beberapa item baris dari vertical yang sama. Item sub-baris/add-on, dll. harus ditentukan dalam proto vertikal, bergantung pada kasus penggunaannya. Catatan: 1. Semua string di semua level harus kurang dari 1.000 karakter kecuali jika ditentukan lain. 2. Semua kolom berulang di semua level harus berjumlah kurang dari 50 kecuali jika ditentukan lain. 3. Semua stempel waktu di semua level, jika ditentukan, harus berupa stempel waktu yang valid.

Representasi 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.
}
Kolom
id

string

Wajib: ID yang ditetapkan penjual untuk item baris. Digunakan untuk mengidentifikasi item baris yang sudah ada dalam menerapkan pembaruan sebagian. Panjang maksimum yang diizinkan adalah 64 karakter.

name

string

nama item baris sebagaimana ditampilkan di tanda terima. Panjang maksimum yang diizinkan adalah 100 karakter.

userVisibleStateLabel
(deprecated)

string

Tidak digunakan lagi. Gunakan status tingkat vertikal. Misalnya, untuk pembelian, gunakan PurchaseOrderExtension.status. Label yang terlihat oleh pengguna untuk status item baris ini.

provider

object (Merchant)

Penyedia item baris tertentu, jika berbeda dari pesanan keseluruhan. Contoh: Pesanan Habis Masa Berlaku dengan ANA penyedia item baris.

priceAttributes[]

object (PriceAttribute)

Harga dan penyesuaian tingkat item baris.

followUpActions[]

object (Action)

Tindakan lanjutan pada item baris.

recipients[]

object (UserInfo)

Pelanggan tingkat item baris, ini bisa berbeda dari pembeli tingkat Pesanan. Contoh: Pengguna X melakukan reservasi restoran dengan nama pengguna Y.

image

object (Image)

Gambar kecil yang terkait dengan item ini, jika ada.

description

string

Deskripsi item baris.

notes[]

string

Catatan tambahan yang berlaku untuk item baris khusus ini, misalnya kebijakan pembatalan.

disclosures[]

object (Disclosure)

Pengungkapan yang terkait dengan item baris ini.

vertical
(deprecated)

object

Tidak digunakan lagi: Gunakan vertical. Wajib: Konten Semantik item baris berdasarkan jenis/vertikalnya. Setiap vertical harus menyertakan detail fulfillment-nya sendiri. Harus berupa salah satu dari nilai berikut: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

Kolom union verticals. Wajib: Konten Semantik item baris berdasarkan jenis/vertikalnya. Setiap vertical harus menyertakan detail fulfillment-nya sendiri. verticals hanya ada berupa salah satu diantara berikut:
purchase

object (PurchaseItemExtension)

Membeli pesanan seperti barang, makanan, dll.

reservation

object (ReservationItemExtension)

Pesanan reservasi seperti restoran, potong rambut, dll.

PurchaseItemExtension

Konten item baris Vertikal Pembelian.

Representasi 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)
  }
}
Kolom
status

enum (PurchaseStatus)

Wajib: Status tingkat item baris.

userVisibleStatusLabel

string

Wajib: Label/string yang terlihat oleh pengguna untuk status. Panjang maksimal yang diizinkan adalah 50 karakter.

type

enum (PurchaseType)

Wajib: jenis pembelian.

productId
(deprecated)

string

ID produk atau penawaran yang terkait dengan item baris ini.

quantity

integer

Jumlah item.

unitMeasure

object (MerchantUnitMeasure)

Ukuran satuan. Menentukan ukuran item dalam unit yang dipilih. Ukuran beserta harga aktif digunakan untuk menentukan harga satuan.

returnsInfo

object (PurchaseReturnsInfo)

Menampilkan info untuk item baris ini. Jika tidak disetel, item baris ini akan mewarisi info tampilan tingkat pesanan.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Info pemenuhan untuk item baris ini. Jika tidak disetel, item baris ini akan mewarisi info pemenuhan tingkat pesanan.

itemOptions[]

object (ItemOption)

Add-on atau sub-item tambahan.

extension

object

Kolom tambahan apa pun yang dipertukarkan antara penjual dan Google.

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

productDetails

object (ProductDetails)

Detail tentang produk.

MerchantUnitMeasure

Ukuran unit produk penjual.

Representasi JSON
{
  "measure": number,
  "unit": enum (Unit)
}
Kolom
measure

number

Nilai: Contoh 1.2.

unit

enum (Unit)

Unit: Contoh POUND, GRAM.

ItemOption

Mewakili add-on atau sub-item.

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

string

Untuk opsi yang berupa item, ID item unik.

name

string

Nama opsi.

prices[]

object (PriceAttribute)

Total harga opsi.

note

string

Catatan terkait dengan opsi.

quantity

integer

Untuk opsi yang berupa item, jumlah.

productId

string

ID produk atau penawaran yang terkait dengan opsi ini.

subOptions[]

object (ItemOption)

Untuk menentukan subopsi bertingkat lainnya.

ProductDetails

Detail tentang produk.

Representasi JSON
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
Kolom
productId

string

ID produk atau penawaran yang terkait dengan item baris ini.

gtin

string

Nomor Barang Perdagangan Global (GTIN) dari produk. Berguna jika offerId tidak ada di Merchant Center. Opsional.

plu

string

Kode pencarian harga, biasa disebut kode PLU, nomor PLU, PLU, kode produksi, atau label produksi, adalah sistem angka yang secara unik mengidentifikasi produk dalam curah yang dijual di toko bahan makanan dan supermarket.

productType

string

Kategori produk yang ditentukan oleh penjual. Misalnya, "Home > Grocery > Susu & Telur > Susu > Susu Utuh"

productAttributes

map (key: string, value: string)

Detail yang disediakan penjual tentang produk, mis. { "allergen": "peanut" }. Berguna jika offerId tidak ada di Merchant Center. Opsional.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ReservationItemExtension

Konten item baris untuk pesanan reservasi seperti restoran, potong rambut, dll. ID berikutnya: 15.

Representasi 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: ...,
    ...
  }
}
Kolom
status

enum (ReservationStatus)

Wajib: Status reservasi.

userVisibleStatusLabel

string

Wajib: Label/string yang terlihat oleh pengguna untuk status. Panjang maksimal yang diizinkan adalah 50 karakter.

type

enum (ReservationType)

jenis reservasi. Dapat dibatalkan penetapannya jika tidak ada opsi jenis yang berlaku.

reservationTime

object (Time)

waktu layanan/peristiwa dijadwalkan. Dapat berupa rentang waktu, tanggal, atau waktu tanggal yang tepat.

userAcceptableTimeRange

object (Time)

rentang waktu yang dapat diterima oleh pengguna.

confirmationCode

string

Kode konfirmasi untuk reservasi ini.

partySize

integer

Jumlah orang.

staffFacilitators[]

object (StaffFacilitator)

Fasilitator staf yang akan melayani reservasi. Mis., Penata rambut.

location

object (Location)

Lokasi layanan/peristiwa.

extension

object

Kolom tambahan apa pun yang dipertukarkan antara penjual dan Google.

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

StaffFacilitator

Informasi tentang staf layanan.

Representasi JSON
{
  "name": string,
  "image": {
    object (Image)
  }
}
Kolom
name

string

Nama fasilitator staf. Mis., "John Smith"

image

object (Image)

Gambar pengisi acara.