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 untuk fulfillment tentang cara menangani permintaan. Misalnya, permintaan yang bermaksud untuk mendapatkan fakta mungkin memiliki pengendali dengan nama "getFact".
intent

object (Intent)

Wajib. Mewakili intent terakhir yang 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 dibuat dalam cakupan scene. 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 terkait struktur HomeGraph yang dimiliki perangkat target. Lihat https://developers.google.com/actions/smarthome/concepts/homegraph.
device

object (Device)

Wajib. Info pada perangkat yang digunakan pengguna untuk berinteraksi dengan Action.
context

object (Context)

Opsional. Informasi tentang konteks permintaan saat ini. Termasuk, tetapi tidak terbatas pada, info sesi media atau info kanvas yang 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. Mewakili prompt yang akan dikirim ke pengguna, prompt ini akan ditambahkan ke pesan yang ditambahkan sebelumnya kecuali jika ditimpa secara eksplisit.
scene

object (Scene)

Opsional. Mewakili adegan saat ini dan berikutnya. Jika Scene.next ditetapkan, runtime akan segera ditransisikan 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 dimiliki 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 giliran dialog berikutnya.

Handler

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

Representasi JSON 
{
  "name": string
}
Kolom
name

string

Opsional. Nama pengendali.

Intent

Menampilkan 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 ke nilai parameter yang diidentifikasi dari input pengguna. Semua parameter yang ditentukan dalam intent yang cocok dan diidentifikasi akan muncul di sini.

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

string

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

IntentParameterValue

Mewakili 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. Ini hanya akan diisi jika parameter ditentukan dalam intent yang cocok dan nilai parameter dapat diidentifikasi selama pencocokan intent.

Suasana

Merepresentasikan scene. Scene dapat memanggil fulfillment, menambahkan perintah, dan mengumpulkan nilai slot dari pengguna. Scene dipicu oleh peristiwa atau intent dan dapat memicu peristiwa serta intent yang cocok untuk bertransisi 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

Menyatakan 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

Merepresentasikan 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. Permintaan ini dikirim ke pengguna saat diperlukan untuk mengisi slot yang diperlukan. Prompt ini akan menggantikan prompt yang ada yang ditentukan dalam console. Kolom ini tidak disertakan dalam permintaan webhook.

SlotMode

Mewakili mode slot, yaitu, apakah diperlukan atau tidak.

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

SlotStatus

Mewakili 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.

Prompt

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 penggabungan pesan ini dengan pesan yang telah ditentukan sebelumnya. "true" menghapus semua pesan yang ditentukan sebelumnya (pertama dan terakhir, konten, link saran, dan kanvas) serta menambahkan pesan yang ditentukan dalam perintah ini. "false" menambahkan pesan yang ditentukan dalam permintaan ini ke pesan yang ditentukan dalam respons sebelumnya. Membiarkan kolom ini ke "false" juga memungkinkan penambahan ke beberapa kolom di dalam prompt Sederhana, prompt Saran, dan perintah Canvas (bagian dari perintah Konten). Pesan Content dan Link selalu ditimpa jika ditentukan dalam perintah. Nilai defaultnya adalah "false".
firstSimple

object (Simple)

Opsional. Respons pertama yang hanya berisi teks dan suara.
content

object (Content)

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

object (Simple)

Opsional. Respons terakhir yang hanya berupa teks dan suara.
suggestions[]

object (Suggestion)

Opsional. Saran yang akan ditampilkan kepada pengguna yang akan selalu muncul di akhir respons. Jika kolom "ganti" di perintah yang memuatnya adalah "false", judul yang ditentukan di kolom ini akan ditambahkan ke judul yang ditentukan di perintah saran yang ditentukan sebelumnya dan nilai duplikat akan dihapus.
canvas

object (Canvas)

Opsional. Mewakili respons Canvas Interaktif untuk dikirim ke pengguna.
orderUpdate

object (OrderUpdate)

Action Opsional merespons dengan OrderUpdate setelah menerima pesanan selama alur transaksi. Setelah menerima email ini, Google akan mencatat pembaruan pesanan tersebut, dan jika berhasil, akan menampilkan kartu tanda terima beserta TTS yang dikirim di perangkat tampilan.

Simple

Menampilkan perintah 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. Merepresentasikan ucapan yang akan diucapkan kepada pengguna. Dapat berupa SSML atau text to speech. Jika kolom "ganti" di perintah yang memuatnya adalah "true", ucapan yang ditentukan dalam kolom ini akan menggantikan ucapan perintah Sederhana sebelumnya. Lihat https://developers.google.com/assistant/conversational/ssml.
text

string

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

Konten

Objek container untuk dialog multimedia atau perintah 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 berikut:
card

object (Card)

Kartu dasar.
image

object (Image)

Gambar.
table

object (Table)

Kartu tabel.
media

object (Media)

Respons yang menunjukkan sekumpulan media yang akan diputar.
collection

object (Collection)

Kartu yang menampilkan kumpulan opsi untuk dipilih.
list

object (List)

Kartu yang menampilkan daftar opsi untuk 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

Judul kartu secara keseluruhan. Opsional.
subtitle

string

Opsional.
text

string

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

object (Image)

Banner besar untuk kartu. Tingginya ditetapkan ke 192 dp. Opsional.
imageFill

enum (ImageFill)

Cara mengisi latar belakang gambar. 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 pembaca layar. Wajib.
height

integer

Tinggi gambar dalam piksel. Opsional.
width

integer

Lebar gambar dalam piksel. Opsional.

ImageFill

Kemungkinan opsi tampilan gambar untuk memengaruhi penyajian gambar. Ini harus digunakan saat rasio aspek gambar tidak cocok dengan rasio aspek penampung gambar.

Enum
UNSPECIFIED
GRAY Isi celah antara gambar dan penampung gambar dengan batang abu-abu.
WHITE Isi celah antara gambar dan penampung gambar dengan batang putih.
CROPPED Gambar diskalakan sedemikian rupa sehingga lebar dan tinggi gambar sesuai atau melebihi dimensi penampung. 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 4:3.

OpenUrl

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

string

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

enum (UrlHint)

Menunjukkan petunjuk untuk jenis URL.

UrlHint

Berbagai jenis petunjuk URL.

Enum
AMP URL yang mengarah langsung ke konten AMP, atau ke 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 secara keseluruhan. Opsional, tetapi harus disetel jika subtitel telah 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 dalam tabel. 3 baris pertama dijamin akan ditampilkan, tetapi baris lainnya mungkin terpotong pada permukaan tertentu. Uji dengan simulator untuk melihat baris mana yang akan ditampilkan untuk platform tertentu. Pada platform yang mendukung kemampuan WEB_BROWSER, Anda dapat mengarahkan pengguna ke laman 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 konten. Jika tidak ditentukan, konten akan disejajarkan dengan tepi depan.

HorizontalAlignment

Perataan konten dalam sel.

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

TableRow

Menjelaskan baris dalam tabel.

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

object (TableCell)

Sel dalam baris ini. 3 sel pertama dijamin akan ditampilkan, tetapi sel lainnya mungkin terpotong pada permukaan tertentu. Uji dengan simulator untuk melihat sel mana yang akan ditampilkan untuk permukaan tertentu.
divider

boolean

Menunjukkan apakah harus ada pemisah setelah setiap baris.

TableCell

Menjelaskan sel secara berurutan.

Representasi JSON 
{
  "text": string
}
Kolom
text

string

Konten teks di 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 ditetapkan, permintaan akan dibuat ke pihak ketiga saat peristiwa media tertentu terjadi. Jika tidak disetel, 3p masih harus menangani dua jenis kontrol default, FINISHED dan FAILED.
mediaObjects[]

object (MediaObject)

Daftar Objek Media
repeatMode

enum (RepeatMode)

Mode berulang 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 pada objek media pertama di mediaObjects.

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 Acara yang 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 berikut:
large

object (Image)

Gambar 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 berulang untuk daftar objek media.

Enum
REPEAT_MODE_UNSPECIFIED Setara dengan NONAKTIF.
OFF Mengakhiri sesi media di akhir objek media terakhir.
ALL Melakukan loop ke awal objek media pertama saat akhir objek media terakhir tercapai.

Collection

Kartu untuk menampilkan 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 ini dapat memiliki minimal 2 dan maksimal 10.
imageFill

enum (ImageFill)

Cara mengisi latar belakang gambar item koleksi. Opsional.

CollectionItem

Item dalam koleksi

Representasi JSON 
{
  "key": string
}
Kolom
key

string

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

Daftar

Kartu untuk menampilkan 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 ini dapat memiliki minimal 2 dan maksimal 30.

ListItem

Item dalam daftar

Representasi JSON 
{
  "key": string
}
Kolom
key

string

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

CollectionBrowse

Menampilkan kumpulan dokumen web sebagai koleksi item kartu berukuran besar. Item dapat dipilih untuk meluncurkan dokumen web yang 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 ini dapat memiliki minimal 2 dan maksimal 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, yang 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 memberi pengguna chip saran di perangkat yang mendukung tampilan saat Asisten menampilkan perintah. Gunakan chip saran untuk mengisyaratkan respons pengguna guna melanjutkan atau mengubah 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 di 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. Maks 25 karakter

Canvas

Mewakili respons Canvas Interaktif untuk dikirim ke pengguna. Ini dapat digunakan bersama dengan kolom "firstSimple" di perintah yang berisi untuk berbicara dengan pengguna selain menampilkan respons kanvas interaktif. Ukuran maksimum respons 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 aktif saat ini akan digunakan kembali.
data[]

value (Value format)

Opsional. Data JSON yang akan diteruskan ke halaman web pengalaman imersif sebagai peristiwa. Jika kolom "override" di perintah yang memuatnya adalah nilai data "salah" yang ditentukan dalam perintah Canvas ini akan ditambahkan setelah nilai data yang 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 membuat mode pencocokan berkelanjutan tetap aktif. Jika ditentukan, mikrofon akan ditutup ketika waktunya habis. Nilai maksimum yang diizinkan adalah 180.

ExpectedPhrase

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

string

Frasa yang akan dicocokkan selama sesi mode pencocokan berkelanjutan.
alternativePhrases[]

string

Beberapa frasa mungkin salah dikenali oleh model ucapan bahkan dengan pembiasan ucapan. Hal ini memungkinkan developer menentukan pemicu alternatif untuk homofon.

OrderUpdate

Memperbarui 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 tipe = SNAPSHOT, OrderUpdate.order harus merupakan seluruh pesanan. Jika jenis = ORDER_STATUS, ini adalah perubahan status tingkat pesanan. Hanya order.last_update_time dan status vertikal ini diambil. Catatan: type.ORDER_STATUS hanya mendukung pembaruan status PurcahaseOrderExtension dan tidak ada rencana untuk memperpanjang dukungan ini. Sebagai gantinya, sebaiknya gunakan updateMask karena lebih generik, 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 update. 2. order.create_time, order.google_order_id, dan order.merchant_order_id akan diabaikan jika disediakan sebagai bagian dari updateMask.

Ini adalah daftar yang dipisahkan koma yang berisi nama-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 menetapkan ini secara eksplisit.
ORDER_STATUS Hanya perbarui status pesanan.
SNAPSHOT Perbarui snapshot 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 level harus berjumlah kurang dari 50 kecuali jika ditentukan lain. 3. Semua stempel waktu di semua level, jika ditentukan, harus berupa stempel waktu yang valid.

Representasi JSON 
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

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

string

ID pesanan yang ditetapkan Google.
merchantOrderId

string

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

string

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

string

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

object (UserInfo)

Info tentang pembeli.
image

object (Image)

Gambar yang terkait dengan pesanan.
createTime

string (Timestamp format)

Wajib: Tanggal dan waktu pesanan dibuat.

Stempel waktu dalam format RFC3339 UTC "Zulu", 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. Diperlukan untuk OrderUpdate.

Stempel waktu dalam format 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 checkout. Ini dapat berbeda dari penyedia tingkat item baris. Contoh: Pesanan Expedia dengan item baris dari ANA.
contents

object (Contents)

Wajib: Pesan konten yang merupakan kelompok item baris.
priceAttributes[]

object (PriceAttribute)

Harga, diskon, pajak, dan sebagainya.
followUpActions[]

object (Action)

Tindak lanjuti tindakan di tingkat pesanan.
paymentData

object (PaymentData)

Data terkait pembayaran untuk pesanan.
termsOfServiceUrl

string

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

string

Catatan dilampirkan ke pesanan.
promotions[]

object (Promotion)

Semua promosi yang terkait dengan pesanan ini.
disclosures[]

object (Disclosure)

Pengungkapan yang terkait dengan pesanan ini.
vertical
(deprecated)

object

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

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.
Kolom union verticals. Properti ini akan diterapkan ke semua item baris, kecuali jika diganti di beberapa item baris. Vertical ini harus cocok dengan jenis vertical tingkat item baris. verticals hanya ada berupa salah satu diantara berikut:
purchase

object (PurchaseOrderExtension)

Pesanan pembelian (PO)
ticket

object (TicketOrderExtension)

Pesanan tiket

UserInfo

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

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

string

Email pengguna, Mis: janedoe@gmail.com.
firstName

string

Nama depan pengguna.
lastName

string

Nama belakang pengguna.
displayName

string

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

object (PhoneNumber)

Nomor telepon pengguna.

PhoneNumber

Representasi nomor telepon standar.

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

string

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

string

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

string

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

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

Gambar

Gambar yang ditampilkan di kartu.

Representasi JSON 
{
  "url": string,
  "accessibilityText": string,
  "height": 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 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 izin [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].
formattedAddress

string

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

string

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

string

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

object (PostalAddress)

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

string

Nama tempat.
phoneNumber

string

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

string

Catatan tentang lokasi.
placeId

string

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

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double untuk mewakili derajat lintang dan derajat bujur. Kecuali 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

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

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

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

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

Representasi JSON 
{
  "revision": 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. Ini tidak pernah disimpulkan dan terserah pengguna untuk memastikan nilainya benar. Lihat http://cldr.unicode.org/ dan http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk mengetahui detailnya. Contoh: "CH" untuk Swiss.
languageCode

string

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

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

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

string

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

string

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

string

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

string

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

string

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

string

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

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

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

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

string

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

string

Opsional. Nama organisasi di alamat.

Daftar Isi

Wrapper untuk item baris.

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

object (LineItem)

Daftar item baris pesanan. Setidaknya 1 lineItem diperlukan dan maksimum 50 baris yang diizinkan. Semua item baris harus berasal dari vertical yang sama.

LineItem

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

Representasi JSON 
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}
Kolom
id

string

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

string

Nama item baris seperti yang ditampilkan di tanda terima. Panjang maksimum yang diizinkan adalah 100 karakter.
userVisibleStateLabel
(deprecated)

string

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

object (Merchant)

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

object (PriceAttribute)

Harga dan penyesuaian tingkat item baris.
followUpActions[]

object (Action)

Tindakan lanjutan pada item baris.
recipients[]

object (UserInfo)

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

object (Image)

Gambar kecil yang terkait dengan item ini, jika ada.
description

string

Deskripsi item baris.
notes[]

string

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

object (Disclosure)

Pengungkapan yang terkait dengan item baris ini.
vertical
(deprecated)

object

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

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.
Kolom union verticals. Wajib: Konten Semantik item baris berdasarkan jenis/vertikalnya. Setiap vertical harus menyertakan detail fulfillment-nya sendiri. verticals hanya ada berupa salah satu diantara berikut:
purchase

object (PurchaseItemExtension)

Membeli pesanan seperti barang, makanan, dll.
reservation

object (ReservationItemExtension)

Pesanan reservasi seperti restoran, potong rambut, dll.

PriceAttribute

Atribut harga pesanan atau item baris.

Representasi JSON 
{
  "type": enum (Type),
  "name": string,
  "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: Atribut jenis uang.
name

string

Wajib: Pengguna menampilkan string atribut harga. Pesan 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 mili. spec hanya ada berupa salah satu diantara berikut:
amount

object (Money)

Jumlah uang.
amountMillipercentage
(deprecated)

integer

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

Jenis

Merepresentasikan jenis uang.

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

Negara Bagian

Merepresentasikan status harga.

Enum
STATE_UNSPECIFIED Tidak ditentukan.
ESTIMATE Harga hanyalah perkiraan, tetapi jumlah akhirnya akan mendekati jumlah ini. Contoh: Jika pajak tidak diketahui secara akurat pada saat transaksi, totalnya adalah jumlah EST.
ACTUAL Harga sebenarnya yang akan ditagihkan kepada pengguna.

Uang

Menyatakan jumlah uang dengan jenis mata uangnya.

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

string

Kode mata uang 3 huruf yang ditentukan dalam ISO 4217.
amountInMicros

string (int64 format)

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

Tindakan

Tindakan lanjutan yang terkait dengan pesanan atau item baris.

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

enum (Type)

Wajib: Jenis tindakan.
title

string

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

object (OpenUrlAction)

Tindakan yang harus diambil.
actionMetadata

object (ActionMetadata)

Metadata yang terkait dengan tindakan.

Jenis

Kemungkinan tindakan lanjutan.

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

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

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

OpenUrlAction

Membuka URL tertentu.

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

string

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

object (AndroidApp)

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

enum (UrlTypeHint)

Menunjukkan petunjuk untuk jenis URL.

AndroidApp

Spesifikasi Aplikasi Android untuk batasan fulfillment

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

string

Nama paket Nama paket harus ditentukan saat menentukan Android Fulfillment.
versions[]

object (VersionFilter)

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

VersionFilter

VersionFilter harus disertakan jika versi aplikasi tertentu diperlukan.

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

integer

Kode versi min atau 0, inklusif.
maxVersion

integer

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

UrlTypeHint

Berbagai jenis petunjuk URL.

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

ActionMetadata

Metadata Terkait per tindakan.

Representasi JSON 
{
  "expireTime": string
}
Kolom
expireTime

string (Timestamp format)

Waktu saat tindakan ini akan berakhir.

Stempel waktu dalam format RFC3339 UTC "Zulu", 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 keselamatan".
disclosureText

object (DisclosureText)

Konten pengungkapan. Link web diizinkan.
presentationOptions

object (DisclosurePresentationOptions)

Opsi presentasi untuk pengungkapan.

DisclosureText

Menampilkan teks biasa dengan link web.

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

string

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

DisclosurePresentationOptions

Opsi untuk penyajian pengungkapan.

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

enum (PresentationRequirement)

Persyaratan penyajian pengungkapan.
initiallyExpanded

boolean

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

PresentationRequirement

Persyaratan untuk menampilkan pengungkapan.

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

PurchaseItemExtension

Konten item baris Vertikal Pembelian.

Representasi JSON 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": 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 maksimal yang diizinkan adalah 50 karakter.
type

enum (PurchaseType)

Wajib: Jenis pembelian.
productId
(deprecated)

string

ID produk atau penawaran yang terkait dengan item baris ini.
quantity

integer

Jumlah item.
unitMeasure

object (MerchantUnitMeasure)

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

object (PurchaseReturnsInfo)

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

object (PurchaseFulfillmentInfo)

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

object (ItemOption)

Add-on atau sub-item tambahan.
productDetails

object (ProductDetails)

Detail tentang produk.
extension
(deprecated)

object

Kolom tambahan apa pun yang dipertukarkan antara penjual dan Google. Catatan: Penggunaan ekstensi ini sangat tidak disarankan. Berdasarkan kasus penggunaan/situasi, pertimbangkan salah satu hal berikut: 1. Menentukan kolom di PurchaseItemExtension jika dapat digunakan untuk kasus penggunaan lainnya (yaitu kemampuan/fungsi umum). 2. Gunakan vertical_extension jika khusus untuk kasus penggunaan/fitur khusus 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 Telah dikirim.
DELIVERED Diterima.
OUT_OF_STOCK Stok habis.
IN_PREPARATION "IN_PREPARATION" dapat memiliki arti yang berbeda dalam konteks yang berbeda. Untuk pesanan MAKANAN, bisa jadi makanan sedang disiapkan. Untuk Retail, bisa jadi item sedang dikemas.
CREATED Pesanan dibuat.
CONFIRMED Penjual mengonfirmasi pesanan.
REJECTED Penjual menolak pesanan atau item baris.
RETURNED Item dikembalikan oleh pengguna.
CANCELLED Pesanan atau item baris dibatalkan oleh pengguna.
CHANGE_REQUESTED Pengguna telah meminta perubahan atas pesanan, dan integrator sedang memproses perubahan ini. Pesanan harus dipindahkan ke status lain setelah permintaan ditangani.

PurchaseType

Kategori pembelian.

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

MerchantUnitMeasure

Ukuran unit produk penjual.

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

number

Nilai: Contoh 1.2.
unit

enum (Unit)

Unit: Contoh POUND, GRAM.

Satuan

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

PurchaseReturnsInfo

Menampilkan info yang terkait dengan pesanan atau item baris tertentu.

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

boolean

Jika true (benar), pengembalian diizinkan.
daysToReturn

integer

Pengembalian diizinkan dalam jangka waktu tersebut.
policyUrl

string

Link ke kebijakan pengembalian.

PurchaseFulfillmentInfo

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

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

string

ID unik untuk opsi layanan ini.
fulfillmentType

enum (Type)

Wajib: Jenis fulfillment.
expectedFulfillmentTime

object (Time)

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

object (Time)

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

object (Location)

Lokasi pengambilan atau pengiriman.
expireTime

string (Timestamp format)

Waktu saat opsi pemenuhan pesanan ini berakhir.

Stempel waktu dalam format RFC3339 UTC "Zulu", 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 oleh pengguna.
storeCode

string

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

object (PickupInfo)

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

Jenis

Jenis pemenuhan.

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

Waktu

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

Representasi JSON 
{
  "timeIso8601": string
}
Kolom
timeIso8601

string

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

PickupInfo

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

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

enum (PickupType)

Metode pengambilan, seperti INSTORE, CURBSIDE, dll.
curbsideInfo

object (CurbsideInfo)

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

object (CheckInInfo)

Daftar berbagai metode yang didukung partner untuk mendukung check in.

PickupType

Daftar jenis pengambilan yang didukung.

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

CurbsideInfo

Detail tentang cara memfasilitasi pesanan di tepi jalan.

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

enum (CurbsideFulfillmentType)

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

object (Vehicle)

Detail kendaraan pengguna yang melakukan pemesanan.

CurbsideFulfillmentType

Nilai yang mungkin untuk jenis pemenuhan tepi jalan.

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

Kendaraan

Detail tentang kendaraan

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

string

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

string

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

string

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

string

Nama warna kendaraan, misalnya hitam Opsional.
image

object (Image)

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

CheckInInfo

Metadata yang diperlukan partner untuk mendukung metode check in.

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

enum (CheckInType)

Metode yang digunakan untuk mengirim petunjuk check in.

CheckInType

Berbagai metode yang digunakan untuk mengirim petunjuk check in.

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

ItemOption

Mewakili add-on atau sub-item.

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

string

Untuk opsi yang berupa item, ID item unik.
name

string

Nama opsi.
prices[]

object (PriceAttribute)

Total harga opsi.
note

string

Catatan terkait dengan opsi.
quantity

integer

Untuk opsi yang berupa item, jumlah.
productId

string

ID produk atau penawaran yang terkait dengan opsi ini.
subOptions[]

object (ItemOption)

Untuk menentukan subopsi bertingkat lainnya.

ProductDetails

Detail tentang produk.

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

string

ID produk atau penawaran yang terkait dengan item baris ini.
gtin

string

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

string

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

string

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

map (key: string, value: string)

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

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

ReservationItemExtension

Konten item baris untuk pesanan reservasi seperti restoran, potong rambut, dll.

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 maksimal yang diizinkan adalah 50 karakter.
type

enum (ReservationType)

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

object (Time)

Waktu saat layanan/peristiwa dijadwalkan untuk terjadi. Dapat berupa rentang waktu, tanggal, atau waktu tanggal yang tepat.
userAcceptableTimeRange

object (Time)

Rentang waktu yang dapat diterima pengguna.
confirmationCode

string

Kode konfirmasi untuk reservasi ini.
partySize

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 ditentukan.
PENDING Reservasi tertunda.
CONFIRMED Reservasi telah dikonfirmasi.
CANCELLED Reservasi dibatalkan oleh pengguna.
FULFILLED Reservasi telah terpenuhi.
CHANGE_REQUESTED Perubahan reservasi diminta
REJECTED Reservasi sudah tidak berlaku atau ditolak oleh integrator.

ReservationType

Jenis reservasi.

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

StaffFacilitator

Informasi tentang staf layanan.

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

string

Nama fasilitator staf. Mis., "John Smith"
image

object (Image)

Gambar pengisi acara.

PaymentData

Data pembayaran yang terkait dengan pesanan.

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

object (PaymentResult)

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

object (PaymentInfo)

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

PaymentResult

Hasil pembayaran yang digunakan oleh integrator untuk menyelesaikan transaksi.

Representasi JSON 
{

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

string

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

string

Metode pembayaran yang disediakan Penjual/Tindakan yang dipilih pengguna.

PaymentInfo

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

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

object (PaymentMethodDisplayInfo)

Info tampilan metode pembayaran yang digunakan untuk transaksi.
paymentMethodProvenance

enum (PaymentMethodProvenance)

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

PaymentMethodDisplayInfo

Hasil pembayaran yang digunakan oleh integrator untuk menyelesaikan transaksi.

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

enum (PaymentType)

Jenis pembayaran.
paymentMethodDisplayName

string

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

string

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

PaymentType

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

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

PaymentMethodProvenance

Merepresentasikan sumber Metode pembayaran yang digunakan untuk transaksi.

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

Promosi

Promosi/Penawaran yang ditambahkan ke keranjang.

Representasi JSON 
{
  "coupon": string
}
Kolom
coupon

string

Wajib: Kode kupon yang diterapkan untuk penawaran ini.

PurchaseOrderExtension

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

Representasi JSON 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "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 maksimal yang diizinkan adalah 50 karakter.
type

enum (PurchaseType)

Wajib: Jenis pembelian.
returnsInfo

object (PurchaseReturnsInfo)

Info pengembalian pesanan.
fulfillmentInfo

object (PurchaseFulfillmentInfo)

Info pemenuhan pesanan.
purchaseLocationType

enum (PurchaseLocationType)

Lokasi pembelian (di toko / online)
errors[]

object (PurchaseError)

Opsional: Terjadi error karena pesanan ini ditolak.
extension
(deprecated)

object

Kolom tambahan apa pun yang dipertukarkan antara penjual dan Google. Catatan: Penggunaan ekstensi ini sangat tidak disarankan. Berdasarkan kasus penggunaan/situasi, pertimbangkan salah satu hal berikut: 1. Menentukan kolom di PurchaseOrderExtension jika kolom tersebut dapat digunakan untuk kasus penggunaan lainnya (yaitu, kemampuan/fungsi umum). 2. Gunakan vertical_extension jika khusus untuk kasus penggunaan/fitur khusus 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 dapat menyebabkan pesanan pembelian ditolak.

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

enum (ErrorType)

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

string

Deskripsi error tambahan.
entityId

string

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

object (PriceAttribute)

Relevan dengan kasus jenis kesalahan PRICE_CHANGE / INCORRECT_PRICE.
availableQuantity

integer

Jumlah yang tersedia sekarang. Berlaku jika AVAILABILITY_ABILITY.

ErrorType

Jenis error yang mungkin terjadi.

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

TicketOrderExtension

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

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

object (TicketEvent)

Peristiwa ini berlaku untuk semua tiket item baris.

TicketEvent

Mewakili satu peristiwa.

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

enum (Type)

Wajib: Jenis acara tiket, misalnya film, konser.
name

string

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

string

Deskripsi acara.
url

string

URL ke info peristiwa.
location

object (Location)

Lokasi tempat acara berlangsung, atau organisasi berada.
eventCharacters[]

object (EventCharacter)

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

object (Time)

Waktu mulai.
endDate

object (Time)

Waktu berakhir.
doorTime

object (Time)

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

Jenis

Jenis peristiwa.

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

EventCharacter

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

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

enum (Type)

Jenis karakter acara, misalnya aktor atau sutradara.
name

string

Nama karakter.
image

object (Image)

Gambar karakter.

Jenis

Jenis karakter.

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

UserNotification

Notifikasi pengguna opsional yang akan ditampilkan sebagai bagian dari pembaruan Pesanan.

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

string

Judul untuk notifikasi pengguna. Panjang maksimal yang diizinkan adalah 30 karakter.
text

string

Isi notifikasi. Panjang maksimum yang diizinkan adalah 100 karakter.

NextScene

Mewakili adegan 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 dari 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. Jenis sesi yang ditentukan 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. Ini dapat berbeda dari lokalitas pengguna jika tindakan menggunakan fitur multibahasa. Misalnya, jika handler_response.expected.language_code ditetapkan, setelan ini akan mengubah bahasa percakapan untuk semua giliran berikutnya, yang akan tercermin dalam kolom ini.

TypeOverride

Mewakili penggantian untuk jenis.

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

string

Wajib. Nama jenis yang akan ditambah atau diganti.
mode

enum (TypeOverrideMode)

Wajib. Cara jenis ini 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

Mewakili 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 di kolom ini harus disertakan dalam kolom sinonim berulang agar dapat dikenali sebagai nilai jenis yang valid.
synonyms[]

string

Wajib. Daftar sinonim untuk entri (mis. "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, yang ditampilkan di bawah deskripsi. Satu baris teks, terpotong dengan elipsis.
openUrl

object (OpenUrl)

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

Pengguna

Merepresentasikan 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 dihilangkan jika pengguna belum pernah berinteraksi dengan agen sebelumnya.

Stempel waktu dalam format 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)

Interaksi pengguna saat ini termasuk langganan apa pun ke intent.
packageEntitlements[]

object (PackageEntitlements)

Hak pengguna terkait 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 Tidak 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 Tidak diketahui.
GUEST Pengguna tamu.
VERIFIED Pengguna terverifikasi.

Engagement

Memberikan informasi hanya-baca tambahan tentang mekanisme interaksi yang telah didaftarkan pengguna saat ini. Misalnya, dapat berguna untuk mengetahui intent yang telah menjadi langganan pengguna agar mereka tidak meminta mereka berlangganan ke intent yang sama lagi. Dengan kata lain, informasi ini dapat digunakan untuk merutekan kondisi ke scene secara kondisional untuk 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 push-nya telah diaktifkan pengguna.
dailyUpdateIntents[]

object (IntentSubscription)

Berisi daftar intent yang update hariannya telah diaktifkan 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. ID 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 baik: 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 ditentukan dalam paket tindakan.
entitlements[]

object (Entitlement)

Hak pengguna untuk paket tertentu.

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 API Penagihan InApp Play. Lihat dokumentasi Penagihan dalam Aplikasi Play: https://developer.android.com/google/play/billing.
skuType

enum (SkuType)

Jenis SKU.
inAppDetails

object (SignedData)

Hanya ada untuk pembelian dalam aplikasi dan pelanggan dalam aplikasi.

SkuType

Enum
SKU_TYPE_UNSPECIFIED
IN_APP Pembelian dalam aplikasi
SUBSCRIPTION Subscription
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 di 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 ditetapkan.
DEVICE_PRECISE_LOCATION Meminta lokasi akurat, lintang/bujur, dan alamat berformat pengguna.
DEVICE_COARSE_LOCATION Tanyakan lokasi umum, kode pos, kota, dan kode negara pengguna.
UPDATE Minta izin untuk mengirim update. Lihat https://developers.google.com/assistant/engagement/daily.

Beranda

Mewakili struktur HomeGraph yang dimiliki 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 tempat perangkat target berada. Lihat dokumentasi penyimpanan di 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

Menggambarkan perangkat yang digunakan pengguna untuk membuat permintaan ke Action.

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

enum (Capability)

Diperlukan. kemampuan perangkat 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 mengetahui detail selengkapnya tentang kolom mana yang ditetapkan, bergantung pada izin terperinci vs. izin terperinci. Lihat dokumentasi izin: https://developers.google.com/assistant/conversational/permissions.
timeZone

object (TimeZone)

Opsional. Zona waktu yang terkait dengan perangkat klien. 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 lokasi sementara diberikan, hanya kolom 'postalCode' dan 'lokalitas' yang diharapkan akan 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, misalnya "America/New_York".
version

string

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

Konteks

Berisi informasi konteks saat pengguna membuat kueri. Konteks tersebut mencakup, tetapi tidak terbatas pada, informasi tentang sesi media aktif, aplikasi web kanvas, 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 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 dari file media yang aktif saat ini dalam daftar file media di respons media.

CanvasContext

Berisi informasi konteks tentang kanvas saat ini.

Representasi JSON 
{
  "state": value
}
Kolom
state

value (Value format)

Opsional. Status ditetapkan oleh aplikasi 3P Interactive Canvas. Ini hanya disetel 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 50 KB.

Diperkirakan

Menjelaskan ekspektasi untuk giliran dialog berikutnya.

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

string

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