Method: fulfill

RPC yang mewakili fulfillment API

Permintaan HTTP

POST https://webhook_handler_service.googleapis.com/fulfill

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "handler": {
    object (Handler)
  },
  "intent": {
    object (Intent)
  },
  "scene": {
    object (Scene)
  },
  "session": {
    object (Session)
  },
  "user": {
    object (User)
  },
  "home": {
    object (Home)
  },
  "device": {
    object (Device)
  },
  "context": {
    object (Context)
  }
}
Kolom
handler

object (Handler)

Wajib. Informasi ke fulfillment tentang cara menangani permintaan. Misalnya, permintaan yang bertujuan untuk mendapatkan fakta mungkin memiliki pengendali dengan nama "getFact".

intent

object (Intent)

Wajib. Mewakili intent yang terakhir cocok. Lihat https://developers.google.com/assistant/conversational/intents.

scene

object (Scene)

Opsional. Info tentang scene saat ini dan berikutnya saat fungsi dipanggil. Akan diisi saat panggilan fulfillment dilakukan dalam cakupan adegan. Lihat https://developers.google.com/assistant/conversational/scenes.

session

object (Session)

Wajib. Menyimpan data sesi seperti ID sesi dan parameter sesi.

user

object (User)

Wajib. Pengguna yang memulai percakapan.

home

object (Home)

Opsional. Informasi yang terkait dengan struktur HomeGraph yang memiliki perangkat target. Lihat https://developers.google.com/actions/smarthome/concepts/homegraph.

device

object (Device)

Wajib. Info di perangkat yang digunakan pengguna untuk berinteraksi dengan Action.

context

object (Context)

Opsional. Informasi tentang konteks permintaan saat ini. Mencakup tetapi tidak terbatas pada info sesi media atau info kanvas aktif.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Merepresentasikan respons yang dikirim dari fulfillment developer ke Actions on Google.

Representasi JSON
{
  "prompt": {
    object (Prompt)
  },
  "scene": {
    object (Scene)
  },
  "session": {
    object (Session)
  },
  "user": {
    object (User)
  },
  "home": {
    object (Home)
  },
  "device": {
    object (Device)
  },
  "expected": {
    object (Expected)
  }
}
Kolom
prompt

object (Prompt)

Opsional. Merepresentasikan perintah yang akan dikirim ke pengguna, perintah ini akan ditambahkan ke pesan yang ditambahkan sebelumnya kecuali jika ditimpa secara eksplisit.

scene

object (Scene)

Opsional. Menampilkan scene saat ini dan berikutnya. Jika Scene.next ditetapkan, runtime akan segera bertransisi ke scene yang ditentukan.

session

object (Session)

Opsional. Menjelaskan data untuk sesi saat ini, parameter sesi dapat dibuat, diperbarui, atau dihapus oleh fulfillment.

user

object (User)

Opsional. Gunakan untuk menentukan parameter pengguna yang akan dikirim kembali.

home

object (Home)

Opsional. Digunakan untuk menentukan parameter yang terkait dengan struktur HomeGraph yang memiliki perangkat target. Lihat https://developers.google.com/actions/smarthome/concepts/homegraph.

device

object (Device)

Opsional. Gunakan untuk berpindah antar-perangkat Asisten yang dapat diakses pengguna.

expected

object (Expected)

Opsional. Menjelaskan ekspektasi untuk putaran dialog berikutnya.

Handler

Merepresentasikan pengendali fulfillment yang memetakan informasi peristiwa dari Actions on Google ke fulfillment. Gunakan nama pengendali untuk menentukan kode apa yang harus Anda jalankan dalam fulfillment. Misalnya, pengendali dapat digunakan untuk mendapatkan informasi tentang informasi pesanan pengguna dengan nama pengendali seperti "OrderLookup" sementara yang lain mungkin mendapatkan informasi produk dari database, dengan nama pengendali seperti "GetProductInfo".

Representasi JSON
{
  "name": string
}
Kolom
name

string

Opsional. Nama pengendali.

Intent

Menunjukkan intent. Lihat https://developers.google.com/assistant/conversational/intents.

Representasi JSON
{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}
Kolom
name

string

Wajib. Nama intent yang terakhir cocok.

params

map (key: string, value: object (IntentParameterValue))

Wajib. Mewakili parameter yang diidentifikasi sebagai bagian dari pencocokan intent. Ini adalah peta nama parameter yang diidentifikasi terhadap nilai parameter yang diidentifikasi dari input pengguna. Semua parameter yang ditentukan dalam intent yang cocok yang diidentifikasi akan ditampilkan di sini.

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

query

string

Opsional. Input yang diketik atau diucapkan dari pengguna akhir yang cocok dengan intent ini. Ini akan diisi saat intent cocok, berdasarkan input pengguna.

IntentParameterValue

Merepresentasikan nilai untuk parameter intent. Lihat https://developers.google.com/assistant/conversational/types.

Representasi JSON
{
  "original": string,
  "resolved": value
}
Kolom
original

string

Wajib. Nilai teks asli diekstrak dari ucapan pengguna.

resolved

value (Value format)

Wajib. Nilai terstruktur untuk parameter yang diekstrak dari input pengguna. Kolom ini hanya akan diisi jika parameter ditetapkan dalam intent yang cocok dan nilai parameter dapat diidentifikasi selama pencocokan intent.

Scene

Merepresentasikan suasana. Scene dapat memanggil fulfillment, menambahkan prompt, dan mengumpulkan nilai slot dari pengguna. Scene dipicu oleh peristiwa atau intent dan dapat memicu peristiwa serta mencocokkan intent untuk beralih ke scene lain.

Representasi JSON
{
  "name": string,
  "slotFillingStatus": enum (SlotFillingStatus),
  "slots": {
    string: {
      object (Slot)
    },
    ...
  },
  "next": {
    object (NextScene)
  }
}
Kolom
name

string

Wajib. Nama adegan saat ini.

slotFillingStatus

enum (SlotFillingStatus)

Wajib. Status pengisian slot saat ini. Kolom ini bersifat hanya baca.

slots

map (key: string, value: object (Slot))

Slot yang terkait dengan adegan saat ini. Respons pengendali tidak dapat menampilkan slot yang tidak dikirim dalam permintaan.

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

next

object (NextScene)

Opsional. Informasi tentang adegan yang akan dieksekusi berikutnya.

SlotFillingStatus

Mewakili status pengisian slot saat ini.

Enum
UNSPECIFIED Nilai penggantian saat kolom penggunaan tidak diisi.
INITIALIZED Slot telah diinisialisasi, tetapi pengisian slot belum dimulai.
COLLECTING Nilai slot sedang dikumpulkan.
FINAL Semua nilai slot bersifat final dan tidak dapat diubah.

Slot

Menampilkan slot.

Representasi JSON
{
  "mode": enum (SlotMode),
  "status": enum (SlotStatus),
  "value": value,
  "updated": boolean,
  "prompt": {
    object (Prompt)
  }
}
Kolom
mode

enum (SlotMode)

Mode slot (wajib atau opsional). Dapat disetel oleh developer.

status

enum (SlotStatus)

Status slot.

value

value (Value format)

Nilai slot. Mengubah nilai ini dalam respons akan mengubah nilai dalam pengisian slot.

updated

boolean

Menunjukkan apakah nilai slot dikumpulkan pada belokan terakhir. Kolom ini bersifat hanya baca.

prompt

object (Prompt)

Opsional. Perintah ini dikirim kepada pengguna saat diperlukan untuk mengisi slot yang diperlukan. Perintah ini menggantikan perintah yang sudah ada yang ditentukan di konsol. Kolom ini tidak disertakan dalam permintaan webhook.

SlotMode

Menampilkan mode slot, yaitu jika diperlukan atau tidak.

Enum
MODE_UNSPECIFIED Nilai penggantian saat kolom penggunaan tidak diisi.
OPTIONAL Menunjukkan bahwa slot tidak diperlukan untuk menyelesaikan pengisian slot.
REQUIRED Menunjukkan bahwa slot diperlukan untuk menyelesaikan pengisian slot.

SlotStatus

Menampilkan status slot.

Enum
SLOT_UNSPECIFIED Nilai penggantian saat kolom penggunaan tidak diisi.
EMPTY Menunjukkan bahwa slot tidak memiliki nilai apa pun. Status ini tidak dapat diubah melalui respons.
INVALID Menunjukkan bahwa nilai slot tidak valid. Status ini dapat ditetapkan melalui respons.
FILLED Menunjukkan bahwa slot memiliki nilai. Status ini tidak dapat diubah melalui respons.

Perintah

Merepresentasikan respons kepada pengguna. Lihat https://developers.google.com/assistant/conversational/prompts.

Representasi JSON
{
  "override": boolean,
  "firstSimple": {
    object (Simple)
  },
  "content": {
    object (Content)
  },
  "lastSimple": {
    object (Simple)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (Link)
  },
  "canvas": {
    object (Canvas)
  },
  "orderUpdate": {
    object (OrderUpdate)
  }
}
Kolom
override

boolean

Opsional. Mode untuk menggabungkan pesan ini dengan pesan yang telah ditetapkan sebelumnya. "true" (benar) menghapus semua pesan yang ditetapkan sebelumnya (pertama dan terakhir, konten, link saran, dan kanvas) serta menambahkan pesan yang ditentukan dalam perintah ini. "salah" akan menambahkan pesan yang ditentukan dalam dialog ini ke pesan yang ditentukan dalam respons sebelumnya. Membiarkan kolom ini menjadi "false" juga memungkinkan penambahan ke beberapa kolom di dalam Perintah sederhana, dialog Saran, dan perintah Canvas (bagian dari dialog Konten). Pesan Content dan Link akan selalu ditimpa jika ditentukan dalam perintah. Nilai defaultnya adalah "false".

firstSimple

object (Simple)

Opsional. Respons suara dan teks saja pertama.

content

object (Content)

Opsional. Konten seperti kartu, daftar, atau media yang akan ditampilkan kepada pengguna.

lastSimple

object (Simple)

Opsional. Suara terakhir dan respons hanya teks.

suggestions[]

object (Suggestion)

Opsional. Saran untuk ditampilkan kepada pengguna, yang akan selalu muncul di akhir respons. Jika "ganti" dalam perintah yang berisi "false", judul yang ditetapkan dalam kolom ini akan ditambahkan ke judul yang ditetapkan dalam perintah saran yang ditetapkan sebelumnya dan nilai duplikat akan dihapus.

canvas

object (Canvas)

Opsional. Merepresentasikan respons Canvas Interaktif yang akan dikirim ke pengguna.

orderUpdate

object (OrderUpdate)

Action Opsional merespons dengan OrderUpdate setelah menerima pesanan selama alur transaksi. Setelah menerima permintaan ini, Google akan mencatat pembaruan ini pada pesanan, dan jika berhasil, menampilkan kartu tanda terima bersama dengan TTS yang dikirim pada perangkat layar.

Sederhana

Menampilkan prompt sederhana yang akan dikirim ke pengguna. Lihat https://developers.google.com/assistant/conversational/prompts-simple.

Representasi JSON
{
  "speech": string,
  "text": string
}
Kolom
speech

string

Opsional. Menunjukkan ucapan yang akan diucapkan kepada pengguna. Dapat berupa SSML atau text to speech. Jika "ganti" dalam prompt yang memuatnya adalah "true", ucapan yang ditentukan dalam kolom ini menggantikan ucapan perintah Sederhana sebelumnya. Lihat https://developers.google.com/assistant/conversational/ssml.

text

string

Teks opsional untuk ditampilkan dalam balon chat. Jika tidak diberikan, rendering tampilan untuk kolom ucapan di atas akan digunakan. Dibatasi hingga 640 karakter. Jika "ganti" dalam prompt yang memuatnya adalah "true", teks yang ditetapkan dalam kolom ini akan menggantikan teks perintah Sederhana sebelumnya.

Konten

Objek container untuk prompt lengkap atau prompt pemilihan.

Representasi JSON
{

  // Union field content can be only one of the following:
  "card": {
    object (Card)
  },
  "image": {
    object (Image)
  },
  "table": {
    object (Table)
  },
  "media": {
    object (Media)
  },
  "collection": {
    object (Collection)
  },
  "list": {
    object (List)
  },
  "collectionBrowse": {
    object (CollectionBrowse)
  }
  // End of list of possible types for union field content.
}
Kolom

Kolom union content.

content hanya dapat berupa salah satu dari yang berikut:

card

object (Card)

Kartu dasar.

image

object (Image)

Gambar.

table

object (Table)

Kartu tabel.

media

object (Media)

Respons yang menunjukkan kumpulan media yang akan diputar.

collection

object (Collection)

Kartu yang menampilkan sekumpulan opsi yang dapat dipilih.

list

object (List)

Kartu yang menampilkan daftar opsi yang dapat dipilih.

collectionBrowse

object (CollectionBrowse)

Kartu yang menampilkan kumpulan halaman web yang akan dibuka.

Kartu

Kartu dasar untuk menampilkan beberapa informasi, misalnya gambar dan/atau teks. Lihat https://developers.google.com/assistant/conversational/prompts-rich#basic_card.

Representasi JSON
{
  "title": string,
  "subtitle": string,
  "text": string,
  "image": {
    object (Image)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (Link)
  }
}
Kolom
title

string

Keseluruhan judul kartu. Opsional.

subtitle

string

Opsional.

text

string

Teks isi kartu. Mendukung serangkaian sintaksis markdown terbatas untuk pemformatan. Wajib, kecuali ada gambar.

image

object (Image)

Banner besar untuk kartu. Tinggi ditetapkan ke 192 dp. Opsional.

imageFill

enum (ImageFill)

Cara latar belakang gambar akan diisi. Opsional.

button

object (Link)

Tombol dengan link keluar. Opsional.

Gambar

Gambar yang ditampilkan di kartu. Lihat https://developers.google.com/assistant/conversational/prompts-rich#image-cards.

Representasi JSON
{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}
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.

alt

string

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

height

integer

Tinggi gambar dalam piksel. Opsional.

width

integer

Lebar gambar dalam piksel. Opsional.

ImageFill

Opsi tampilan gambar yang mungkin untuk memengaruhi penyajian gambar. Ini harus digunakan jika rasio aspek gambar tidak cocok dengan rasio aspek penampung gambar.

Enum
UNSPECIFIED
GRAY Isi celah antara gambar dan penampung gambar dengan kotak abu-abu.
WHITE Isi celah antara gambar dan penampung gambar dengan kotak putih.
CROPPED Gambar diskalakan sedemikian rupa sehingga lebar dan tinggi gambar sesuai atau melebihi dimensi container. Tindakan ini dapat memangkas bagian atas dan bawah gambar jika tinggi gambar yang diskalakan lebih besar dari tinggi penampung, atau memangkas bagian kiri dan kanan gambar jika lebar gambar yang diskalakan lebih besar dari lebar penampung. Ini mirip dengan "Mode Zoom" di TV layar lebar saat memutar video dengan rasio aspek 4:3.

OpenUrl

Representasi JSON
{
  "url": string,
  "hint": enum (UrlHint)
}
Kolom
url

string

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

hint

enum (UrlHint)

Menunjukkan petunjuk untuk jenis URL.

UrlHint

Berbagai jenis petunjuk URL.

Enum
AMP URL yang mengarah langsung ke konten AMP, atau URL kanonis yang merujuk ke konten AMP melalui . Lihat https://amp.dev/.

Tabel

Kartu tabel untuk menampilkan tabel teks. Lihat https://developers.google.com/assistant/conversational/prompts-rich#table_cards.

Representasi JSON
{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (Link)
  }
}
Kolom
title

string

Judul tabel keseluruhan. Opsional, tetapi harus ditetapkan jika subtitel disetel.

subtitle

string

Subtitel untuk tabel. Opsional.

image

object (Image)

Gambar yang terkait dengan tabel. Opsional.

columns[]

object (TableColumn)

Header dan perataan kolom.

rows[]

object (TableRow)

Data baris pada tabel. Tiga baris pertama dijamin akan ditampilkan, tetapi baris lainnya mungkin dipotong di platform tertentu. Uji dengan simulator guna melihat baris yang akan ditampilkan untuk platform tertentu. Pada platform yang mendukung kemampuan WEB_BROWSER, Anda dapat mengarahkan pengguna ke halaman web yang berisi lebih banyak data.

button

object (Link)

Tombol.

TableColumn

Representasi JSON
{
  "header": string,
  "align": enum (HorizontalAlignment)
}
Kolom
header

string

Teks header untuk kolom.

align

enum (HorizontalAlignment)

Perataan horizontal kolom w.r.t konten. Jika tidak ditentukan, konten akan disejajarkan dengan bagian tepi utama.

HorizontalAlignment

Perataan konten di dalam sel.

Enum
UNSPECIFIED
LEADING Tepi depan sel. Ini adalah defaultnya.
CENTER Konten sejajar dengan bagian tengah kolom.
TRAILING Konten sejajar dengan tepi akhir kolom.

TableRow

Mendeskripsikan baris dalam tabel.

Representasi JSON
{
  "cells": [
    {
      object (TableCell)
    }
  ],
  "divider": boolean
}
Kolom
cells[]

object (TableCell)

Sel di baris ini. Tiga sel pertama dijamin akan ditampilkan, tetapi sel lainnya mungkin terpotong pada permukaan tertentu. Uji dengan simulator untuk mengetahui sel mana yang akan ditampilkan untuk permukaan tertentu.

divider

boolean

Menunjukkan apakah harus ada pemisah setelah setiap baris.

TableCell

Menggambarkan sel dalam baris.

Representasi JSON
{
  "text": string
}
Kolom
text

string

Konten teks dalam sel.

Media

Mewakili satu objek media. Berisi informasi tentang media, seperti nama, deskripsi, URL, dll. Lihat https://developers.google.com/assistant/conversational/prompts-media.

Representasi JSON
{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ],
  "repeatMode": enum (RepeatMode),
  "firstMediaObjectIndex": integer
}
Kolom
mediaType

enum (MediaType)

startOffset

string (Duration format)

Offset awal objek media pertama.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

optionalMediaControls[]

enum (OptionalMediaControls)

Jenis kontrol media opsional yang dapat didukung sesi respons media ini. Jika disetel, permintaan akan dibuat ke pihak ketiga saat peristiwa media tertentu terjadi. Jika tidak ditetapkan, 3p tetap harus menangani dua jenis kontrol default, FINISHED dan FAILED.

mediaObjects[]

object (MediaObject)

Daftar Objek Media

repeatMode

enum (RepeatMode)

Mode pengulangan untuk daftar Objek Media.

firstMediaObjectIndex

integer

indeks berbasis 0 dari Objek Media pertama di mediaObjects yang akan diputar. Jika tidak ditentukan, nol atau di luar batas, pemutaran akan dimulai dari objek media pertama di mediaObject.

MediaType

Jenis media respons ini.

Enum
MEDIA_TYPE_UNSPECIFIED
AUDIO File audio.
MEDIA_STATUS_ACK Respons untuk mengonfirmasi laporan status media.

OptionalMediaControls

Jenis kontrol media opsional yang dapat didukung respons media

Enum
OPTIONAL_MEDIA_CONTROLS_UNSPECIFIED Nilai belum ditetapkan
PAUSED Acara dijeda. Dipicu saat pengguna menjeda media.
STOPPED Peristiwa dihentikan. Dipicu saat pengguna keluar dari sesi 3p selama pemutaran media.

MediaObject

Mewakili satu objek media

Representasi JSON
{
  "name": string,
  "description": string,
  "url": string,
  "image": {
    object (MediaImage)
  }
}
Kolom
name

string

Nama objek media ini.

description

string

Deskripsi objek media ini.

url

string

URL yang mengarah ke konten media. File MP3 harus dihosting di server web dan tersedia untuk publik melalui URL HTTPS. Live streaming hanya didukung untuk format MP3.

image

object (MediaImage)

Gambar yang akan ditampilkan dengan kartu media.

MediaImage

Representasi JSON
{

  // Union field image can be only one of the following:
  "large": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}
Kolom

Kolom union image.

image hanya dapat berupa salah satu dari yang berikut:

large

object (Image)

Gambar berukuran besar, seperti sampul album, dll.

icon

object (Image)

Ikon gambar kecil ditampilkan di sebelah kanan dari judul. Ukurannya diubah menjadi 36x36 dp.

RepeatMode

Jenis mode pengulangan untuk daftar objek media.

Enum
REPEAT_MODE_UNSPECIFIED Setara dengan MATI.
OFF Akhiri sesi media di akhir objek media terakhir.
ALL Memutar ke awal objek media pertama saat akhir objek media terakhir tercapai.

Koleksi

Kartu untuk menyajikan kumpulan opsi yang dapat dipilih. Lihat https://developers.google.com/assistant/conversational/prompts-selection#collection

Representasi JSON
{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}
Kolom
title

string

Judul koleksi. Opsional.

subtitle

string

Subtitel koleksi. Opsional.

items[]

object (CollectionItem)

Daftar item. Nilai minimum dapat memiliki nilai minimum 2 dan maksimum 10.

imageFill

enum (ImageFill)

Cara latar belakang gambar item koleksi akan diisi. Opsional.

CollectionItem

Item dalam koleksi

Representasi JSON
{
  "key": string
}
Kolom
key

string

Wajib. Kunci NLU yang cocok dengan nama kunci entri di Jenis yang terkait.

Daftar

Kartu untuk menyajikan daftar opsi yang dapat dipilih. Lihat https://developers.google.com/assistant/conversational/prompts-selection#list

Representasi JSON
{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (ListItem)
    }
  ]
}
Kolom
title

string

Judul daftar. Opsional.

subtitle

string

Subtitel daftar. Opsional.

items[]

object (ListItem)

Daftar item. Nilai minimum dapat memiliki nilai minimum 2 dan maksimum 30.

ListItem

Item dalam daftar

Representasi JSON
{
  "key": string
}
Kolom
key

string

Wajib. Kunci NLU yang cocok dengan nama kunci entri di Jenis yang terkait.

CollectionBrowse

Menyajikan serangkaian dokumen web sebagai kumpulan item ubin besar. Item dapat dipilih untuk meluncurkan dokumen web terkait di penampil web. Lihat https://developers.google.com/assistant/conversational/prompts-selection#collectionBrowse.

Representasi JSON
{
  "items": [
    {
      object (Item)
    }
  ],
  "imageFill": enum (ImageFill)
}
Kolom
items[]

object (Item)

Daftar item. Nilai minimum dapat memiliki nilai minimum 2 dan maksimum 10.

imageFill

enum (ImageFill)

Jenis opsi tampilan gambar.

Item

Item dalam koleksi.

Representasi JSON
{
  "title": string,
  "description": string,
  "footer": string,
  "image": {
    object (Image)
  },
  "openUriAction": {
    object (OpenUrl)
  }
}
Kolom
title

string

Wajib. Judul item koleksi.

description

string

Deskripsi item koleksi.

footer

string

Teks footer untuk item koleksi, ditampilkan di bawah deskripsi. Satu baris teks, terpotong dengan elipsis.

image

object (Image)

Gambar untuk item koleksi.

openUriAction

object (OpenUrl)

Wajib. URI yang akan dibuka jika item dipilih.

Saran

Saran memberikan chip saran kepada pengguna di perangkat yang mendukung layar saat Asisten menampilkan perintah. Gunakan chip saran untuk memberikan petunjuk tentang respons pengguna guna melanjutkan atau melakukan pivot percakapan. Saat diketuk, chip saran akan menampilkan teks yang ditampilkan ke percakapan kata demi kata, seolah-olah pengguna telah mengetiknya. Lihat https://developers.google.com/assistant/conversational/prompts#suggestions,

Representasi JSON
{
  "title": string
}
Kolom
title

string

Wajib. Teks yang ditampilkan dalam chip saran. Saat diketuk, teks ini akan diposting kembali ke percakapan kata demi kata seolah-olah pengguna telah mengetiknya. Setiap judul harus unik di antara kumpulan chip saran. Maksimal 25 karakter

Kanvas

Merepresentasikan respons Canvas Interaktif yang akan dikirim ke pengguna. Ini dapat digunakan bersamaan dengan model "firstSimple" di dalam prompt yang berisi prompt untuk berbicara dengan pengguna selain menampilkan respons kanvas interaktif. Ukuran respons maksimum adalah 50 ribu byte. Lihat https://developers.google.com/assistant/interactivecanvas.

Representasi JSON
{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "continuousMatchConfig": {
    object (ContinuousMatchConfig)
  }
}
Kolom
url

string

URL aplikasi web kanvas interaktif yang akan dimuat. Jika tidak ditetapkan, URL dari kanvas yang aktif saat ini akan digunakan kembali.

data[]

value (Value format)

Opsional. Data JSON akan diteruskan ke halaman web pengalaman imersif sebagai peristiwa. Jika "ganti" pada prompt yang memuatnya adalah "false" nilai data yang ditentukan dalam perintah Canvas ini akan ditambahkan setelah nilai data ditentukan dalam perintah Canvas sebelumnya.

suppressMic

boolean

Opsional. Nilai default: false.

continuousMatchConfig

object (ContinuousMatchConfig)

Konfigurasi yang digunakan untuk memulai mode pencocokan berkelanjutan.

ContinuousMatchConfig

Konfigurasi yang digunakan untuk memulai mode pencocokan berkelanjutan.

Representasi JSON
{
  "expectedPhrases": [
    {
      object (ExpectedPhrase)
    }
  ],
  "durationSeconds": integer
}
Kolom
expectedPhrases[]

object (ExpectedPhrase)

Semua kemungkinan frasa yang diharapkan selama sesi mode pencocokan berkelanjutan ini.

durationSeconds

integer

Durasi untuk tetap mengaktifkan mode pencocokan berkelanjutan. Jika ditentukan, mikrofon akan ditutup saat waktu habis. Nilai maksimum yang diizinkan adalah 180.

ExpectedPhrase

Representasi JSON
{
  "phrase": string,
  "alternativePhrases": [
    string
  ]
}
Kolom
phrase

string

Frasa yang cocok selama sesi mode pencocokan berkelanjutan.

alternativePhrases[]

string

Beberapa frasa mungkin salah dikenali oleh model ucapan, bahkan jika terdapat bias ucapan. Hal ini memungkinkan developer menentukan pemicu alternatif untuk homofon.

OrderUpdate

Pembaruan pada pesanan.

Representasi JSON
{
  "type": enum (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}
Kolom
type
(deprecated)

enum (Type)

Tidak digunakan lagi: Sebagai gantinya, gunakan OrderUpdate.update_mask. Jika jenis = SNAPSHOT, OrderUpdate.order harus merupakan seluruh pesanan. Jika jenis = ORDER_STATUS, ini adalah perubahan status tingkat pesanan. Hanya order.last_update_time dan status vertical ini yang diambil. Catatan: type.ORDER_STATUS hanya mendukung pembaruan status PurcahaseOrderExtension dan tidak ada rencana untuk memperpanjang dukungan ini. Sebagai gantinya, kami merekomendasikan penggunaan updateMask karena lebih umum, dapat diperluas, dan dapat digunakan untuk semua vertical.

order

object (Order)

updateMask

string (FieldMask format)

Catatan: Ada pertimbangan/rekomendasi berikut untuk kolom khusus berikut: 1. order.last_update_time akan selalu diperbarui sebagai bagian dari permintaan pembaruan. 2. order.create_time, order.google_order_id, dan order.merchant_order_id akan diabaikan jika diberikan sebagai bagian dari updateMask.

Ini adalah daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

userNotification

object (UserNotification)

Jika ditentukan, menampilkan notifikasi kepada pengguna dengan judul dan teks yang ditentukan. Menentukan notifikasi adalah saran untuk memberi tahu dan tidak dijamin akan menghasilkan notifikasi.

reason

string

Alasan perubahan/pembaruan.

Jenis

Tidak digunakan lagi: Sebagai gantinya, gunakan OrderUpdate.update_mask. Mengizinkan pembaruan pada pesanan.

Enum
TYPE_UNSPECIFIED Jenis tidak ditentukan, tidak boleh ditetapkan secara eksplisit.
ORDER_STATUS Hanya perbarui status pesanan.
SNAPSHOT Perbarui ringkasan pesanan.

Pesan

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 berjumlah kurang dari 50, 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 RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

Tanggal dan waktu pesanan terakhir diperbarui. Wajib untuk OrderUpdate.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "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 tindak lanjut 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 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 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": integer,
  "width": integer
}
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 {i>screen reader <i}(pembaca layar). Wajib.

height

integer

Tinggi gambar dalam piksel. Opsional.

width

integer

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 merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double untuk mewakili derajat lintang dan derajat bujur. Kecuali jika ditentukan lain, objek ini 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": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Kolom
revision

integer

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. 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. Minimal 1 item baris wajib diisi dan maksimal 50 item baris yang diizinkan. 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 berjumlah kurang dari 50, 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,
  "id": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": integer
  // 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.

id

string

Opsional: ID item baris yang sesuai dengan harga ini.

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)

integer

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, tetapi jumlah akhirnya akan mendekati jumlah ini. Contoh: Jika pajak tidak diketahui secara akurat pada saat transaksi, totalnya adalah jumlah ESTIMASI.
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 PANGGILAN 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": integer,
  "maxVersion": integer
}
Kolom
minVersion

integer

Kode versi min atau 0, inklusif.

maxVersion

integer

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 RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "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": integer,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "productDetails": {
    object (ProductDetails)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
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

integer

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.

productDetails

object (ProductDetails)

Detail tentang produk.

extension
(deprecated)

object

Semua kolom tambahan yang dipertukarkan antara penjual dan Google. Catatan: Penggunaan ekstensi ini sangat tidak disarankan. Berdasarkan kasus penggunaan/situasi, pertimbangkan salah satu hal berikut: 1. Tentukan kolom di PurchaseItemExtension jika kolom tersebut dapat digunakan untuk kasus penggunaan lainnya (yaitu kemampuan/fungsi umum). 2. Gunakan vertical_extension jika spesifik untuk kasus penggunaan/fitur non-generik.

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

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": integer,
  "policyUrl": string
}
Kolom
isReturnable

boolean

Jika true (benar), ditampilkan diizinkan.

daysToReturn

integer

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 RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "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 mengantarkan makanan di 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.

model

string

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

licensePlate

string

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

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": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Kolom
id

string

Untuk opsi yang berupa item, ID item unik.

name

string

Nama opsi.

prices[]

object (PriceAttribute)

Total harga opsi.

note

string

Catatan terkait opsi.

quantity

integer

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.

Representasi JSON
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": integer,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  }
}
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

integer

Jumlah orang.

staffFacilitators[]

object (StaffFacilitator)

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

location

object (Location)

Lokasi layanan/peristiwa.

ReservationStatus

Status reservasi.

Enum
RESERVATION_STATUS_UNSPECIFIED Status belum ditetapkan.
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 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 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)
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
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.

purchaseLocationType

enum (PurchaseLocationType)

Lokasi pembelian (di toko / online)

errors[]

object (PurchaseError)

Opsional: Error yang menyebabkan pesanan ini ditolak.

extension
(deprecated)

object

Semua kolom tambahan yang dipertukarkan antara penjual dan Google. Catatan: Penggunaan ekstensi ini sangat tidak disarankan. Berdasarkan kasus penggunaan/situasi, pertimbangkan salah satu hal berikut: 1. Tentukan kolom di PurchaseOrderExtension jika kolom tersebut dapat digunakan untuk kasus penggunaan lainnya (yaitu, kemampuan/fungsi umum). 2. Gunakan vertical_extension jika spesifik untuk kasus penggunaan/fitur non-generik.

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

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": integer
}
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

integer

Jumlah yang tersedia sekarang. Berlaku jika 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. Gunakan kode error ini jika tidak ada jenis error yang lebih mendetail yang berlaku.
NO_COURIER_AVAILABLE Tidak ada kurir pengiriman yang dapat ditemukan. Jenis error mendetail yang dapat dikategorikan sebagai NO_CAPACity.
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.
ACCOUNT_LINKING_FAILED Penjual mencoba menautkan Akun Google pengguna ke akun di sistemnya, tetapi mengalami error saat melakukannya.

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.

UserNotification

Notifikasi pengguna opsional untuk ditampilkan sebagai bagian dari Pembaruan pesanan.

Representasi JSON
{
  "title": string,
  "text": string
}
Kolom
title

string

Judul untuk notifikasi pengguna. Panjang maksimum yang diizinkan adalah 30 karakter.

text

string

Isi notifikasi. Panjang maksimum yang diizinkan adalah 100 karakter.

NextScene

Menampilkan scene yang akan dieksekusi berikutnya.

Representasi JSON
{
  "name": string
}
Kolom
name

string

Nama scene yang akan dieksekusi berikutnya.

Sesi

Berisi informasi tentang sesi percakapan saat ini

Representasi JSON
{
  "id": string,
  "params": {
    string: value,
    ...
  },
  "typeOverrides": [
    {
      object (TypeOverride)
    }
  ],
  "languageCode": string
}
Kolom
id

string

Wajib. ID unik global untuk sesi percakapan saat ini. Kolom ini bersifat hanya baca.

params

map (key: string, value: value (Value format))

Wajib. Daftar semua parameter yang dikumpulkan dari formulir dan intent selama sesi. Kunci adalah nama parameter. Parameter yang ditentukan di sini akan digabungkan dengan parameter yang sudah ditentukan dalam sesi. Parameter dengan nilai null akan dihapus dari sesi. Lihat dokumentasi penyimpanan sesi: https://developers.google.com/assistant/conversational/storage-session.

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

typeOverrides[]

object (TypeOverride)

Opsional. Jenis yang dicakupkan ke sesi. Definisi jenis sesi dapat melengkapi atau mengganti jenis yang ada. Nama jenis harus unik.

languageCode

string

Bahasa sesi percakapan saat ini. Mengikuti kode bahasa IETF BCP-47 http://www.rfc-editor.org/rfc/bcp/bcp47.txt. Hal ini mungkin berbeda dari lokalitas pengguna jika tindakan tersebut menggunakan fitur multibahasa. Misalnya, saat handler_response.expected.language_code ditetapkan, ini akan mengubah bahasa percakapan untuk semua giliran berikutnya, yang akan tercermin di kolom ini.

TypeOverride

Merepresentasikan penggantian untuk suatu jenis.

Representasi JSON
{
  "name": string,
  "mode": enum (TypeOverrideMode),
  "synonym": {
    object (SynonymType)
  }
}
Kolom
name

string

Wajib. Nama jenis yang akan dilengkapi atau diganti.

mode

enum (TypeOverrideMode)

Wajib. Cara jenis ini harus digabungkan dengan nilai jenis lainnya.

synonym

object (SynonymType)

TypeOverrideMode

Jenis perubahan untuk jenis entitas sesi.

Enum
TYPE_UNSPECIFIED Tidak ditentukan. Nilai ini tidak boleh digunakan.
TYPE_REPLACE Definisi jenis dalam respons ini akan menggantikan definisi jenis yang telah ditentukan sebelumnya.
TYPE_MERGE Definisi jenis dalam respons ini akan digabungkan dengan definisi jenis yang telah ditentukan sebelumnya. Definisi jenis baru akan menimpa definisi jenis yang ada.

SynonymType

Merepresentasikan jenis dengan sinonim.

Representasi JSON
{
  "entries": [
    {
      object (Entry)
    }
  ]
}
Kolom
entries[]

object (Entry)

Wajib. Daftar entri untuk jenis sinonim.

Entri

Mewakili entri untuk jenis sinonim.

Representasi JSON
{
  "name": string,
  "synonyms": [
    string
  ],
  "display": {
    object (EntryDisplay)
  }
}
Kolom
name

string

Wajib. Nama entri (misalnya, "sepeda"). Entri dalam kolom ini harus disertakan dalam kolom sinonim berulang agar dianggap sebagai nilai jenis yang valid.

synonyms[]

string

Wajib. Daftar sinonim untuk entri (misalnya, "bike", "cycle").

display

object (EntryDisplay)

Opsional. Informasi tampilan item.

EntryDisplay

Representasi JSON
{
  "title": string,
  "description": string,
  "image": {
    object (Image)
  },
  "footer": string,
  "openUrl": {
    object (OpenUrl)
  }
}
Kolom
title

string

Wajib. Judul item. Saat diketuk, teks ini akan diposting kembali ke percakapan kata demi kata seolah-olah pengguna telah mengetiknya. Setiap judul harus unik di antara kumpulan item koleksi.

description

string

Opsional. Teks isi kartu.

image

object (Image)

Opsional. Gambar yang akan ditampilkan.

footer

string

Opsional. Teks footer untuk item koleksi penjelajahan, ditampilkan di bawah deskripsi. Satu baris teks, terpotong dengan elipsis.

openUrl

object (OpenUrl)

URL dokumen yang terkait dengan item carousel penjelajahan. Diperlukan untuk penjelajahan carousel.

Pengguna

Menampilkan pengguna yang membuat permintaan ke Action.

Representasi JSON
{
  "locale": string,
  "params": {
    string: value,
    ...
  },
  "accountLinkingStatus": enum (AccountLinkingStatus),
  "verificationStatus": enum (UserVerificationStatus),
  "lastSeenTime": string,
  "engagement": {
    object (Engagement)
  },
  "packageEntitlements": [
    {
      object (PackageEntitlements)
    }
  ],
  "permissions": [
    enum (Permission)
  ]
}
Kolom
locale

string

Setelan lokalitas utama pengguna yang membuat permintaan. Mengikuti kode bahasa IETF BCP-47 http://www.rfc-editor.org/rfc/bcp/bcp47.txt. Namun, subtag skrip tidak disertakan.

params

map (key: string, value: value (Value format))

Opsional. Daftar semua parameter yang terkait dengan pengguna saat ini. Lihat dokumentasi penyimpanan pengguna: https://developers.google.com/assistant/conversational/storage-user.

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

accountLinkingStatus

enum (AccountLinkingStatus)

Apakah akun pengguna ditautkan ke aplikasi.

verificationStatus

enum (UserVerificationStatus)

Menunjukkan status verifikasi pengguna.

lastSeenTime

string (Timestamp format)

Stempel waktu interaksi terakhir dengan pengguna ini. Kolom ini akan dihapus jika pengguna belum berinteraksi dengan agen sebelumnya.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

engagement

object (Engagement)

Engagement pengguna saat ini termasuk langganan apa pun ke intent.

packageEntitlements[]

object (PackageEntitlements)

Hak pengguna yang terkait dengan paket Android yang terkait dengan tindakan saat ini.

permissions[]

enum (Permission)

Berisi izin yang diberikan oleh pengguna untuk Action ini.

AccountLinkingStatus

Menunjukkan apakah pengguna akhir telah menautkan akunnya ke aplikasi ini. Lihat dokumentasi penautan akun: https://developers.google.com/assistant/identity.

Enum
ACCOUNT_LINKING_STATUS_UNSPECIFIED Tak diketahui.
NOT_LINKED Pengguna belum menautkan akunnya ke aplikasi ini.
LINKED Pengguna telah menautkan akunnya ke aplikasi ini.

UserVerificationStatus

Menunjukkan apakah Google telah memverifikasi pengguna. Status VERIFIED menunjukkan bahwa Anda dapat menyimpan data di seluruh percakapan menggunakan kolom parameter atau dengan penautan akun.

Enum
USER_VERIFICATION_STATUS_UNSPECIFIED Tak diketahui.
GUEST Pengguna tamu.
VERIFIED Pengguna terverifikasi.

Engagement

Memberikan informasi tambahan hanya baca tentang mekanisme interaksi yang telah didaftarkan pengguna saat ini. Misalnya, akan sangat berguna jika mengetahui intent yang sudah menjadi langganan pengguna untuk menghindari permintaan mereka untuk berlangganan intent yang sama lagi. yaitu, informasi ini dapat digunakan untuk merutekan secara kondisional ke scene guna menyiapkan DailyUpdates atau PushNotifications hanya jika pengguna belum berlangganan. Lihat dokumentasi engagement pengguna: https://developers.google.com/assistant/engagement.

Representasi JSON
{
  "pushNotificationIntents": [
    {
      object (IntentSubscription)
    }
  ],
  "dailyUpdateIntents": [
    {
      object (IntentSubscription)
    }
  ]
}
Kolom
pushNotificationIntents[]

object (IntentSubscription)

Berisi daftar intent yang notifikasi pushnya telah diaktifkan oleh pengguna.

dailyUpdateIntents[]

object (IntentSubscription)

Berisi daftar intent yang update hariannya telah diaktifkan oleh pengguna.

IntentSubscription

Menjelaskan IntentSubscription yang ada.

Representasi JSON
{
  "intent": string,
  "contentTitle": string
}
Kolom
intent

string

Nama intent yang berlangganan.

contentTitle

string

Deskripsi singkat tentang langganan. Nama ini digunakan sebagai label notifikasi dan saat Asisten meminta izin dari pengguna.

PackageEntitlements

Daftar hak pengguna yang terkait dengan nama paket. Lihat dokumentasi transaksi digital yang bermanfaat: https://developers.google.com/assistant/transactions/digital/dev-guide-digital-non-consumables.

Representasi JSON
{
  "packageName": string,
  "entitlements": [
    {
      object (Entitlement)
    }
  ]
}
Kolom
packageName

string

Nama paket Android yang ditetapkan dalam paket tindakan.

entitlements[]

object (Entitlement)

Hak pengguna untuk paket yang diberikan.

Kepemilikan hak

Menentukan hak digital pengguna.

Representasi JSON
{
  "sku": string,
  "skuType": enum (SkuType),
  "inAppDetails": {
    object (SignedData)
  }
}
Kolom
sku

string

SKU produk. Nama paket untuk aplikasi berbayar, akhiran Finsky docid untuk pembelian dalam aplikasi dan langganan dalam aplikasi. Cocokkan getSku() di Play InApp Billing API. Lihat dokumentasi Penagihan via Google Play: https://developer.android.com/google/play/billing.

skuType

enum (SkuType)

Jenis SKU.

inAppDetails

object (SignedData)

Hanya ada untuk pembelian dalam aplikasi dan langganan dalam aplikasi.

SkuType

Enum
SKU_TYPE_UNSPECIFIED
IN_APP Pembelian dalam aplikasi
SUBSCRIPTION Langganan
APP Aplikasi berbayar

SignedData

Representasi JSON
{
  "inAppPurchaseData": {
    object
  },
  "inAppDataSignature": string
}
Kolom
inAppPurchaseData

object (Struct format)

Berisi semua data pembelian dalam aplikasi dalam format JSON. Lihat detail pada tabel 6 tentang https://developer.android.com/google/play/billing/billing_reference.html.

inAppDataSignature

string

Mencocokkan IN_APP_DATA_SIGNATURE dari metode getPurchases() di Play InApp Billing API.

Izin

Nilai yang mungkin untuk izin.

Enum
PERMISSION_UNSPECIFIED Izin tidak ditentukan.
DEVICE_PRECISE_LOCATION Tanyakan lokasi akurat, lintang/bujur, dan alamat yang diformat.
DEVICE_COARSE_LOCATION Tanyakan perkiraan lokasi, kode pos, kota, dan kode negara pengguna.
UPDATE Minta izin untuk mengirim info terbaru. Lihat https://developers.google.com/assistant/engagement/daily.

Beranda

Menggambarkan struktur HomeGraph yang memiliki perangkat target pengguna.

Representasi JSON
{
  "params": {
    string: value,
    ...
  }
}
Kolom
params

map (key: string, value: value (Value format))

Opsional. Daftar parameter yang terkait dengan struktur HomeGraph yang memiliki perangkat target. Lihat dokumentasi penyimpanan rumah: https://developers.google.com/assistant/conversational/storage-home.

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

Perangkat

Menunjukkan perangkat yang digunakan pengguna untuk membuat permintaan ke Action.

Representasi JSON
{
  "capabilities": [
    enum (Capability)
  ],
  "currentLocation": {
    object (Location)
  },
  "timeZone": {
    object (TimeZone)
  }
}
Kolom
capabilities[]

enum (Capability)

Wajib diisi. kemampuan perangkat yang membuat permintaan ke Action.

currentLocation

object (Location)

Opsional. Lokasi perangkat pengguna. Perhatikan, kolom ini hanya diisi setelah izin akses lokasi diberikan oleh pengguna akhir. Lihat pesan lokasi untuk detail selengkapnya tentang kolom yang ditetapkan bergantung pada izin umum vs. terperinci. Lihat dokumentasi izin: https://developers.google.com/assistant/conversational/permissions.

timeZone

object (TimeZone)

Opsional. Zona waktu yang terkait dengan perangkat klien. Ini dapat digunakan untuk me-resolve nilai datetime.

Kemampuan

Kemampuan yang didukung platform perangkat pada saat permintaan.

Enum
UNSPECIFIED Kemampuan perangkat tidak ditentukan.
SPEECH Perangkat dapat berbicara dengan pengguna melalui text-to-speech atau SSML.
RICH_RESPONSE Perangkat dapat menampilkan respons lengkap seperti kartu, daftar, dan tabel.
LONG_FORM_AUDIO Perangkat dapat memutar media audio berdurasi panjang seperti musik dan podcast.
INTERACTIVE_CANVAS Perangkat dapat menampilkan respons kanvas interaktif.
HOME_STORAGE Perangkat dapat mendukung penyimpanan dan pengambilan penyimpanan rumah.

Lokasi

Penampung yang mewakili lokasi.

Representasi JSON
{
  "coordinates": {
    object (LatLng)
  },
  "postalAddress": {
    object (PostalAddress)
  }
}
Kolom
coordinates

object (LatLng)

Koordinat geografis. Memerlukan izin [DEVICE_PRECISE_LOCATION].

postalAddress

object (PostalAddress)

Alamat pos. Memerlukan izin [DEVICE_PRECISE_LOCATION] atau [DEVICE_COARSE_LOCATION]. Jika izin akses lokasi sementara diberikan, hanya 'postalCode' dan 'lokalitas' kolom diharapkan sudah terisi. Izin akses lokasi akurat akan mengisi kolom tambahan seperti 'AdministrativeArea' dan 'addressLines'.

TimeZone

Merepresentasikan zona waktu dari Database Zona Waktu IANA.

Representasi JSON
{
  "id": string,
  "version": string
}
Kolom
id

string

Zona waktu Database Zona Waktu IANA, mis. "Amerika/New_York".

version

string

Opsional. Nomor versi Database Zona Waktu IANA, mis. "2019a".

Konteks

Berisi informasi konteks saat pengguna membuat kueri. Konteks tersebut termasuk tetapi tidak terbatas pada info tentang sesi media aktif, status aplikasi web Canvas, dll.

Representasi JSON
{
  "media": {
    object (MediaContext)
  },
  "canvas": {
    object (CanvasContext)
  }
}
Kolom
media

object (MediaContext)

Berisi informasi konteks tentang sesi media yang aktif saat ini.

canvas

object (CanvasContext)

Berisi informasi konteks tentang kanvas saat ini.

MediaContext

Berisi informasi konteks tentang sesi media yang aktif saat ini.

Representasi JSON
{
  "progress": string,
  "index": integer
}
Kolom
progress

string (Duration format)

Progres media dari file media yang aktif saat ini.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

index

integer

indeks berbasis 0 untuk file media yang aktif saat ini dalam daftar file media dalam respons media.

CanvasContext

Berisi informasi konteks tentang kanvas saat ini.

Representasi JSON
{
  "state": value
}
Kolom
state

value (Value format)

Opsional. Status yang ditetapkan oleh aplikasi 3P Interactive Canvas. Ini hanya ditetapkan untuk permintaan, bukan untuk respons. Misalnya, jika ini adalah aplikasi resep, statusnya dapat berupa nilai struct : { "current_page" : 5, "last_page" : 3, } Batas ukurannya adalah 50KB.

Diperkirakan

Menjelaskan ekspektasi untuk putaran dialog berikutnya.

Representasi JSON
{
  "speech": [
    string
  ]
}
Kolom
speech[]

string

Daftar frasa yang diharapkan Tindakan dari ucapan pengguna untuk pembiasan ucapan. Hingga 1.000 frasa diizinkan. Catatan: Kolom ini memiliki arti yang sama dengan ExpectedInput.speech_biasing_hints di API v2.