Order

Entitas pesanan. 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
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
Kolom
googleOrderId

string

ID pesanan yang ditetapkan Google.

merchantOrderId

string

Wajib: ID pesanan internal yang ditetapkan penjual. ID ini harus unik, dan diperlukan untuk operasi pembaruan pesanan berikutnya. ID ini dapat ditetapkan ke googleOrderId yang diberikan, atau nilai unik lainnya. Perhatikan bahwa ID yang ditampilkan kepada pengguna adalah userVisibleOrderId, yang mungkin merupakan nilai berbeda yang lebih mudah digunakan. Panjang maksimum yang diizinkan adalah 128 karakter.

userVisibleOrderId

string

ID yang dilihat pengguna yang merujuk ke pesanan saat ini. Id ini harus konsisten dengan id yang ditampilkan untuk urutan ini dalam konteks lain, termasuk situs web, aplikasi, dan email.

userVisibleStateLabel
(deprecated)

string

Tidak digunakan lagi: Sebagai gantinya, gunakan status OrderExtensions. Label yang terlihat oleh pengguna untuk status pesanan ini.

buyerInfo

object (UserInfo)

Info tentang pembeli.

image

object (Image)

Gambar yang terkait dengan pesanan.

createTime

string (Timestamp format)

Wajib: Tanggal dan waktu pesanan dibuat.

Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

Tanggal dan waktu pesanan terakhir diperbarui. Diperlukan untuk OrderUpdate.

Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2014-10-02T15:01:23.045123456Z".

transactionMerchant

object (Merchant)

Penjual yang memfasilitasi checkout. Ini dapat berbeda dari penyedia tingkat item baris. Contoh: Pesanan Expedia dengan item baris dari ANA.

contents

object (Contents)

Wajib: Pesan konten yang merupakan kelompok item baris.

priceAttributes[]

object (PriceAttribute)

Harga, diskon, pajak, dan sebagainya.

followUpActions[]

object (Action)

Tindak lanjuti tindakan di tingkat pesanan.

paymentData

object (PaymentData)

Data terkait pembayaran untuk pesanan.

termsOfServiceUrl

string

Link ke persyaratan layanan yang berlaku untuk pesanan/pesanan yang diajukan.

note

string

Catatan dilampirkan ke pesanan.

promotions[]

object (Promotion)

Semua promosi yang terkait dengan pesanan ini.

disclosures[]

object (Disclosure)

Pengungkapan yang terkait dengan pesanan ini.

vertical
(deprecated)

object

Tidak digunakan lagi: Gunakan vertical. Properti ini akan diterapkan ke semua item baris, kecuali jika diganti di beberapa item baris. Vertical ini harus cocok dengan jenis vertical tingkat item baris. Nilai yang mungkin: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

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. Properti ini akan diterapkan ke semua item baris, kecuali jika diganti di beberapa item baris. Vertical ini harus cocok dengan jenis vertical tingkat item baris. verticals hanya ada berupa salah satu diantara berikut:
purchase

object (PurchaseOrderExtension)

Pesanan pembelian (PO)

ticket

object (TicketOrderExtension)

Pesanan tiket

UserInfo

Informasi tentang pengguna. Hal ini digunakan untuk menampilkan informasi pengguna yang terkait dengan pesanan.

Representasi JSON
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
Kolom
email

string

Email pengguna, Mis: janedoe@gmail.com.

firstName

string

Nama depan pengguna.

lastName

string

Nama belakang pengguna.

displayName

string

Nama tampilan pengguna, mungkin berbeda dari nama depan atau nama belakang.

phoneNumbers[]

object (PhoneNumber)

Nomor telepon pengguna.

PhoneNumber

Representasi nomor telepon standar.

Representasi JSON
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
Kolom
e164PhoneNumber

string

Nomor telepon dalam format E.164, seperti yang ditetapkan dalam Rekomendasi E.164 International Telecommunication Union (ITU) Rekomendasi E.164. link wiki: https://en.wikipedia.org/wiki/E.164

extension

string

Ekstensi tidak distandardisasi dalam rekomendasi ITU, kecuali jika didefinisikan sebagai serangkaian angka dengan panjang maksimum 40 digit. String didefinisikan sebagai string di sini untuk mengakomodasi kemungkinan penggunaan angka nol di depan dalam ekstensi (organisasi memiliki kebebasan penuh untuk melakukannya, karena tidak ada standar yang ditentukan). Selain angka, beberapa karakter panggilan lain seperti "," (menunjukkan tunggu) mungkin disimpan di sini. Misalnya, dalam xxx-xxx-xxxx ext. 123, "123" adalah ekstensi.

preferredDomesticCarrierCode

string

Kode pilihan operator yang lebih diutamakan saat menghubungi nomor telepon ini di dalam negeri. Kode ini juga mencakup kode yang harus dihubungi di beberapa negara saat menelepon dari telepon rumah ke perangkat seluler atau sebaliknya. Misalnya, di Kolombia, angka "3" harus ditelepon sebelum nomor telepon itu sendiri saat menelepon dari ponsel ke telepon rumah tangga, dan sebaliknya. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

Perhatikan ini adalah kode "pilihan", yang berarti kode lainnya juga dapat berfungsi.

Gambar

Gambar yang ditampilkan di kartu.

Representasi JSON
{
  "url": string,
  "accessibilityText": string,
  "height": number,
  "width": number
}
Kolom
url

string

URL sumber gambar. Gambar dapat berupa JPG, PNG, dan GIF (animasi dan non-animasi). Misalnya,https://www.agentx.com/logo.png. Wajib.

accessibilityText

string

Deskripsi teks dari gambar yang akan digunakan untuk aksesibilitas, misalnya pembaca layar. Wajib.

height

number

Tinggi gambar dalam piksel. Opsional.

width

number

Lebar gambar dalam piksel. Opsional.

Penjual

Penjual untuk keranjang/pesanan/item baris.

Representasi JSON
{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
Kolom
id

string

ID opsional yang ditetapkan untuk penjual jika ada.

name

string

Nama penjual seperti "Roti Panera".

image

object (Image)

Gambar yang terkait dengan penjual.

phoneNumbers[]

object (PhoneNumber)

Nomor telepon penjual.

address

object (Location)

Alamat penjual.

Lokasi

Penampung yang mewakili lokasi.

Representasi JSON
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
Kolom
coordinates

object (LatLng)

Koordinat geografis. Memerlukan izin [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

formattedAddress

string

Alamat tampilan, misalnya, "1600 Amphitheatre Pkwy, Mountain View, CA 94043". Memerlukan izin [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

zipCode

string

Kode pos. Memerlukan izin [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] atau [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

city

string

Kota. Memerlukan izin [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] atau [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

postalAddress

object (PostalAddress)

Alamat pos. Memerlukan izin [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] atau [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

name

string

Nama tempat.

phoneNumber

string

Nomor telepon lokasi, misalnya nomor kontak lokasi bisnis atau nomor telepon untuk lokasi pengiriman.

notes

string

Catatan tentang lokasi.

placeId

string

placeId digunakan dengan Places API untuk mengambil detail suatu tempat. Lihat https://developers.google.com/places/web-service/place-id

LatLng

Objek yang mewakili pasangan garis lintang/garis bujur. Ini dinyatakan sebagai pasangan nilai ganda yang mewakili derajat lintang dan derajat bujur. Kecuali ditentukan lain, nilai harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.

Representasi JSON
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].

longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

PostalAddress

Mewakili alamat pos, mis. untuk pengiriman pos atau alamat pembayaran. Misalnya, layanan pos dapat mengirimkan item ke lokasi, P.O. Box, atau yang serupa. Ini tidak dimaksudkan untuk membuat model lokasi geografis (jalan, kota, gunung).

Dalam penggunaan umum, alamat akan dibuat melalui input pengguna atau dari mengimpor data yang ada, bergantung pada jenis prosesnya.

Saran tentang input / pengeditan alamat: - Gunakan widget alamat i18n-siap seperti https://github.com/google/libaddressinput) - Pengguna tidak boleh melihat elemen UI untuk memasukkan atau mengedit kolom selain negara tempat kolom tersebut digunakan.

Untuk panduan lebih lanjut tentang cara menggunakan skema ini, lihat: https://support.google.com/business/answer/6397478

Representasi JSON
{
  "revision": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Kolom
revision

number

Revisi skema PostalAddress. Nilai ini harus disetel ke 0, yang merupakan revisi terbaru.

Semua revisi baru harus kompatibel dengan revisi lama.

regionCode

string

Wajib. Kode wilayah CLDR negara/wilayah alamat. Ini tidak pernah disimpulkan dan terserah pengguna untuk memastikan nilainya benar. Lihat http://cldr.unicode.org/ dan http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk mengetahui detailnya. Contoh: "CH" untuk Swiss.

languageCode

string

Opsional. Kode bahasa BCP-47 konten alamat ini (jika diketahui). Ini sering kali merupakan bahasa UI formulir input atau diharapkan cocok dengan salah satu bahasa yang digunakan di negara/wilayah alamat, atau padanannya yang telah ditransliterasi. Hal ini dapat memengaruhi pemformatan di negara tertentu, tetapi tidak penting bagi kebenaran data dan tidak akan memengaruhi validasi apa pun atau operasi terkait non-pemformatan lainnya.

Jika nilai ini tidak diketahui, nilai ini harus dihilangkan (daripada menentukan default yang mungkin salah).

Contoh: "zh-Hant", "ja", "ja-Latn", "en".

postalCode

string

Opsional. Kode pos alamat. Tidak semua negara menggunakan atau mewajibkan keberadaan kode pos. Namun, jika kode pos digunakan, kode pos tersebut dapat memicu validasi tambahan dengan bagian alamat lainnya (misalnya, validasi negara bagian/kode pos di AS).

sortingCode

string

Opsional. Kode pengurutan tambahan khusus negara. Opsi ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilainya bisa berupa string seperti "CEDEX", secara opsional diikuti dengan angka (mis. "CEDEX 7"), atau hanya angka saja, yang mewakili "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi), atau "indikator kantor pos" (mis. Côte d'Ivoire).

administrativeArea

string

Opsional. Subdivisi administratif tertinggi yang digunakan untuk alamat pos negara atau wilayah. Misalnya, ini dapat berupa negara bagian, provinsi, oblast, atau prefektur. Khususnya, untuk Spanyol ini adalah provinsi dan bukan komunitas otonom (mis. "Barcelona" dan bukan "Catalunya"). Banyak negara yang tidak menggunakan wilayah administratif dalam alamat pos. Misalnya, di Swiss, kolom ini harus dibiarkan kosong.

locality

string

Opsional. Secara umum merujuk pada bagian kota dari alamat. Contoh: US city, IT comune, UK post city. Di wilayah dunia dengan lokalitas yang tidak didefinisikan dengan baik atau tidak cocok dengan struktur ini, biarkan lokalitas kosong dan gunakan addressLines.

sublocality

string

Opsional. Sublokalitas alamat. Misalnya, ini dapat berupa kawasan, borough, distrik.

addressLines[]

string

Baris alamat tidak terstruktur yang menjelaskan tingkat alamat yang lebih rendah.

Karena nilai dalam addressLines tidak memiliki informasi jenis dan terkadang dapat berisi beberapa nilai dalam satu kolom (misalnya "Austin, TX"), urutan baris harus jelas. Urutan baris alamat harus "urutan amplop" untuk negara/wilayah alamat. Di tempat yang dapat bervariasi (misalnya Jepang), address_language digunakan untuk membuatnya eksplisit (misalnya "ja" untuk pengurutan besar ke kecil dan "ja-Latn" atau "en" untuk kecil ke besar). Dengan cara ini, baris alamat yang paling spesifik dapat dipilih berdasarkan bahasa.

Representasi struktural minimum yang diizinkan dari alamat terdiri dari regionCode dengan semua informasi lainnya yang ditempatkan di addressLines. Memformat alamat seperti itu bisa dilakukan dengan sangat akurat tanpa geocoding, tetapi tidak ada alasan semantik yang bisa dibuat mengenai salah satu komponen alamat hingga setidaknya sebagian diselesaikan.

Membuat alamat yang hanya berisi regionCode dan addressLines, dan kemudian geocoding adalah cara yang disarankan untuk menangani alamat yang benar-benar tidak terstruktur (sebagai kebalikan dari menebak bagian alamat mana yang harus berupa lokalitas atau wilayah administratif).

recipients[]

string

Opsional. Penerima di alamat. Dalam keadaan tertentu, kolom ini dapat berisi informasi multibaris. Misalnya, halaman ini mungkin berisi informasi "perawatan".

organization

string

Opsional. Nama organisasi di alamat.

Daftar Isi

Wrapper untuk item baris.

Representasi JSON
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
Kolom
lineItems[]

object (LineItem)

Daftar item baris pesanan. Diperlukan minimal 1 line_item dan maksimal 50 item baris. Semua item baris harus berasal dari vertical yang sama.

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 seperti yang 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.

PriceAttribute

Atribut harga pesanan atau item baris.

Representasi JSON
{
  "type": enum (Type),
  "name": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": number
  // End of list of possible types for union field spec.
}
Kolom
type

enum (Type)

Wajib: Atribut jenis uang.

name

string

Wajib: Pengguna menampilkan string atribut harga. Pesan ini dikirim dan dilokalkan oleh penjual.

state

enum (State)

Wajib: Status harga: Perkiraan vs Aktual.

taxIncluded

boolean

Apakah harga sudah termasuk pajak.

Kolom union spec. Menunjukkan jumlah uang atau persentase mili. spec hanya ada berupa salah satu diantara berikut:
amount

object (Money)

Jumlah uang.

amountMillipercentage
(deprecated)

number

Spesifikasi persentase, hingga 1/1.000 dari persen. Misalnya: 8,750% direpresentasikan sebagai 8.750, persentase negatif menunjukkan persentase diskon. Penghentian penggunaan kolom ini. Dapat mempertimbangkan untuk menambahkan kembali jika kasus penggunaan yang solid diperlukan.

Jenis

Merepresentasikan jenis uang.

Enum
TYPE_UNSPECIFIED Jenis tidak ditentukan, klien tidak perlu menetapkannya secara eksplisit.
REGULAR Harga tampilan reguler, sebelum diskon, dll. diterapkan.
DISCOUNT Untuk dikurangi dari subtotal.
TAX Untuk ditambahkan ke subtotal.
DELIVERY Untuk ditambahkan ke subtotal.
SUBTOTAL Subtotal sebelum beberapa biaya dapat ditambahkan.
FEE Biaya tambahan apa pun.
GRATUITY Untuk ditambahkan ke subtotal.
TOTAL Menampilkan harga pesanan atau item baris.

Negara Bagian

Merepresentasikan status harga.

Enum
STATE_UNSPECIFIED Tidak ditentukan.
ESTIMATE Harga hanyalah perkiraan.
ACTUAL Harga sebenarnya yang akan ditagihkan kepada pengguna.

Uang

Menyatakan jumlah uang dengan jenis mata uangnya.

Representasi JSON
{
  "currencyCode": string,
  "amountInMicros": string
}
Kolom
currencyCode

string

Kode mata uang 3 huruf yang ditentukan dalam ISO 4217.

amountInMicros

string (int64 format)

Jumlah dalam mikro. Misalnya, bidang ini harus ditetapkan sebagai 1990000 untuk $1,99.

Tindakan

Tindakan lanjutan yang terkait dengan pesanan atau item baris.

Representasi JSON
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
Kolom
type

enum (Type)

Wajib: Jenis tindakan.

title

string

Judul atau label tindakan yang ditampilkan kepada pengguna. Panjang maksimum yang diizinkan adalah 100 karakter.

openUrlAction

object (OpenUrlAction)

Tindakan yang harus diambil.

actionMetadata

object (ActionMetadata)

Metadata yang terkait dengan tindakan.

Jenis

Kemungkinan tindakan lanjutan.

Enum
TYPE_UNSPECIFIED Tindakan belum ditentukan.
VIEW_DETAILS Lihat tindakan detail pesanan.
MODIFY Ubah tindakan pesanan.
CANCEL Batalkan tindakan pesanan.
RETURN Tindakan pengembalian pesanan.
EXCHANGE Tindakan pesanan bursa.
EMAIL

Tindakan email. Jenis EMAIL dan PANGGILAN tidak digunakan lagi. openUrlAction.url dapat digunakan sebagai nomor telepon atau email.

CALL

Memanggil tindakan.

REORDER Urutkan ulang tindakan.
REVIEW Tinjau tindakan pesanan.
CUSTOMER_SERVICE Hubungi layanan pelanggan.
FIX_ISSUE Arahkan ke situs atau aplikasi penjual untuk memperbaiki masalah.
DIRECTION Link rute.

OpenUrlAction

Membuka URL tertentu.

Representasi JSON
{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
Kolom
url

string

Kolom URL yang dapat berupa salah satu dari: - URL http/https untuk membuka Aplikasi atau halaman web yang ditautkan ke Aplikasi

androidApp

object (AndroidApp)

Informasi tentang Aplikasi Android jika URL diharapkan akan dipenuhi oleh Aplikasi Android.

urlTypeHint

enum (UrlTypeHint)

Menunjukkan petunjuk untuk jenis URL.

AndroidApp

Spesifikasi Aplikasi Android untuk batasan fulfillment

Representasi JSON
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
Kolom
packageName

string

Nama paket Nama paket harus ditentukan saat menentukan Android Fulfillment.

versions[]

object (VersionFilter)

Saat beberapa filter ditentukan, setiap pencocokan filter akan memicu aplikasi.

VersionFilter

VersionFilter harus disertakan jika versi aplikasi tertentu diperlukan.

Representasi JSON
{
  "minVersion": number,
  "maxVersion": number
}
Kolom
minVersion

number

Kode versi min atau 0, inklusif.

maxVersion

number

Kode versi maks, inklusif. Rentang yang dipertimbangkan adalah [minVersion:maxVersion]. Rentang null menyiratkan versi apa pun. Contoh: Untuk menentukan satu versi, gunakan: [target_version:target_version]. Untuk menentukan versi, biarkan minVersion dan maxVersion tidak ditentukan. Untuk menentukan semua versi hingga maxVersion, biarkan minVersion tidak ditentukan. Untuk menentukan semua versi dari minVersion, biarkan maxVersion tidak ditentukan.

UrlTypeHint

Berbagai jenis petunjuk URL.

Enum
URL_TYPE_HINT_UNSPECIFIED Belum ditetapkan
AMP_CONTENT URL yang mengarah langsung ke konten AMP, atau ke URL kanonis yang merujuk ke konten AMP melalui <link rel="amphtml">.

ActionMetadata

Metadata Terkait per tindakan.

Representasi JSON
{
  "expireTime": string
}
Kolom
expireTime

string (Timestamp format)

Waktu saat tindakan ini akan berakhir.

Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2014-10-02T15:01:23.045123456Z".

Penyingkapan

Pengungkapan produk, layanan, atau kebijakan yang dapat ditampilkan kepada pengguna.

Representasi JSON
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
Kolom
title

string

Judul pengungkapan. Contoh: "Informasi keselamatan".

disclosureText

object (DisclosureText)

Konten pengungkapan. Link web diizinkan.

presentationOptions

object (DisclosurePresentationOptions)

Opsi presentasi untuk pengungkapan.

DisclosureText

Menampilkan teks biasa dengan link web.

Representasi JSON
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
Kolom
template

string

Teks yang akan ditampilkan, yang berisi placeholder seperti "{0}" dan "{1}" untuk setiap tautan teks yang harus disisipkan. Contoh: "PERINGATAN: Produk ini dapat memaparkan bahan kimia yang diketahui oleh Negara Bagian California dapat menyebabkan kanker. Untuk informasi selengkapnya, kunjungi {0}." Teks pengungkapan ini tidak boleh berisi konten promosi atau konten seperti iklan.

DisclosurePresentationOptions

Opsi untuk penyajian pengungkapan.

Representasi JSON
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
Kolom
presentationRequirement

enum (PresentationRequirement)

Persyaratan penyajian pengungkapan.

initiallyExpanded

boolean

Apakah konten pengungkapan pada awalnya harus diperluas. Secara default, jendela ini awalnya diciutkan.

PresentationRequirement

Persyaratan untuk menampilkan pengungkapan.

Enum
REQUIREMENT_UNSPECIFIED Persyaratan tidak ditentukan. Seharusnya tidak menetapkan ini secara eksplisit.
REQUIREMENT_OPTIONAL Pengungkapan ini bersifat opsional. Ini dapat dilewati jika perangkat tidak mendukung pengungkapan yang ditampilkan.
REQUIREMENT_REQUIRED Pengungkapan harus ada. Percakapan akan dimulai dari telepon jika perangkat tidak mendukung penyajian pengungkapan.

PurchaseItemExtension

Konten item baris Vertikal Pembelian.

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

number

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.

PurchaseStatus

Status pembelian yang terkait dengan pesanan pembelian (PO) atau item baris tertentu.

Enum
PURCHASE_STATUS_UNSPECIFIED Status belum ditetapkan.
READY_FOR_PICKUP Siap diambil.
SHIPPED Telah dikirim.
DELIVERED Diterima.
OUT_OF_STOCK Stok habis.
IN_PREPARATION "IN_PREPARATION" dapat memiliki arti yang berbeda dalam konteks yang berbeda. Untuk pesanan MAKANAN, bisa jadi makanan sedang disiapkan. Untuk Retail, bisa jadi item sedang dikemas.
CREATED Pesanan dibuat.
CONFIRMED Penjual mengonfirmasi pesanan.
REJECTED Penjual menolak pesanan atau item baris.
RETURNED Item dikembalikan oleh pengguna.
CANCELLED Pesanan atau item baris dibatalkan oleh pengguna.
CHANGE_REQUESTED Pengguna telah meminta perubahan atas pesanan, dan integrator sedang memproses perubahan ini. Pesanan harus dipindahkan ke status lain setelah permintaan ditangani.

PurchaseType

Kategori pembelian.

Enum
PURCHASE_TYPE_UNSPECIFIED Nilai tidak diketahui.
RETAIL Ini mencakup pembelian seperti barang fisik.
FOOD Data ini mencakup pembelian pesanan makanan.
GROCERY Pembelian bahan makanan.
MOBILE_RECHARGE Pembelian isi ulang seluler prabayar.

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.

Satuan

Enum
UNIT_UNSPECIFIED Unit belum ditetapkan.
MILLIGRAM Miligram.
GRAM Gram.
KILOGRAM Kilogram.
OUNCE Ons.
POUND Pound.

PurchaseReturnsInfo

Menampilkan info yang terkait dengan pesanan atau item baris tertentu.

Representasi JSON
{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}
Kolom
isReturnable

boolean

Jika true (benar), pengembalian diizinkan.

daysToReturn

number

Pengembalian diizinkan dalam jangka waktu tersebut.

policyUrl

string

Link ke kebijakan pengembalian.

PurchaseFulfillmentInfo

Info pemenuhan yang terkait dengan pesanan pembelian (PO) atau item baris tertentu.

Representasi JSON
{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}
Kolom
id

string

ID unik untuk opsi layanan ini.

fulfillmentType

enum (Type)

Wajib: Jenis fulfillment.

expectedFulfillmentTime

object (Time)

Jendela jika rentang waktu telah ditentukan atau PWT jika satu waktu ditentukan. Perkiraan waktu pengiriman atau pengambilan.

expectedPreparationTime

object (Time)

Jendela jika rentang waktu telah ditentukan atau PWT jika satu waktu ditentukan. Perkiraan waktu untuk menyiapkan makanan. Disarankan satu kali.

location

object (Location)

Lokasi pengambilan atau pengiriman.

expireTime

string (Timestamp format)

Waktu saat opsi pemenuhan pesanan ini berakhir.

Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2014-10-02T15:01:23.045123456Z".

price

object (PriceAttribute)

Biaya opsi ini.

fulfillmentContact

object (UserInfo)

Kontak pengguna untuk fulfillment ini.

shippingMethodName

string

Nama metode pengiriman yang dipilih oleh pengguna.

storeCode

string

StoreCode lokasi. Contoh: Walmart adalah penjual dan storeCode adalah toko walmart tempat pemenuhan pesanan terjadi. https://support.google.com/business/answer/3370250?ref_topic=4596653.

pickupInfo

object (PickupInfo)

Informasi tambahan terkait cara pengambilan pesanan. Kolom ini hanya dapat diterapkan jika jenis pemenuhan pesanan adalah PICKUP.

Jenis

Jenis pemenuhan.

Enum
TYPE_UNSPECIFIED Jenis tidak ditentukan.
DELIVERY Pesanan ini akan dikirim.
PICKUP Pesanan ini perlu diambil.

Waktu

Konstruksi waktu untuk mewakili waktu suatu peristiwa yang akan digunakan saat menampilkan urutan kepada pengguna.

Representasi JSON
{
  "timeIso8601": string
}
Kolom
timeIso8601

string

Mewakili waktu peristiwa pesanan seperti waktu reservasi, waktu pengiriman, dan sebagainya. Bisa berupa durasi (waktu mulai & berakhir), hanya tanggal, waktu tanggal, dll. Lihat https://en.wikipedia.org/wiki/ISO_8601 untuk semua format yang didukung.

PickupInfo

Detail tentang cara pengambilan pesanan. Hal ini mencakup detail seperti jenis pengambilan dan metadata tambahan yang disertakan dengan setiap jenis, jika ada.

Representasi JSON
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
Kolom
pickupType

enum (PickupType)

Metode pengambilan, seperti INSTORE, CURBSIDE, dll.

curbsideInfo

object (CurbsideInfo)

Detail khusus untuk informasi di tepi jalan. Jika pickupType bukan "CURBSIDE", kolom ini akan diabaikan.

checkInInfo[]

object (CheckInInfo)

Daftar berbagai metode yang didukung partner untuk mendukung check in.

PickupType

Daftar jenis pengambilan yang didukung.

Enum
UNSPECIFIED Jenis pengambilan belum ditetapkan.
INSTORE Mengambil makanan di dalam restoran.
CURBSIDE Parkir kendaraan di tempat yang ditentukan di luar restoran dan seseorang akan mengantarkan makanan ke sana.

CurbsideInfo

Detail tentang cara memfasilitasi pesanan di tepi jalan.

Representasi JSON
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
Kolom
curbsideFulfillmentType

enum (CurbsideFulfillmentType)

Partner memerlukan informasi tambahan untuk memfasilitasi pesanan ambil di tepi jalan. Bergantung pada jenis pemenuhan yang dipilih, detail yang sesuai akan dikumpulkan dari pengguna.

userVehicle

object (Vehicle)

Detail kendaraan pengguna yang melakukan pemesanan.

CurbsideFulfillmentType

Nilai yang mungkin untuk jenis pemenuhan tepi jalan.

Enum
UNSPECIFIED Jenis fulfillment tepi jalan tidak ditentukan.
VEHICLE_DETAIL Detail kendaraan diperlukan untuk memfasilitasi pengambilan di tepi jalan.

Kendaraan

Detail tentang kendaraan

Representasi JSON
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
Kolom
make

string

Merek kendaraan (misalnya, "Honda"). Nama ini ditampilkan kepada pengguna dan harus dilokalkan. Wajib.

model

string

Model kendaraan (misalnya, "Grom"). Nama ini ditampilkan kepada pengguna dan harus dilokalkan. Wajib.

licensePlate

string

Nomor pelat nomor kendaraan (misalnya, "1ABC234"). Wajib.

colorName

string

Nama warna kendaraan, misalnya hitam Opsional.

image

object (Image)

URL ke foto kendaraan. Foto akan ditampilkan dalam ukuran sekitar 256x256 piksel. Harus berupa jpg atau png. Opsional.

CheckInInfo

Metadata yang diperlukan partner untuk mendukung metode check in.

Representasi JSON
{
  "checkInType": enum (CheckInType)
}
Kolom
checkInType

enum (CheckInType)

Metode yang digunakan untuk mengirim petunjuk check in.

CheckInType

Berbagai metode yang digunakan untuk mengirim petunjuk check in.

Enum
CHECK_IN_TYPE_UNSPECIFIED Nilai tidak diketahui.
EMAIL Informasi CheckIn akan dikirim melalui email.
SMS Informasi CheckIn akan dikirim melalui SMS.

ItemOption

Mewakili add-on atau sub-item.

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

number

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": number,
  "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 saat layanan/peristiwa dijadwalkan untuk terjadi. Dapat berupa rentang waktu, tanggal, atau waktu tanggal yang tepat.

userAcceptableTimeRange

object (Time)

Rentang waktu yang dapat diterima pengguna.

confirmationCode

string

Kode konfirmasi untuk reservasi ini.

partySize

number

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

ReservationStatus

Status reservasi.

Enum
RESERVATION_STATUS_UNSPECIFIED Status belum ditentukan.
PENDING Reservasi tertunda.
CONFIRMED Reservasi telah dikonfirmasi.
CANCELLED Reservasi dibatalkan oleh pengguna.
FULFILLED Reservasi telah terpenuhi.
CHANGE_REQUESTED Perubahan reservasi diminta
REJECTED Reservasi sudah tidak berlaku atau ditolak oleh integrator.

ReservationType

Jenis reservasi.

Enum
RESERVATION_TYPE_UNSPECIFIED Jenis tidak ditentukan.
RESTAURANT Reservasi restoran.
HAIRDRESSER Reservasi untuk penata rambut.

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.

PaymentData

Data pembayaran yang terkait dengan pesanan.

Representasi JSON
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
Kolom
paymentResult

object (PaymentResult)

Hasil pembayaran yang digunakan oleh integrator untuk menyelesaikan transaksi. Kolom ini akan diisi oleh Actions on Google jika pengalaman checkout dikelola oleh Actions-on-Google.

paymentInfo

object (PaymentInfo)

Informasi pembayaran terkait pesanan yang berguna untuk interaksi yang ditampilkan kepada pengguna.

PaymentResult

Hasil pembayaran yang digunakan oleh integrator untuk menyelesaikan transaksi.

Representasi JSON
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
Kolom
Kolom union result. Data pembayaran Google atau metode pembayaran penjual disediakan. result hanya ada berupa salah satu diantara berikut:
googlePaymentData

string

Data metode pembayaran yang disediakan Google. Jika pemroses pembayaran Anda tercantum sebagai pemroses pembayaran yang didukung Google di sini: https://developers.google.com/pay/api/ Buka pemroses pembayaran Anda melalui link untuk mengetahui detail selengkapnya. Atau, lihat dokumentasi berikut untuk mengetahui detail payload. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

Metode pembayaran yang disediakan Penjual/Tindakan yang dipilih pengguna.

PaymentInfo

Informasi pembayaran terkait pesanan yang dibuat. Proto ini mencatat informasi yang berguna untuk interaksi yang ditampilkan kepada pengguna.

Representasi JSON
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Kolom
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

Info tampilan metode pembayaran yang digunakan untuk transaksi.

paymentMethodProvenance

enum (PaymentMethodProvenance)

Asal metode pembayaran yang digunakan untuk transaksi. Pengguna mungkin telah mendaftarkan metode pembayaran yang sama di Google dan penjual.

PaymentMethodDisplayInfo

Hasil pembayaran yang digunakan oleh integrator untuk menyelesaikan transaksi.

Representasi JSON
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}
Kolom
paymentType

enum (PaymentType)

Jenis pembayaran.

paymentMethodDisplayName

string

Nama metode pembayaran yang terlihat oleh pengguna. Misalnya, VISA **** 1234 Memeriksa akun **** 5678

paymentMethodVoiceName

string

Nama metode pembayaran yang akan diucapkan kepada pengguna di perangkat asisten khusus suara. Misalnya, "visa yang diakhiri dengan satu dua tiga empat", atau "rekening cek yang diakhiri dengan lima enam tujuh delapan". Catatan: Ini adalah string yang dioptimalkan untuk suara yang akan digunakan, bukan paymentMethodDisplayName untuk perangkat asisten khusus suara. Jika string ini tidak ditetapkan, paymentMethodDisplayName akan diucapkan kepada pengguna.

PaymentType

PaymentType menunjukkan metode pembayaran yang digunakan untuk metode pembayaran yang disediakan Penjual. Action juga harus memberikan nama tampilan untuk metode pembayaran.

Enum
PAYMENT_TYPE_UNSPECIFIED Jenis pembayaran belum ditetapkan.
PAYMENT_CARD Kartu kredit/debit atau prabayar.
BANK Metode pembayaran adalah rekening bank.
LOYALTY_PROGRAM Metode pembayaran adalah program loyalitas.
CASH Metode pembayaran adalah uang tunai.
GIFT_CARD Metode pembayaran adalah kartu voucher.
WALLET Dompet pihak ketiga, yaitu PayPal

PaymentMethodProvenance

Merepresentasikan sumber Metode pembayaran yang digunakan untuk transaksi.

Enum
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED Asal Belum Ditentukan.
PAYMENT_METHOD_PROVENANCE_GOOGLE Asal adalah Google.
PAYMENT_METHOD_PROVENANCE_MERCHANT Asal adalah Penjual.

Promosi

Promosi/Penawaran yang ditambahkan ke keranjang.

Representasi JSON
{
  "coupon": string
}
Kolom
coupon

string

Wajib: Kode kupon yang diterapkan untuk penawaran ini.

PurchaseOrderExtension

Ekstensi pesanan untuk vertikal pembelian. Properti ini berlaku untuk semua item baris dalam pesanan, kecuali diganti dalam item baris.

Representasi JSON
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
Kolom
status

enum (PurchaseStatus)

Wajib: Status Keseluruhan untuk pesanan.

userVisibleStatusLabel

string

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

type

enum (PurchaseType)

Wajib: Jenis pembelian.

returnsInfo

object (PurchaseReturnsInfo)

Info pengembalian pesanan.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Info pemenuhan pesanan.

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

purchaseLocationType

enum (PurchaseLocationType)

Lokasi pembelian (di toko / online)

errors[]

object (PurchaseError)

Opsional: Terjadi error karena pesanan ini ditolak.

PurchaseLocationType

Jenis lokasi pembelian.

Enum
UNSPECIFIED_LOCATION Nilai tidak diketahui.
ONLINE_PURCHASE Semua pembelian yang dibeli secara online.
INSTORE_PURCHASE Semua pembelian di toko.

PurchaseError

Error yang dapat menyebabkan pesanan pembelian ditolak.

Representasi JSON
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": number
}
Kolom
type

enum (ErrorType)

Wajib: Hal ini menunjukkan alasan terperinci pesanan ditolak oleh penjual.

description

string

Deskripsi error tambahan.

entityId

string

ID entitas yang sesuai dengan error. Contoh ini dapat sesuai dengan LineItemId / ItemOptionId.

updatedPrice

object (PriceAttribute)

Relevan dengan kasus jenis kesalahan PRICE_CHANGE / INCORRECT_PRICE.

availableQuantity

number

Jumlah yang tersedia sekarang. Berlaku jika AVAILABILITY_ABILITY.

ErrorType

Jenis error yang mungkin terjadi.

Enum
ERROR_TYPE_UNSPECIFIED Error tak dikenal
NOT_FOUND Entitas tidak ditemukan, dapat berupa Item, FulfillmentOption, Promosi. ID entitas wajib diisi.
INVALID Data entitas tidak valid. dapat berupa Item, FulfillmentOption, Promosi. ID entitas wajib diisi.
AVAILABILITY_CHANGED Item tidak tersedia, atau item tidak memadai untuk memenuhi permintaan. ID entitas wajib diisi.
PRICE_CHANGED Harga item berbeda dari harga di entity Item. ID entitas dan harga terbaru wajib diisi.
INCORRECT_PRICE Kesalahan harga dalam Biaya, Total. ID entitas dan harga terbaru wajib diisi.
REQUIREMENTS_NOT_MET Batasan untuk menerima pesanan tidak terpenuhi - ukuran keranjang minimum dll.,.
TOO_LATE FulfillmentOption sudah tidak berlaku.
NO_CAPACITY Kapasitas layanan tidak tersedia.
INELIGIBLE Pengguna tidak memenuhi syarat untuk melakukan pemesanan (masuk daftar hitam).
OUT_OF_SERVICE_AREA Tidak dapat mengirim ke alamat yang diminta karena aturan perbatasan, dll.
CLOSED Restoran tutup untuk bisnis pada saat pemesanan.
PROMO_NOT_APPLICABLE Kode error umum untuk menangkap semua kasus kegagalan dalam menerapkan kode promo, jika tidak ada satu pun di bawah yang sesuai. Tambahkan kode promo sebagai ID Entitas.
PROMO_NOT_RECOGNIZED Kode kupon tidak dikenali oleh partner. Tambahkan kode promo sebagai ID Entitas.
PROMO_EXPIRED Tidak dapat diterapkan karena promosi telah berakhir. Tambahkan kode promo sebagai ID Entitas.
PROMO_USER_INELIGIBLE Pengguna saat ini tidak memenuhi syarat untuk kupon ini. Tambahkan kode promo sebagai ID Entitas.
PROMO_ORDER_INELIGIBLE Pesanan saat ini tidak memenuhi syarat untuk kupon ini. Tambahkan kode promo sebagai ID Entitas.
UNAVAILABLE_SLOT Slot pesan di muka tidak tersedia.
FAILED_PRECONDITION Batasan untuk menerima pesanan tidak terpenuhi - ukuran keranjang minimum, dll.
PAYMENT_DECLINED Pembayaran tidak valid.
MERCHANT_UNREACHABLE Penjual tidak dapat dijangkau. Hal ini berguna jika partner merupakan agregator dan tidak dapat menjangkau penjual.

TicketOrderExtension

Memesan konten untuk pesanan tiket seperti film, olahraga, dll.

Representasi JSON
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
Kolom
ticketEvent

object (TicketEvent)

Peristiwa ini berlaku untuk semua tiket item baris.

TicketEvent

Mewakili satu peristiwa.

Representasi JSON
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
Kolom
type

enum (Type)

Wajib: Jenis acara tiket, misalnya film, konser.

name

string

Wajib: Nama peristiwa. Misalnya, jika acaranya adalah film, ini harus berupa nama film.

description

string

Deskripsi acara.

url

string

URL ke info peristiwa.

location

object (Location)

Lokasi tempat acara berlangsung, atau organisasi berada.

eventCharacters[]

object (EventCharacter)

Karakter yang terkait dengan peristiwa ini. Bisa jadi sutradara atau aktor acara film, atau artis konser, dll.

startDate

object (Time)

Waktu mulai.

endDate

object (Time)

Waktu berakhir.

doorTime

object (Time)

Waktu masuk, yang mungkin berbeda dengan waktu mulai acara, misalnya acara dimulai pukul 09.00, tetapi waktu masuknya adalah pukul 08.30.

Jenis

Jenis peristiwa.

Enum
EVENT_TYPE_UNKNOWN Jenis peristiwa tidak diketahui.
MOVIE Film.
CONCERT Konser.
SPORTS Olahraga.

EventCharacter

Satu karakter acara, misalnya penyelenggara, pengisi acara, dll.

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

enum (Type)

Jenis karakter acara, misalnya aktor atau sutradara.

name

string

Nama karakter.

image

object (Image)

Gambar karakter.

Jenis

Jenis karakter.

Enum
TYPE_UNKNOWN Jenis tidak diketahui.
ACTOR Aktor.
PERFORMER Penyanyi.
DIRECTOR Sutradara.
ORGANIZER Penyelenggara.