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 tingkat harus kurang dari 50 jumlah kecuali jika ditentukan lain. 3. Semua stempel waktu di semua tingkat, 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 yang berbeda dan lebih mudah digunakan. Panjang maksimum yang diizinkan adalah 128 karakter.

userVisibleOrderId

string

ID yang ditampilkan kepada pengguna yang merujuk ke pesanan saat ini. ID ini harus konsisten dengan ID yang ditampilkan untuk pesanan ini dalam konteks lain, termasuk situs, aplikasi, dan email.

userVisibleStateLabel
(deprecated)

string

Tidak digunakan lagi: Gunakan status OrderExtensions sebagai gantinya. 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. Wajib 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 proses checkout. Penyedia ini mungkin berbeda dari penyedia tingkat item baris. Contoh: Pesanan Expedia dengan item baris dari ANA.

contents

object (Contents)

Wajib: Susunan konten yang merupakan kelompok item baris.

priceAttributes[]

object (PriceAttribute)

Harga, diskon, pajak, dan sebagainya.

followUpActions[]

object (Action)

Tindakan lanjutan di tingkat pesanan.

paymentData

object (PaymentData)

Data terkait pembayaran untuk pesanan.

termsOfServiceUrl

string

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

note

string

Catatan dilampirkan pada 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 sebagai gantinya. Properti ini akan diterapkan ke semua item baris, kecuali diganti pada beberapa item baris. Vertical ini harus sesuai dengan jenis vertikal 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 diganti pada beberapa item baris. Vertical ini harus sesuai dengan jenis vertikal tingkat item baris. verticals hanya dapat berupa salah satu dari berikut:
purchase

object (PurchaseOrderExtension)

Pesanan pembelian (PO)

ticket

object (TicketOrderExtension)

Pesanan tiket

UserInfo

Informasi tentang pengguna. Ini digunakan untuk mewakili 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 dengan nama depan atau nama belakang.

phoneNumbers[]

object (PhoneNumber)

Nomor telepon pengguna.

NomorTelepon

Representasi nomor telepon standar.

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

string

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

extension

string

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

preferredDomesticCarrierCode

string

Kode pilihan operator yang dipilih saat menghubungi nomor telepon ini di dalam negeri. Ini juga mencakup kode yang harus dipanggil di beberapa negara saat menelepon dari telepon rumah ke ponsel atau sebaliknya. Misalnya, di Kolombia, "3" harus dihubungi sebelum nomor telepon itu sendiri saat melakukan panggilan dari ponsel ke telepon rumah domestik dan sebaliknya. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

Perhatikan bahwa ini adalah "pilihan" , yang berarti kode lain juga bisa 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 diisi.

accessibilityText

string

Deskripsi teks dari gambar yang akan digunakan untuk aksesibilitas, misalnya {i>screen reader <i}(pembaca layar). Wajib diisi.

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 [DEVICE_PRECISE_LOCATION] izin [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

formattedAddress

string

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

zipCode

string

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

city

string

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

postalAddress

object (PostalAddress)

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

name

string

Nama tempat.

phoneNumber

string

Nomor telepon lokasi, mis. 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 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

Merepresentasikan alamat pos, mis. untuk pengiriman pos atau alamat pembayaran. Dengan mempertimbangkan alamat pos, layanan pos dapat mengirimkan item ke suatu tempat, P.O. Box atau yang serupa. Hal 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, tergantung pada jenis prosesnya.

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

Untuk panduan selengkapnya 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 diisi. Kode wilayah CLDR negara/wilayah alamat. Hal ini tidak pernah disimpulkan dan bergantung pada pengguna untuk memastikan nilainya benar. Lihat http://cldr.unicode.org/ dan http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk 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 alamat negara/wilayah, atau padanannya dalam transliterasi. Hal ini dapat memengaruhi pemformatan di negara tertentu, tetapi tidak penting bagi keakuratan data dan tidak akan memengaruhi validasi atau operasi terkait non-pemformatan lainnya.

Jika nilai ini tidak diketahui, sebaiknya dihilangkan (bukan 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, tetapi jika kode pos digunakan, kode pos tersebut dapat memicu validasi tambahan dengan bagian alamat lainnya (misalnya, validasi negara bagian/kode pos di Amerika Serikat).

sortingCode

string

Opsional. Kode pengurutan tambahan khusus negara. Ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilainya dapat 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 suatu negara atau wilayah. Misalnya, ini dapat berupa negara bagian, provinsi, oblast, atau prefektur. Khususnya, untuk Spanyol, ini adalah provinsi dan bukan komunitas otonom (misalnya "Barcelona" dan bukan "Catalonia"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Mis. di Swiss kolom ini harus dibiarkan tidak terisi.

locality

string

Opsional. Secara umum mengacu pada bagian kota dari alamat tersebut. 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, kota besar, distrik.

addressLines[]

string

Baris alamat tidak terstruktur yang menggambarkan 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 barisnya harus jelas. Urutan baris alamat harus berupa "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 sebuah alamat terdiri dari regionCode dengan semua informasi yang tersisa yang ditempatkan di addressLines. Anda dapat memformat alamat seperti itu secara kira-kira tanpa geocoding, tetapi tidak ada alasan semantik yang dapat dibuat untuk setiap komponen alamat hingga setidaknya sebagian di-resolve.

Membuat alamat yang hanya berisi regionCode dan addressLines, dan kemudian geocoding adalah cara yang direkomendasikan untuk menangani alamat yang benar-benar tidak terstruktur (daripada 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, mungkin ada kata "care of" tidak akurat atau tidak sesuai.

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 baris. Semua item baris harus berada di vertical yang sama.

LineItem

Satu item baris berisi satu item baris vertikal. Satu pesanan atau keranjang dapat memiliki beberapa item baris dengan vertical yang sama. Subbaris/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 tingkat harus kurang dari 50 jumlah kecuali jika ditentukan lain. 3. Semua stempel waktu di semua tingkat, 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 parsial. 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 sebagai gantinya. 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 Expedia dengan ANA penyedia item baris.

priceAttributes[]

object (PriceAttribute)

Harga dan penyesuaian tingkat item baris.

followUpActions[]

object (Action)

Tindak lanjuti tindakan di item baris.

recipients[]

object (UserInfo)

Pelanggan tingkat item baris, ini dapat berbeda dari pembeli tingkat Pesanan. Contoh: Pengguna X melakukan reservasi restoran atas 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 ini, misalnya kebijakan pembatalan.

disclosures[]

object (Disclosure)

Pengungkapan yang terkait dengan item baris ini.

vertical
(deprecated)

object

Tidak digunakan lagi: Gunakan vertical sebagai gantinya. 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 dapat berupa salah satu dari berikut:
purchase

object (PurchaseItemExtension)

Pesanan pembelian 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: Jenis atribut uang.

name

string

Wajib: String atribut harga yang ditampilkan oleh pengguna. Link 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 mil. spec hanya dapat berupa salah satu dari berikut:
amount

object (Money)

Jumlah uang.

amountMillipercentage
(deprecated)

number

Spesifikasi persentase, hingga 1/1000 dari persen. Misalnya: 8,750% direpresentasikan sebagai 8.750, persentase negatif mewakili diskon persentase. Menghentikan penggunaan kolom ini. Dapat mempertimbangkan untuk menambahkan kembali saat kasus penggunaan yang solid diperlukan.

Jenis

Menampilkan jenis uang.

Enum
TYPE_UNSPECIFIED Jenis tidak ditentukan, klien tidak perlu menyetelnya secara eksplisit.
REGULAR Harga tampilan reguler, sebelum diskon, dll. diterapkan.
DISCOUNT Untuk dikurangkan 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 Harga pesanan atau item baris yang ditampilkan.

Negara Bagian

Menampilkan status harga.

Enum
STATE_UNSPECIFIED Tidak ditentukan.
ESTIMATE Harga hanyalah perkiraan.
ACTUAL Harga sebenarnya yang akan dikenakan 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, kolom 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 diperlukan.

actionMetadata

object (ActionMetadata)

Metadata yang terkait dengan tindakan.

Jenis

Kemungkinan tindakan lanjutan.

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

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

CALL

Tindakan pesan ajakan.

REORDER Tindakan urutkan ulang.
REVIEW Tinjau tindakan pesanan.
CUSTOMER_SERVICE Hubungi layanan pelanggan.
FIX_ISSUE Arahkan kursor ke situs atau aplikasi penjual untuk memperbaiki masalah.
DIRECTION Link arah.

OpenUrlAction

Membuka URL yang diberikan.

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

string

Kolom URL yang dapat berupa: - URL http/https untuk membuka Aplikasi yang Tertaut Aplikasi atau halaman web

androidApp

object (AndroidApp)

Informasi tentang Aplikasi Android jika URL diharapkan untuk 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

Package name (Nama paket) Nama paket harus ditentukan saat menentukan Android Fulfillment.

versions[]

object (VersionFilter)

Jika 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 maksimum, 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 Tidak ditentukan
AMP_CONTENT URL yang mengarah langsung ke konten AMP, atau 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 keamanan".

disclosureText

object (DisclosureText)

Konten pengungkapan. Link web diizinkan.

presentationOptions

object (DisclosurePresentationOptions)

Opsi presentasi untuk pengungkapan.

DisclosureText

Mewakili teks biasa dengan link web.

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

string

Teks yang akan ditampilkan, berisi placeholder seperti "{0}" dan "{1}" untuk setiap tautan teks yang harus dimasukkan. Contoh: "PERINGATAN: Produk ini dapat terpapar bahan kimia yang diketahui Negara Bagian California dapat menyebabkan kanker. Untuk informasi selengkapnya, buka {0}." Teks pengungkapan ini tidak boleh berisi konten promosi atau sejenis 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 harus diperluas terlebih dahulu. Secara default, fitur ini awalnya diciutkan.

PresentationRequirement

Persyaratan penyajian pengungkapan.

Enum
REQUIREMENT_UNSPECIFIED Persyaratan tidak ditentukan. Tidak boleh menetapkan ini secara eksplisit.
REQUIREMENT_OPTIONAL Pengungkapan ini bersifat opsional. Setelan ini dapat dilewati jika perangkat tidak mendukung pengungkapan pengungkapan.
REQUIREMENT_REQUIRED Pengungkapan wajib diisi. Percakapan akan dikirim ke telepon jika perangkat tidak mendukung pengungkapan 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 maksimum yang diizinkan adalah 50 karakter.

type

enum (PurchaseType)

Wajib: Jenis pembelian.

productId
(deprecated)

string

ID produk atau penawaran yang dikaitkan dengan item baris ini.

quantity

number

Jumlah item.

unitMeasure

object (MerchantUnitMeasure)

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

returnsInfo

object (PurchaseReturnsInfo)

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

fulfillmentInfo

object (PurchaseFulfillmentInfo)

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

itemOptions[]

object (ItemOption)

Add-on atau sub-item tambahan.

extension

object

Semua kolom tambahan 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 Terkirim.
DELIVERED Diterima.
OUT_OF_STOCK Stok habis.
IN_PREPARATION "IN_PERSIAPAN" bisa memiliki makna yang berbeda dalam konteks yang berbeda. Untuk pesanan MAKANAN, bisa jadi makanan sedang disiapkan. Untuk Retail, hal ini dapat berupa item yang sedang dikemas.
CREATED Pesanan dibuat.
CONFIRMED Penjual mengonfirmasi pesanan.
REJECTED Penjual menolak pesanan atau item baris.
RETURNED Item ditampilkan oleh pengguna.
CANCELLED Pesanan atau item baris dibatalkan oleh pengguna.
CHANGE_REQUESTED Pengguna telah meminta perubahan pada 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 Hal ini termasuk pembelian seperti barang fisik.
FOOD Ini termasuk 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.

Unit

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), ditampilkan diizinkan.

daysToReturn

number

Pengembalian diizinkan dalam jumlah hari 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 ditentukan, atau PWT jika satu waktu ditentukan. Perkiraan waktu pengiriman atau pengambilan.

expectedPreparationTime

object (Time)

Jendela jika rentang waktu ditentukan, atau PWT jika satu waktu ditentukan. Perkiraan waktu untuk menyiapkan makanan. Satu kali lebih disarankan.

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 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 digunakan jika jenis pemenuhan pesanan adalah PICKUP.

Jenis

Jenis pemenuhan pesanan.

Enum
TYPE_UNSPECIFIED Jenis belum ditetapkan.
DELIVERY Pesanan ini akan dikirim.
PICKUP Pesanan ini harus diambil.

Waktu

Konstruksi waktu yang mewakili waktu peristiwa yang akan digunakan saat menampilkan pesanan kepada pengguna.

Representasi JSON
{
  "timeIso8601": string
}
Kolom
timeIso8601

string

Merepresentasikan waktu peristiwa pemesanan seperti waktu reservasi, waktu pengiriman, dan sebagainya. Dapat berupa durasi (waktu mulai &berakhir), hanya tanggal, tanggal, waktu, 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 oleh partner untuk mendukung check-in.

PickupType

Daftar jenis pengambilan yang didukung.

Enum
UNSPECIFIED Jenis pengambilan belum ditentukan.
INSTORE Mengambil makanan di dalam restoran.
CURBSIDE Parkir kendaraan di tempat yang ditentukan di luar restoran dan seseorang akan mengirimkan 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 dari jenis pemenuhan pesanan di tepi jalan.

Enum
UNSPECIFIED Jenis fulfillment tepi jalan belum 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 (mis. "Honda"). Nama ini ditampilkan kepada pengguna dan harus dilokalkan. Wajib diisi.

model

string

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

licensePlate

string

Nomor plat kendaraan (misalnya, "1ABC234"). Wajib diisi.

colorName

string

Nama warna kendaraan, misalnya, hitam Opsional.

image

object (Image)

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

CheckInInfo

Metadata yang diperlukan oleh 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 Check In akan dikirim melalui email.
SMS Informasi Check In 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 opsi.

quantity

number

Untuk opsi yang berupa item, quantity.

productId

string

ID produk atau penawaran yang dikaitkan 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 dikaitkan dengan item baris ini.

gtin

string

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

plu

string

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

productType

string

Kategori produk yang ditentukan oleh penjual. Mis. "Beranda > Bahan Makanan > Produk susu & Telur > Susu > Susu Utuh"

productAttributes

map (key: string, value: string)

Detail yang disediakan penjual tentang produk, mis. { &quot;allergen&quot;: &quot;peanut&quot; }. 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 maksimum yang diizinkan adalah 50 karakter.

type

enum (ReservationType)

Jenis reservasi. Mungkin tidak ditetapkan jika tidak ada opsi jenis yang berlaku.

reservationTime

object (Time)

Waktu saat layanan/peristiwa dijadwalkan akan terjadi. 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

number

Jumlah orang.

staffFacilitators[]

object (StaffFacilitator)

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

location

object (Location)

Lokasi layanan/peristiwa.

extension

object

Semua kolom tambahan 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 untuk restoran.
HAIRDRESSER Reservasi untuk penata rambut.

StaffFacilitator

Informasi tentang petugas layanan.

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

string

Nama fasilitator staf. Mis. "Budi Santoso"

image

object (Image)

Gambar artis.

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 dapat berupa salah satu dari 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. Jika tidak, lihat dokumentasi berikut untuk mengetahui detail payload. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

Metode pembayaran yang disediakan Penjual/Action yang dipilih pengguna.

PaymentInfo

Informasi pembayaran terkait pesanan yang dibuat. Proto ini menangkap 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 ke 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 untuk perangkat asisten khusus suara. Misalnya, "visa yang berakhiran satu dua tiga empat", atau "rekening giro yang berakhiran lima enam tujuh delapan". Catatan: Ini adalah string yang dioptimalkan dengan suara, bukan paymentMethodDisplayName untuk perangkat asisten yang hanya menggunakan suara. Jika string ini tidak ditetapkan, paymentMethodDisplayName akan diucapkan kepada pengguna.

PaymentType

PaymentType menunjukkan metode pembayaran yang digunakan untuk metode pembayaran yang disediakan penjual. Tindakan juga harus menyediakan nama tampilan untuk metode pembayaran.

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

PaymentMethodProvenance

Menyatakan asal Metode pembayaran yang digunakan untuk transaksi.

Enum
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED Provenance Tidak Ditentukan.
PAYMENT_METHOD_PROVENANCE_GOOGLE Provenance adalah Google.
PAYMENT_METHOD_PROVENANCE_MERCHANT Provenance 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 vertical pembelian. Properti ini berlaku untuk semua item baris dalam pesanan, kecuali jika diganti di 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 maksimum yang diizinkan adalah 50 karakter.

type

enum (PurchaseType)

Wajib: Jenis pembelian.

returnsInfo

object (PurchaseReturnsInfo)

Info pengembalian untuk pesanan.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Info pemenuhan pesanan untuk pesanan.

extension

object

Semua kolom tambahan 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: Error yang menyebabkan 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 menyebabkan pesanan pembelian (PO) dapat ditolak.

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

enum (ErrorType)

Wajib: Ini menunjukkan alasan terperinci alasan pesanan ditolak oleh penjual.

description

string

Deskripsi error tambahan.

entityId

string

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

updatedPrice

object (PriceAttribute)

Relevan jika jenis error PRICE_CHANGED / INCORRECT_PRICE.

availableQuantity

number

Jumlah yang tersedia sekarang. Berlaku jika terjadi AVAILABILITY_CHANGED.

ErrorType

Kemungkinan jenis error.

Enum
ERROR_TYPE_UNSPECIFIED Error tidak diketahui
NOT_FOUND Entity 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 cukup untuk memenuhi permintaan. ID entitas wajib diisi.
PRICE_CHANGED Harga item berbeda dari harga di entity Item. Perlu ID entitas dan harga terbaru.
INCORRECT_PRICE Error harga dalam Biaya, Total. Perlu ID entitas dan harga terbaru.
REQUIREMENTS_NOT_MET Batasan untuk menerima pesanan tidak terpenuhi - ukuran keranjang minimum, dll.,.
TOO_LATE FulfillmentOption sudah tidak berlaku.
NO_CAPACITY Tidak ada kapasitas layanan yang tersedia.
INELIGIBLE Pengguna tidak memenuhi syarat untuk melakukan pemesanan (masuk daftar yang tidak diizinkan).
OUT_OF_SERVICE_AREA Tidak dapat mengirim ke alamat yang diminta karena aturan perbatasan, dll.
CLOSED Restoran tutup untuk bisnis pada waktu pemesanan.
PROMO_NOT_APPLICABLE Kode error umum untuk menangkap semua kasus kegagalan dalam menerapkan kode promo, jika tidak ada yang sesuai di bawah ini. 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 sudah 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 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

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

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

object (TicketEvent)

Acara diterapkan ke 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 terkait tiket, misalnya, film, konser.

name

string

Wajib: Nama acara. Misalnya, jika peristiwa adalah film, ini harus merupakan 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. Dapat berupa sutradara atau aktor acara film, atau pemain konser, dll.

startDate

object (Time)

Waktu mulai.

endDate

object (Time)

Waktu berakhir.

doorTime

object (Time)

Waktu masuk, yang mungkin berbeda dengan waktu mulai acara. mis. acara dimulai pukul 09.00, tapi waktu masuknya pukul 08.30 WIB.

Jenis

Jenis peristiwa.

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

EventCharacter

Satu karakter peristiwa, mis. penyelenggara, penampil, dll.

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

enum (Type)

Jenis karakter peristiwa, 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 Pengisi Acara.
DIRECTOR Sutradara.
ORGANIZER Penyelenggara.