Files

Wrapper untuk daftar file.

Representasi JSON 
{

  // Union field file_type can be only one of the following:
  "configFiles": {
    object (ConfigFiles)
  },
  "dataFiles": {
    object (DataFiles)
  }
  // End of list of possible types for union field file_type.
}
Kolom
Kolom union file_type. Hanya satu jenis file yang dapat dikirim ke server dalam satu waktu, yaitu file konfigurasi atau file data. file_type hanya dapat berupa salah satu dari berikut:
configFiles

object (ConfigFiles)

Daftar file konfigurasi. Data ini mencakup manifes, setelan, paket resource model interaksi, dan lainnya.
dataFiles

object (DataFiles)

Daftar file data. Ini mencakup gambar, file audio, kode sumber cloud function.

ConfigFiles

Wrapper untuk file konfigurasi berulang. Kolom berulang tidak boleh ada di salah satu dari keduanya.

Representasi JSON 
{
  "configFiles": [
    {
      object (ConfigFile)
    }
  ]
}
Kolom
configFiles[]

object (ConfigFile)

Beberapa file konfigurasi.

ConfigFile

Mewakili satu file yang berisi data terstruktur. Developer dapat menentukan sebagian besar project mereka menggunakan konfigurasi terstruktur termasuk Actions, Settings, Fulfillment.

Representasi JSON 
{
  "filePath": string,

  // Union field file can be only one of the following:
  "manifest": {
    object (Manifest)
  },
  "actions": {
    object (Actions)
  },
  "settings": {
    object (Settings)
  },
  "webhook": {
    object (Webhook)
  },
  "intent": {
    object (Intent)
  },
  "type": {
    object (Type)
  },
  "entitySet": {
    object (EntitySet)
  },
  "globalIntentEvent": {
    object (GlobalIntentEvent)
  },
  "scene": {
    object (Scene)
  },
  "staticPrompt": {
    object (StaticPrompt)
  },
  "accountLinkingSecret": {
    object (AccountLinkingSecret)
  },
  "resourceBundle": {
    object
  }
  // End of list of possible types for union field file.
}
Kolom
filePath

string

Jalur relatif file konfigurasi dari root project dalam struktur file SDK. Setiap jenis file di bawah memiliki jalur file yang diizinkan. Misalnya: settings/settings.yaml
Kolom union file. Setiap jenis file konfigurasi harus memiliki bidang yang sesuai di salah satunya. file hanya dapat berupa salah satu dari berikut:
manifest

object (Manifest)

File manifes tunggal. Jalur file yang diizinkan: manifest.yaml
actions

object (Actions)

File tindakan tunggal dengan semua tindakan yang ditentukan. Jalur file yang diizinkan: actions/{language}?/actions.yaml
settings

object (Settings)

Konfigurasi setelan tunggal yang menyertakan setelan dan setelan yang tidak dapat dilokalkan untuk lokalitas default project (jika ditentukan). Untuk file pengganti lokalitas, hanya kolom dilokalkanSettings yang akan diisi. Jalur file yang diizinkan: settings/{language}?/settings.yaml Perhatikan bahwa file setelan yang tidak dilokalkan settings/settings.yaml harus ada dalam permintaan alur tulis.
webhook

object (Webhook)

Definisi webhook tunggal. Jalur file yang diizinkan: webhooks/{WebhookName}.yaml
intent

object (Intent)

Definisi intent tunggal. Jalur file yang diizinkan: custom/intents/{language}?/{IntentName}.yaml
type

object (Type)

Definisi jenis tunggal. Jalur file yang diizinkan: custom/types/{language}?/{TypeName}.yaml
entitySet

object (EntitySet)

Definisi kumpulan entitas tunggal. Jalur file yang diizinkan: custom/entitySets/{language}?/{EntitySetName}.yaml
globalIntentEvent

object (GlobalIntentEvent)

Definisi peristiwa intent global tunggal. Jalur file yang diizinkan: custom/global/{GlobalIntentEventName}.yaml Nama file (GlobalIntentEventName) harus berupa nama intent yang sesuai dengan peristiwa intent global ini.
scene

object (Scene)

Definisi satu suasana. Jalur file yang diizinkan: custom/scenes/{SceneName}.yaml
staticPrompt

object (StaticPrompt)

Definisi perintah statis tunggal. Jalur file yang diizinkan: custom/prompts/{language}?/{StaticPromptName}.yaml
accountLinkingSecret

object (AccountLinkingSecret)

Metadata yang sesuai dengan rahasia klien yang digunakan dalam penautan akun. Jalur file yang diizinkan: settings/accountLinkingSecret.yaml
resourceBundle

object (Struct format)

Paket resource tunggal, yang merupakan peta dari string ke string atau daftar string. Paket resource dapat digunakan untuk melokalkan string dalam perintah statis. Jalur file yang diizinkan: resources/strings/{language}?/{multiple directories}?/{BundleName}.yaml

Manifes

Berisi informasi yang "dapat diangkut" yaitu tidak spesifik untuk project tertentu dan dapat dipindahkan antar-project.

Representasi JSON 
{
  "version": string
}
Kolom
version

string

Versi format file. Versi format file saat ini adalah versi 1.0. Contoh: "1.0"

Tindakan

Mewakili daftar Tindakan yang ditentukan dalam sebuah project.

Representasi JSON 
{
  "custom": {
    string: {
      object (CustomAction)
    },
    ...
  }
}
Kolom
custom

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

Petakan dari intent ke Action kustom untuk mengonfigurasi pemanggilan untuk project. Intent pemanggilan dapat berupa intent sistem atau intent kustom yang ditentukan dalam atribut "custom/intents/" paket. Semua intent yang ditentukan di sini (intent sistem & intent kustom) harus memiliki file intent yang sesuai dalam kolom "custom/global/" paket.

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

CustomAction

Detail terkait tindakan kustom.

Representasi JSON 
{
  "engagement": {
    object (Engagement)
  }
}
Kolom
engagement

object (Engagement)

Mekanisme interaksi yang terkait dengan tindakan untuk membantu pengguna akhir berlangganan notifikasi push dan info terbaru harian. Perhatikan bahwa nama intent yang ditetapkan dalam konfigurasi slot notifikasi push/update harian harus cocok dengan intent yang berkaitan dengan tindakan ini agar pengguna akhir dapat berlangganan update ini.

Engagement

Menentukan mekanisme interaksi yang terkait dengan tindakan ini. Hal ini memungkinkan pengguna akhir berlangganan notifikasi push dan info terbaru harian.

Representasi JSON 
{
  "title": string,
  "pushNotification": {
    object (PushNotification)
  },
  "actionLink": {
    object (ActionLink)
  },
  "assistantLink": {
    object (AssistantLink)
  },
  "dailyUpdate": {
    object (DailyUpdate)
  }
}
Kolom
title

string

Judul interaksi yang akan dikirim ke pengguna akhir untuk meminta izin mereka untuk menerima info terbaru. Permintaan yang dikirim ke pengguna akhir untuk pembaruan harian akan terlihat seperti "Pukul berapa Anda ingin saya mengirimkan {title}" harian dan untuk notifikasi push akan terlihat seperti "Apakah boleh jika saya mengirim notifikasi push untuk {title}". Kolom ini dapat dilokalkan.
pushNotification

object (PushNotification)

Setelan notifikasi push yang didukung interaksi ini.
dailyUpdate

object (DailyUpdate)

Setelan update harian yang didukung engagement ini.

PushNotification

Menentukan setelan notifikasi push yang didukung interaksi ini.

DailyUpdate

Menentukan setelan update harian yang didukung interaksi ini.

Setelan

Mewakili setelan project Action yang tidak khusus lokalitas. Tag berikutnya: 22

Representasi JSON 
{
  "projectId": string,
  "defaultLocale": string,
  "enabledRegions": [
    string
  ],
  "disabledRegions": [
    string
  ],
  "category": enum (Category),
  "usesTransactionsApi": boolean,
  "usesDigitalPurchaseApi": boolean,
  "usesInteractiveCanvas": boolean,
  "usesHomeStorage": boolean,
  "designedForFamily": boolean,
  "containsAlcoholOrTobaccoContent": boolean,
  "keepsMicOpen": boolean,
  "surfaceRequirements": {
    object (SurfaceRequirements)
  },
  "testingInstructions": string,
  "localizedSettings": {
    object (LocalizedSettings)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "selectedAndroidApps": [
    string
  ]
}
Kolom
projectId

string

ID project Actions.
defaultLocale

string

Lokalitas yang merupakan default untuk project. Untuk semua file kecuali pada bagian resources/ tanpa lokalitas di jalurnya, data yang dilokalkan diatribusikan ke defaultLocale ini. Untuk file dalam resources/, tidak ada lokalitas yang berarti bahwa resource berlaku untuk semua lokalitas.
enabledRegions[]

string

Mewakili wilayah tempat pengguna dapat memanggil Action Anda, yang didasarkan pada lokasi kehadiran pengguna. Tidak dapat disetel jika disabledRegions disetel. Jika enabledRegions dan disabledRegions tidak ditentukan, pengguna dapat memanggil Action Anda di semua region. Setiap wilayah diwakili menggunakan Nama Kanonis target geografis AdWords. Lihat https://developers.google.com/adwords/api/docs/appendix/geotargeting Contohnya mencakup: - "Jerman" - "Ghana" - "Yunani" - "Grenada" - "Inggris Raya" - "Amerika Serikat" - "Kepulauan Terluar Kecil Amerika Serikat" - "Uruguay"
disabledRegions[]

string

Mewakili wilayah tempat Action Anda diblokir, berdasarkan lokasi kehadiran pengguna. Tidak dapat disetel jika enabledRegions disetel. Setiap wilayah diwakili menggunakan Nama Kanonis target geografis AdWords. Lihat https://developers.google.com/adwords/api/docs/appendix/geotargeting Contohnya mencakup: - "Jerman" - "Ghana" - "Yunani" - "Grenada" - "Inggris Raya" - "Amerika Serikat" - "Kepulauan Terluar Kecil Amerika Serikat" - "Uruguay"
category

enum (Category)

Kategori untuk project Action ini.
usesTransactionsApi

boolean

Apakah Action dapat menggunakan transaksi (misalnya, melakukan reservasi, menerima pesanan, dll.). Jika false, upaya untuk menggunakan Transactions API akan gagal.
usesDigitalPurchaseApi

boolean

Apakah Actions dapat melakukan transaksi untuk barang digital.
usesInteractiveCanvas

boolean

Apakah Actions menggunakan Canvas Interaktif.
usesHomeStorage

boolean

Apakah Action menggunakan fitur penyimpanan rumah.
designedForFamily

boolean

Apakah konten Action didesain untuk keluarga (DFF).
containsAlcoholOrTobaccoContent

boolean

Apakah Action berisi konten terkait alkohol atau tembakau.
keepsMicOpen

boolean

Apakah Action boleh membiarkan mikrofon aktif tanpa perintah eksplisit selama percakapan.
surfaceRequirements

object (SurfaceRequirements)

Persyaratan platform yang harus didukung platform klien untuk memanggil Action dalam project ini.
testingInstructions

string

Petunjuk pengujian bentuk bebas untuk Peninjau Action (misalnya, petunjuk penautan akun).
localizedSettings

object (LocalizedSettings)

Setelan yang dilokalkan untuk lokalitas default project. Setiap lokalitas tambahan harus memiliki file setelan sendiri di direktorinya sendiri.
accountLinking

object (AccountLinking)

Izinkan pengguna membuat atau menautkan akun melalui login dengan Google dan/atau layanan OAuth Anda sendiri.
selectedAndroidApps[]

string

Aplikasi Android yang dipilih untuk mengakses pembelian Google Play untuk transaksi. Ini adalah pilihan dari aplikasi Android yang terhubung ke project tindakan untuk memverifikasi kepemilikan merek dan mengaktifkan fitur tambahan. Lihat https://developers.google.com/assistant/console/brand-verification untuk mengetahui informasi selengkapnya.

Kategori

Pilihan kategori untuk project Action.

Enum
CATEGORY_UNSPECIFIED Tidak diketahui / Tidak ditentukan.
BUSINESS_AND_FINANCE Kategori Bisnis dan Keuangan.
EDUCATION_AND_REFERENCE Kategori Pendidikan dan Referensi.
FOOD_AND_DRINK Kategori Makanan dan Minuman.
GAMES_AND_TRIVIA Kategori game dan Trivia.
HEALTH_AND_FITNESS Kategori Kesehatan dan Kebugaran.
KIDS_AND_FAMILY Kategori Anak-Anak dan Keluarga.
LIFESTYLE Kategori gaya hidup.
LOCAL Kategori lokal.
MOVIES_AND_TV Kategori film dan TV.
MUSIC_AND_AUDIO Kategori Musik dan Audio.
NEWS Kategori berita,
NOVELTY_AND_HUMOR Kategori Baru dan Humor.
PRODUCTIVITY Kategori produktivitas.
SHOPPING Kategori belanja.
SOCIAL Kategori sosial.
SPORTS Kategori olahraga.
TRAVEL_AND_TRANSPORTATION Kategori Perjalanan dan Transportasi.
UTILITIES Kategori utilitas.
WEATHER Kategori cuaca.
HOME_CONTROL Kategori Kontrol Rumah.

SurfaceRequirements

Berisi kumpulan persyaratan yang harus didukung platform klien untuk memanggil Action dalam project Anda.

Representasi JSON 
{
  "minimumRequirements": [
    {
      object (CapabilityRequirement)
    }
  ]
}
Kolom
minimumRequirements[]

object (CapabilityRequirement)

Kumpulan kemampuan minimum yang diperlukan untuk memanggil Action dalam project Anda. Jika platform tidak memiliki salah satunya, Action tidak akan dipicu.

CapabilityRequirement

Menampilkan persyaratan tentang ketersediaan kemampuan tertentu.

Representasi JSON 
{
  "capability": enum (SurfaceCapability)
}
Kolom
capability

enum (SurfaceCapability)

Jenis kemampuan.

SurfaceCapability

Sekumpulan kemampuan permukaan yang mungkin.

Enum
SURFACE_CAPABILITY_UNSPECIFIED Tidak diketahui / Tidak ditentukan.
AUDIO_OUTPUT Platform mendukung output audio.
SCREEN_OUTPUT Permukaan mendukung output layar/visual.
MEDIA_RESPONSE_AUDIO Permukaan mendukung audio respons media.
WEB_BROWSER Surface mendukung browser web.
ACCOUNT_LINKING Platform mendukung penautan akun.
INTERACTIVE_CANVAS Platform mendukung Interactive Canvas.
HOME_STORAGE Permukaan mendukung penyimpanan rumah.

LocalizedSettings

Merepresentasikan setelan project Action yang spesifik untuk lokalitas pengguna. Dalam hal ini, pengguna berarti pengguna akhir yang memanggil Action Anda. Pesan ini dapat dilokalkan.

Representasi JSON 
{
  "displayName": string,
  "pronunciation": string,
  "shortDescription": string,
  "fullDescription": string,
  "smallLogoImage": string,
  "largeBannerImage": string,
  "developerName": string,
  "developerEmail": string,
  "termsOfServiceUrl": string,
  "voice": string,
  "voiceLocale": string,
  "privacyPolicyUrl": string,
  "sampleInvocations": [
    string
  ],
  "themeCustomization": {
    object (ThemeCustomization)
  }
}
Kolom
displayName

string

Wajib. Nama tampilan default untuk project Action ini (jika terjemahan tidak tersedia)
pronunciation

string

Wajib. Pengucapan nama tampilan untuk memanggilnya dalam konteks suara (lisan).
shortDescription

string

Wajib. Deskripsi singkat default untuk project Action (jika tidak ada terjemahan yang tersedia). Maksimal 80 karakter.
fullDescription

string

Wajib. Deskripsi panjang default untuk project Action (jika tidak ada terjemahan yang tersedia). Maksimal 4.000 karakter.
smallLogoImage

string

Wajib. Gambar persegi kecil, 192 x 192 piksel. Nilai ini harus ditentukan sebagai referensi untuk gambar yang sesuai di direktori resources/images/. Misalnya, $resources.images.foo (tanpa ekstensi) untuk gambar di resources/images/foo.jpg Saat mengerjakan project yang diambil dari Konsol, URL yang diambil dan dikelola Google dapat digunakan. URL dari sumber eksternal tidak diizinkan.
largeBannerImage

string

Opsional. Gambar lanskap besar, 1920 x 1080 piksel. Nilai ini harus ditentukan sebagai referensi untuk gambar yang sesuai di direktori resources/images/. Misalnya, $resources.images.foo (tanpa ekstensi) untuk gambar di resources/images/foo.jpg Saat mengerjakan project yang diambil dari Konsol, URL yang diambil dan dikelola Google dapat digunakan. URL dari sumber eksternal tidak diizinkan.
developerName

string

Wajib. Nama developer yang akan ditampilkan kepada pengguna.
developerEmail

string

Wajib. Alamat email kontak untuk developer.
termsOfServiceUrl

string

Opsional. URL persyaratan layanan.
voice

string

Wajib. Jenis suara Asisten Google yang didengar pengguna saat mereka berinteraksi dengan Action Anda. Nilai yang didukung adalah "male_1", "male_2", "perempuan_1", dan "perempuan_2".
voiceLocale

string

Opsional. Lokal untuk suara yang ditentukan. Jika tidak ditentukan, tindakan ini akan me-resolve ke lokalitas Asisten pengguna. Jika ditentukan, lokal suara harus memiliki bahasa root yang sama dengan lokalitas yang ditentukan dalam LocalizedSettings.
privacyPolicyUrl

string

Wajib. URL kebijakan privasi.
sampleInvocations[]

string

Opsional. Contoh frasa panggilan yang ditampilkan sebagai bagian dari deskripsi project Action Anda di direktori Asisten. Hal ini akan membantu pengguna mempelajari cara menggunakannya.
themeCustomization

object (ThemeCustomization)

Opsional. Penyesuaian tema untuk komponen visual Action Anda.

ThemeCustomization

Gaya yang diterapkan pada kartu yang ditampilkan kepada pengguna

Representasi JSON 
{
  "backgroundColor": string,
  "primaryColor": string,
  "fontFamily": string,
  "imageCornerStyle": enum (ImageCornerStyle),
  "landscapeBackgroundImage": string,
  "portraitBackgroundImage": string
}
Kolom
backgroundColor

string

Warna latar belakang kartu. Berfungsi sebagai penggantian jika background_image tidak disediakan oleh developer atau background_image tidak cocok untuk platform tertentu. Contoh penggunaan: #FAFAFA
primaryColor

string

Warna tema utama Action akan digunakan untuk menyetel warna teks judul, warna latar belakang item tindakan untuk kartu Actions on Google. Contoh penggunaan: #FAFAFA
fontFamily

string

Jenis font yang akan digunakan untuk judul kartu. Font yang didukung: - Sans Serif - Sans Serif Medium - Sans Serif Bold - Sans Serif Black - Sans Serif Condensed - Sans Serif Condensed Medium - Serif - Serif Bold - Monospace - Cursive - Sans Serif Smallcaps
imageCornerStyle

enum (ImageCornerStyle)

Gaya batas gambar latar depan kartu. Misalnya, dapat diterapkan pada gambar latar depan kartu dasar atau kartu carousel.
landscapeBackgroundImage

string

Mode lanskap (minimum 1920x1200 piksel). Nilai ini harus ditentukan sebagai referensi untuk gambar yang sesuai di direktori resources/images/. Misalnya: $resources.images.foo (tanpa ekstensi) untuk gambar di resources/images/foo.jpg Saat mengerjakan project yang diambil dari Konsol, URL yang dikelola Google yang diambil dapat digunakan.
portraitBackgroundImage

string

Mode potret (minimum 1200x1920 piksel). Nilai ini harus ditentukan sebagai referensi untuk gambar yang sesuai di direktori resources/images/. Misalnya: $resources.images.foo (tanpa ekstensi) untuk gambar di resources/images/foo.jpg Saat mengerjakan project yang diambil dari Konsol, URL yang dikelola Google yang diambil dapat digunakan.

ImageCornerStyle

Menjelaskan bagaimana batas gambar harus dirender.

Enum
IMAGE_CORNER_STYLE_UNSPECIFIED Tidak ditentukan / Tidak ditentukan.
CURVED Sudut membulat untuk gambar.
ANGLED Sudut persegi panjang untuk gambar.

AccountLinking

AccountLinking memungkinkan Google memandu pengguna untuk login ke layanan web Aplikasi.

Untuk jenis penautan Login dengan Google dan OAuth + Login dengan Google, Google membuat client ID yang mengidentifikasi Aplikasi Anda ke Google ("Client ID yang dikeluarkan oleh Google untuk Actions Anda" di UI Konsol). Kolom ini bersifat hanya baca dan dapat diperiksa dengan membuka halaman Penautan Akun di UI Konsol. Lihat: https://developers.google.com/assistant/identity/google-sign-in

Catatan: Untuk semua jenis setelan penautan akun (kecuali Login dengan Google), Anda harus memberikan nama pengguna dan sandi untuk akun pengujian di Settings.testing_instructions agar tim peninjau dapat meninjau aplikasi (tidak akan dapat dilihat oleh pengguna).

Representasi JSON 
{
  "enableAccountCreation": boolean,
  "linkingType": enum (LinkingType),
  "authGrantType": enum (AuthGrantType),
  "appClientId": string,
  "authorizationUrl": string,
  "tokenUrl": string,
  "scopes": [
    string
  ],
  "learnMoreUrl": string,
  "useBasicAuthHeader": boolean
}
Kolom
enableAccountCreation

boolean

Wajib. Jika true, pengguna diizinkan mendaftar untuk akun baru melalui suara. Jika false, pembuatan akun hanya diizinkan di situs Anda. Pilih opsi ini jika Anda ingin menampilkan persyaratan layanan atau mendapatkan izin pengguna saat mendaftar. linkingType tidak boleh berupa GOOGLE_SIGN_IN jika ini adalah false. linkingType tidak boleh OAUTH jika ini adalah true.
linkingType

enum (LinkingType)

Wajib. Jenis penautan yang akan digunakan. Lihat https://developers.google.com/assistant/identity untuk mengetahui detail selengkapnya tentang jenis penautan.
authGrantType

enum (AuthGrantType)

Opsional. Menunjukkan jenis autentikasi untuk OAUTH linkingType.
appClientId

string

Opsional. Client ID yang dikeluarkan oleh Aplikasi Anda ke Google. Ini adalah Client ID OAuth2 yang mengidentifikasi Google ke layanan Anda. Hanya disetel saat menggunakan OAuth.
authorizationUrl

string

Opsional. Endpoint untuk halaman web login Anda yang mendukung kode OAuth2 atau alur implisit. URL harus menggunakan HTTPS. Hanya disetel saat menggunakan OAuth.
tokenUrl

string

Opsional. Endpoint OAuth2 untuk pertukaran token. URL harus menggunakan HTTPS. Opsi ini tidak ditetapkan jika hanya menggunakan OAuth dengan pemberian IMPLICIT sebagai jenis penautan. Hanya disetel saat menggunakan OAuth.
scopes[]

string

Opsional. Daftar izin yang harus disetujui pengguna untuk menggunakan layanan Anda. Hanya disetel saat menggunakan OAuth. Pastikan untuk menyediakan Persyaratan Layanan dalam informasi direktori di bagian LocalizedSettings.terms_of_service_url jika menentukan kolom ini.
learnMoreUrl

string

Opsional. Ini adalah halaman web di layanan Anda yang menjelaskan izin yang diberikan pengguna kepada Google. Hanya tetapkan jika menggunakan OAuth dan Login dengan Google. Pastikan untuk menyediakan Persyaratan Layanan dalam informasi direktori di bagian LocalizedSettings.terms_of_service_url jika menentukan kolom ini.
useBasicAuthHeader

boolean

Opsional. Jika true (benar), izinkan Google untuk mengirimkan client ID dan secret klien melalui header autentikasi dasar HTTP. Jika tidak, Google akan menggunakan client ID dan secret di dalam isi postingan. Hanya disetel saat menggunakan OAuth. Pastikan untuk menyediakan Persyaratan Layanan dalam informasi direktori di bagian LocalizedSettings.terms_of_service_url jika menentukan kolom ini.

LinkingType

Jenis Penautan Akun yang akan dilakukan.

Enum
LINKING_TYPE_UNSPECIFIED Tidak ditentukan.
GOOGLE_SIGN_IN Jenis penautan Login dengan Google. Jika menggunakan jenis penautan ini, kolom terkait OAuth tidak perlu ditetapkan di bawah.
OAUTH_AND_GOOGLE_SIGN_IN Jenis penautan Login dengan Google dan OAuth.
OAUTH Jenis penautan OAuth.

AuthGrantType

Jenis pemberian izin OAuth2 yang digunakan Google untuk memandu pengguna login ke layanan web Aplikasi Anda.

Enum
AUTH_GRANT_TYPE_UNSPECIFIED Tidak ditentukan.
AUTH_CODE Pemberian kode otorisasi. Mengharuskan Anda memberikan URL autentikasi dan URL token akses.
IMPLICIT Pemberian kode implisit. Hanya mengharuskan Anda memberikan URL autentikasi.

Webhook

Metadata untuk berbagai jenis webhook. Jika Anda menggunakan inlineCloudFunction, kode sumber harus berada di direktori dengan nama yang sama dengan nilai untuk kunci executeFunction. Misalnya, nilai my_webhook untuk kunci executeFunction akan memiliki struktur kode seperti ini: - /webhooks/my_webhook.yaml - /webhooks/my_webhook/index.js - /webhooks/my_webhook/package.json

Representasi JSON 
{
  "handlers": [
    {
      object (Handler)
    }
  ],

  // Union field webhook_type can be only one of the following:
  "httpsEndpoint": {
    object (HttpsEndpoint)
  },
  "inlineCloudFunction": {
    object (InlineCloudFunction)
  }
  // End of list of possible types for union field webhook_type.
}
Kolom
handlers[]

object (Handler)

Daftar pengendali untuk webhook ini.
Kolom union webhook_type. Hanya satu jenis webhook yang didukung. webhook_type hanya dapat berupa salah satu dari berikut:
httpsEndpoint

object (HttpsEndpoint)

Endpoint HTTPS webhook kustom.
inlineCloudFunction

object (InlineCloudFunction)

Metadata untuk fungsi cloud yang di-deploy dari kode di folder webhook.

Handler

Mendeklarasikan nama pengendali webhoook. Webhook dapat memiliki beberapa pengendali yang terdaftar. Pengendali ini dapat dipanggil dari beberapa tempat di project Action Anda.

Representasi JSON 
{
  "name": string
}
Kolom
name

string

Wajib. Nama pengendali. Harus unik di semua pengendali project Actions. Anda dapat memeriksa nama pengendali ini untuk memanggil fungsi yang benar dalam kode sumber fulfillment Anda.

HttpsEndpoint

Endpoint REST untuk memberi tahu jika Anda tidak menggunakan editor inline.

Representasi JSON 
{
  "baseUrl": string,
  "httpHeaders": {
    string: string,
    ...
  },
  "endpointApiVersion": integer
}
Kolom
baseUrl

string

URL dasar HTTPS untuk endpoint fulfillment Anda (HTTP tidak didukung). Nama pengendali ditambahkan ke jalur URL dasar setelah tanda titik dua (dengan mengikuti panduan gaya di https://cloud.google.com/apis/design/custom_methods). Misalnya, URL dasar 'https://gactions.service.com/api' akan menerima permintaan dengan URL 'https://gactions.service.com/api:{method}'.
httpHeaders

map (key: string, value: string)

Peta parameter HTTP yang akan disertakan dalam permintaan POST.

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

integer

Versi protokol yang digunakan oleh endpoint. Ini adalah protokol yang digunakan bersama oleh semua jenis fulfillment dan tidak spesifik untuk jenis fulfillment Google.

InlineCloudFunction

Menyimpan metadata Cloud Function inline yang di-deploy dari folder webhook.

Representasi JSON 
{
  "executeFunction": string
}
Kolom
executeFunction

string

Nama titik entri Cloud Function. Nilai kolom ini harus cocok dengan nama metode yang diekspor dari kode sumber.

Intent

Intent memetakan input pengguna terbuka ke objek terstruktur. Frasa lisan dicocokkan dengan intent menggunakan Natural Language Understanding (NLU) Google. Pencocokan intent dapat memicu peristiwa dalam desain percakapan Anda untuk melanjutkan percakapan pengguna. Nama intent ditetapkan dalam nama file.

Representasi JSON 
{
  "parameters": [
    {
      object (IntentParameter)
    }
  ],
  "trainingPhrases": [
    string
  ]
}
Kolom
parameters[]

object (IntentParameter)

Daftar parameter dalam frasa pelatihan. Semua parameter harus ditentukan di sini agar dapat digunakan dalam frasa pelatihan.
trainingPhrases[]

string

Frasa pelatihan memungkinkan NLU Google mencocokkan intent dengan input pengguna secara otomatis. Semakin banyak frasa unik yang diberikan, semakin besar kemungkinan niat ini akan dicocokkan. Berikut adalah format bagian frasa pelatihan yang dianotasi. Perhatikan bahwa kolom auto bersifat opsional dan perilaku default saat auto tidak ditentukan akan setara dengan auto=false. ($<paramName> '<sample text>' auto=<true or false>) auto = true berarti bagian tersebut dianotasi otomatis oleh NLU. auto = false berarti bagian tersebut dianotasi oleh pengguna. Ini adalah setelan default jika mode otomatis tidak ditentukan. Contoh: "Pesan penerbangan dari ($source 'San Francisco' auto=false) ke ($dest 'Vancouver')"

IntentParameter

Definisi parameter yang dapat digunakan dalam frasa pelatihan.

Representasi JSON 
{
  "name": string,

  // Union field parameter_type can be only one of the following:
  "type": {
    object (ClassReference)
  },
  "entitySetReferences": {
    object (EntitySetReferences)
  }
  // End of list of possible types for union field parameter_type.
}
Kolom
name

string

Wajib. Nama unik parameter intent. Dapat digunakan dalam kondisi dan respons untuk mereferensikan parameter intent yang diekstrak oleh NLU dengan $intent.params.[name].resolved
Kolom union parameter_type. Jenis parameter intent. parameter_type hanya dapat berupa salah satu dari berikut:
type

object (ClassReference)

Opsional. Mendeklarasikan jenis data parameter ini. Intent ini tidak boleh disetel untuk intent bawaan.
entitySetReferences

object (EntitySetReferences)

Opsional. Rujukan ke kumpulan entity yang diizinkan untuk parameter intent ini. Hanya valid untuk parameter intent bawaan. Referensi ini mengarah ke kumpulan entity di 'custom/entitySets' saat ini.

ClassReference

Referensi ke class yang digunakan untuk mendeklarasikan jenis kolom atau nilai yang ditampilkan. Enum juga merupakan jenis class yang dapat direferensikan menggunakan ClassReference.

Representasi JSON 
{
  "name": string,
  "list": boolean
}
Kolom
name

string

Wajib. Nama jenis bawaan atau jenis kustom parameter. Contoh: PizzaToppings, actions.type.Number
list

boolean

Opsional. Menunjukkan apakah tipe data mewakili daftar nilai.

EntitySetReferences

Referensi kumpulan entitas untuk parameter intent.

Representasi JSON 
{
  "entitySetReferences": [
    {
      object (EntitySetReference)
    }
  ]
}
Kolom
entitySetReferences[]

object (EntitySetReference)

Wajib. Referensi kumpulan entitas untuk parameter intent.

EntitySetReference

Referensi ke kumpulan entity yang diizinkan untuk parameter intent ini.

Representasi JSON 
{
  "entitySet": string
}
Kolom
entitySet

string

Wajib. Mengidentifikasi kumpulan entitas tertentu yang akan dipertimbangkan untuk parameter tertentu. Definisi kumpulan entitas yang sesuai harus ada di direktori custom/entitySets/.

Jenis

Pernyataan jenis kustom, bukan jenis bawaan. Jenis dapat ditetapkan ke slot dalam scene atau parameter dari frasa pelatihan intent. Dalam praktiknya, Jenis dapat dianggap sebagai enum. Catatan, nama jenis ditentukan dalam nama file.

Representasi JSON 
{
  "exclusions": [
    string
  ],

  // Union field sub_type can be only one of the following:
  "synonym": {
    object (SynonymType)
  },
  "regularExpression": {
    object (RegularExpressionType)
  },
  "freeText": {
    object (FreeTextType)
  }
  // End of list of possible types for union field sub_type.
}
Kolom
exclusions[]

string

Kumpulan kata/frasa unik yang tidak boleh dicocokkan menurut jenisnya. Catatan: Jika kata/frasa cocok dengan jenisnya namun dicantumkan sebagai pengecualian, kata/frasa tidak akan ditampilkan dalam hasil ekstraksi parameter. Kolom ini dapat dilokalkan.
Kolom union sub_type. Pemilihan sub-jenis berdasarkan jenis pencocokan yang akan dilakukan. sub_type hanya dapat berupa salah satu dari berikut:
synonym

object (SynonymType)

Jenis sinonim, yang pada dasarnya adalah enum.
regularExpression

object (RegularExpressionType)

Jenis ekspresi reguler, memungkinkan pencocokan ekspresi reguler.
freeText

object (FreeTextType)

Jenis FreeText.

SynonymType

Ketik yang mencocokkan teks menurut kumpulan sinonim.

Representasi JSON 
{
  "matchType": enum (MatchType),
  "acceptUnknownValues": boolean,
  "entities": {
    string: {
      object (Entity)
    },
    ...
  }
}
Kolom
matchType

enum (MatchType)

Opsional. Jenis pencocokan untuk sinonim.
acceptUnknownValues

boolean

Opsional. Jika disetel ke benar (true), ini akan cocok dengan kata atau frasa yang tidak dikenal berdasarkan input dan data pelatihan intent di sekitarnya, seperti item yang mungkin ditambahkan ke daftar belanjaan.
entities

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

Wajib. Peta bernama entitas sinonim.

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

MatchType

Jenis pencocokan yang akan digunakan entri dalam jenis ini. Hal ini akan memastikan semua jenis menggunakan metode pencocokan yang sama dan memungkinkan variasi pencocokan untuk pencocokan sinonim (yaitu yang tidak jelas versus persis). Jika nilainya UNSPECIFIED, nilai ini akan ditetapkan secara default ke EXACT_MATCH.

Enum
UNSPECIFIED Default-nya adalah EXACT_MATCH.
EXACT_MATCH Mencari kecocokan persis antara sinonim atau nama.
FUZZY_MATCH Lebih longgar dari EXACT_MATCH. Mencari kecocokan yang mirip dan juga kecocokan persis.

Entitas

Mewakili kolom entity sinonim yang berisi detail satu entri di dalam jenis.

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

object (EntityDisplay)

Opsional. Entity menampilkan detail.
synonyms[]

string

Opsional. Daftar sinonim entitas. Kolom ini dapat dilokalkan.

EntityDisplay

Elemen yang akan ditampilkan di kanvas setelah entity jenis tertentu diekstrak dari kueri. Hanya relevan untuk aplikasi yang mendukung kanvas. Pesan ini dapat dilokalkan.

Representasi JSON 
{
  "iconTitle": string,
  "iconUrl": string
}
Kolom
iconTitle

string

Opsional. Judul ikon.
iconUrl

string

Wajib. URL ikon.

RegularExpressionType

Jenis yang cocok dengan teks menurut ekspresi reguler. Pesan ini dapat dilokalkan.

Representasi JSON 
{
  "entities": {
    string: {
      object (Entity)
    },
    ...
  }
}
Kolom
entities

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

Wajib. Peta entitas bernama yang masing-masing berisi string Regex.

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

Entitas

Mewakili objek entity yang berisi ekspresi reguler yang digunakan untuk perbandingan.

Representasi JSON 
{
  "display": {
    object (EntityDisplay)
  },
  "regularExpressions": [
    string
  ]
}
Kolom
display

object (EntityDisplay)

Opsional. Elemen yang akan ditampilkan di kanvas setelah entity diekstrak dari kueri. Hanya relevan untuk aplikasi yang mendukung kanvas.
regularExpressions[]

string

Wajib. Menggunakan sintaksis ekspresi reguler RE2 (Lihat https://github.com/google/re2/wiki/Syntax untuk detail selengkapnya)

FreeTextType

Jenis yang cocok dengan teks apa pun jika konteks kata di sekitarnya mendekati contoh pelatihan yang diberikan.

Representasi JSON 
{
  "display": {
    object (EntityDisplay)
  }
}
Kolom
display

object (EntityDisplay)

Opsional. Elemen yang akan ditampilkan di kanvas setelah entity diekstrak dari kueri. Hanya relevan untuk aplikasi yang mendukung kanvas.

EntitySet

Kumpulan entity menjelaskan kumpulan entity yang telah ditentukan sebelumnya yang dapat menjadi sumber asal nilai parameter intent bawaan. Kumpulan entity dapat dirujuk dari entitySet dalam parameter intent bawaan.

Representasi JSON 
{
  "entities": [
    {
      object (Entity)
    }
  ]
}
Kolom
entities[]

object (Entity)

Wajib. Daftar entitas yang didukung kumpulan entitas ini.

Entitas

Entity yang dapat menghasilkan nilai parameter intent bawaan.

Representasi JSON 
{
  "id": string
}
Kolom
id

string

Wajib. ID entitas. Untuk mengetahui daftar parameter intent bawaan dan entitas yang didukung, lihat https://developers.google.com/assistant/conversational/build/built-in-intents

GlobalIntentEvent

Mendefinisikan pengendali intent global. Peristiwa intent global tercakup dalam seluruh project Action dan dapat diganti oleh pengendali intent dalam sebuah scene. Nama intent harus unik dalam project Action.

Intent global dapat dicocokkan kapan saja selama sesi, sehingga pengguna dapat mengakses alur umum seperti "dapatkan bantuan" atau "kembali ke beranda". Fungsi ini juga dapat digunakan untuk melakukan deep link pengguna ke dalam alur tertentu saat mereka memanggil Action.

Perhatikan, nama intent ditetapkan dalam nama file.

Representasi JSON 
{
  "transitionToScene": string,
  "handler": {
    object (EventHandler)
  }
}
Kolom
transitionToScene

string

Opsional. Adegan tujuan yang menjadi titik awal percakapan. Status scene saat ini dihapus pada transisi.
handler

object (EventHandler)

Opsional. Pengendali peristiwa yang dipicu saat intent cocok. Harus dijalankan sebelum bertransisi ke scene tujuan. Berguna untuk membuat Prompt sebagai respons terhadap peristiwa.

EventHandler

Menentukan pengendali yang akan dieksekusi setelah sebuah peristiwa. Contoh peristiwa adalah peristiwa berbasis intent dan kondisi dalam scene.

Representasi JSON 
{
  "webhookHandler": string,

  // Union field prompt can be only one of the following:
  "staticPrompt": {
    object (StaticPrompt)
  },
  "staticPromptName": string
  // End of list of possible types for union field prompt.
}
Kolom
webhookHandler

string

Nama pengendali webhook yang akan dipanggil.
Kolom union prompt. Perintah dapat dibuat sebagai inline atau direferensikan oleh nama. prompt hanya dapat berupa salah satu dari berikut:
staticPrompt

object (StaticPrompt)

Perintah statis inline. Dapat berisi referensi ke resource string dalam paket.
staticPromptName

string

Nama prompt statis yang akan dipanggil.

StaticPrompt

Mewakili daftar kandidat prompt, salah satunya akan dipilih sebagai prompt yang akan ditampilkan sebagai respons terhadap pengguna. Pesan ini dapat dilokalkan.

Representasi JSON 
{
  "candidates": [
    {
      object (StaticPromptCandidate)
    }
  ]
}
Kolom
candidates[]

object (StaticPromptCandidate)

Daftar perintah kandidat yang akan dikirim ke klien. Setiap prompt memiliki pemilih untuk menentukan kapan prompt tersebut dapat digunakan. Pemilih pertama yang cocok dengan permintaan akan dikirim dan sisanya akan diabaikan.

StaticPromptCandidate

Mewakili kandidat prompt statis.

Representasi JSON 
{
  "selector": {
    object (Selector)
  },
  "promptResponse": {
    object (StaticPromptResponse)
  }
}
Kolom
selector

object (Selector)

Opsional. Kriteria apakah dialog ini cocok dengan permintaan. Jika pemilih kosong, dialog ini akan selalu dipicu.
promptResponse

object (StaticPromptResponse)

Respons perintah yang terkait dengan pemilih.

Pemilih

Menentukan kriteria apakah prompt cocok dengan permintaan.

Representasi JSON 
{
  "surfaceCapabilities": {
    object (SurfaceCapabilities)
  }
}
Kolom
surfaceCapabilities

object (SurfaceCapabilities)

Kumpulan kemampuan permukaan yang diperlukan.

SurfaceCapabilities

Menampilkan permukaan yang digunakan pengguna untuk membuat permintaan ke Action.

Representasi JSON 
{
  "capabilities": [
    enum (Capability)
  ]
}
Kolom
capabilities[]

enum (Capability)

Wajib. Kemampuan platform yang membuat permintaan ke Action.

Kemampuan

Kemampuan yang didukung platform perangkat pada saat permintaan.

Enum
UNSPECIFIED Kemampuan platform 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.

StaticPromptResponse

Mewakili respons terstruktur yang akan dikirim kepada pengguna, seperti teks, ucapan, kartu, data kanvas, chip saran, dll.

Representasi JSON 
{
  "firstSimple": {
    object (StaticSimplePrompt)
  },
  "content": {
    object (StaticContentPrompt)
  },
  "lastSimple": {
    object (StaticSimplePrompt)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (StaticLinkPrompt)
  },
  "override": boolean,
  "canvas": {
    object (StaticCanvasPrompt)
  }
}
Kolom
firstSimple

object (StaticSimplePrompt)

Opsional. Respons suara dan teks saja pertama.
content

object (StaticContentPrompt)

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

object (StaticSimplePrompt)

Opsional. Suara terakhir dan respons hanya teks.
suggestions[]

object (Suggestion)

Opsional. Saran untuk ditampilkan kepada pengguna, yang akan selalu muncul di akhir respons. Jika kolom append dalam perintah yang berisi adalah true, judul yang ditentukan di kolom ini akan ditambahkan ke judul yang ditentukan dalam perintah saran yang ditentukan sebelumnya dan nilai duplikat akan dihapus.
override

boolean

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

object (StaticCanvasPrompt)

Respons yang akan digunakan untuk pengalaman kanvas interaktif.

StaticSimplePrompt

Menampilkan prompt sederhana yang akan dikirim ke pengguna.

Representasi JSON 
{
  "variants": [
    {
      object (Variant)
    }
  ]
}
Kolom
variants[]

object (Variant)

Daftar kemungkinan varian.

Varian

Mewakili varian yang merupakan bagian dari perintah sederhana.

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

string

Opsional. Menunjukkan ucapan yang akan diucapkan kepada pengguna. Dapat berupa SSML atau text to speech. Secara default, ucapan akan ditambahkan ke ucapan perintah Sederhana sebelumnya. Jika kolom override dalam perintah yang memuatnya adalah true, ucapan yang ditentukan dalam kolom ini akan menggantikan ucapan Perintah sederhana sebelumnya.
text

string

Opsional. Teks yang akan ditampilkan dalam balon chat. Jika tidak diberikan, rendering tampilan untuk kolom ucapan di atas akan digunakan. Dibatasi hingga 640 karakter. Secara default, teks akan ditambahkan ke teks Dialog sederhana sebelumnya. Jika kolom override dalam perintah yang memuatnya adalah true, teks yang ditentukan dalam kolom ini akan menggantikan teks Dialog sederhana sebelumnya.

StaticContentPrompt

Placeholder untuk bagian Konten pada StaticPrompt.

Representasi JSON 
{

  // Union field content can be only one of the following:
  "card": {
    object (StaticCardPrompt)
  },
  "image": {
    object (StaticImagePrompt)
  },
  "table": {
    object (StaticTablePrompt)
  },
  "media": {
    object (StaticMediaPrompt)
  },
  "list": {
    object (StaticListPrompt)
  },
  "collection": {
    object (StaticCollectionPrompt)
  },
  "collectionBrowse": {
    object (StaticCollectionBrowsePrompt)
  }
  // End of list of possible types for union field content.
}
Kolom
Kolom union content. Hanya satu jenis konten yang boleh ditampilkan di Prompt. content hanya dapat berupa salah satu dari berikut:
card

object (StaticCardPrompt)

Kartu dasar.
image

object (StaticImagePrompt)

Gambar.
table

object (StaticTablePrompt)

Kartu tabel.
media

object (StaticMediaPrompt)

Respons yang menunjukkan kumpulan media yang akan diputar.
list

object (StaticListPrompt)

Kartu untuk menyajikan daftar opsi yang dapat dipilih.
collection

object (StaticCollectionPrompt)

Kartu yang menampilkan daftar opsi yang dapat dipilih.
collectionBrowse

object (StaticCollectionBrowsePrompt)

Kartu yang menampilkan kumpulan halaman web yang akan dibuka.

StaticCardPrompt

Kartu dasar untuk menampilkan beberapa informasi, misalnya gambar dan/atau teks.

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

string

Opsional. Keseluruhan judul kartu.
subtitle

string

Opsional. Subtitel kartu.
text

string

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

object (StaticImagePrompt)

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

enum (ImageFill)

Opsional. Cara latar belakang gambar akan diisi.
button

object (StaticLinkPrompt)

Opsional. Tombol yang dapat diklik untuk ditampilkan di Kartu.

StaticImagePrompt

Gambar yang ditampilkan di kartu.

Representasi JSON 
{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}
Kolom
url

string

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

string

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

integer

Opsional. Tinggi gambar dalam piksel.
width

integer

Opsional. Lebar gambar dalam piksel.

ImageFill

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

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

StaticLinkPrompt

Menentukan link yang akan ditampilkan sebagai chip saran dan dapat dibuka oleh pengguna.

Representasi JSON 
{
  "name": string,
  "open": {
    object (OpenUrl)
  }
}
Kolom
name

string

Nama tautan
open

object (OpenUrl)

Menentukan perilaku saat pengguna membuka link.

OpenUrl

Menentukan perilaku saat pengguna membuka link.

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

string

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

enum (UrlHint)

Menunjukkan petunjuk untuk jenis URL.

UrlHint

Berbagai jenis petunjuk URL.

Enum
HINT_UNSPECIFIED Tidak ditentukan
AMP URL yang mengarah langsung ke konten AMP, atau URL kanonis yang merujuk ke konten AMP melalui <link rel="amphtml">.

StaticTablePrompt

Kartu tabel untuk menampilkan tabel teks.

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

string

Opsional. Judul tabel keseluruhan. Harus disetel jika subtitel disetel.
subtitle

string

Opsional. Subtitel untuk tabel.
image

object (StaticImagePrompt)

Opsional. Gambar yang terkait dengan tabel.
columns[]

object (TableColumn)

Opsional. Header dan perataan kolom.
rows[]

object (TableRow)

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

object (StaticLinkPrompt)

Opsional. Tombol.

TableColumn

Menjelaskan kolom dalam tabel.

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

string

Teks header untuk kolom.
align

enum (HorizontalAlignment)

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

HorizontalAlignment

Perataan konten di dalam sel.

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

TableRow

Mendeskripsikan baris dalam tabel.

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

object (TableCell)

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

boolean

Menunjukkan apakah harus ada pemisah setelah setiap baris.

TableCell

Menggambarkan sel dalam baris.

Representasi JSON 
{
  "text": string
}
Kolom
text

string

Konten teks dalam sel.

StaticMediaPrompt

Berisi informasi tentang media, seperti nama, deskripsi, URL, dll. ID berikutnya: 11

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

enum (MediaType)

Jenis media respons ini.
startOffset

string (Duration format)

Offset awal objek media pertama.

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

enum (OptionalMediaControls)

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

object (MediaObject)

Daftar objek media.
repeatMode

enum (RepeatMode)

Mode pengulangan untuk daftar Objek Media.

MediaType

Jenis media respons ini.

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

OptionalMediaControls

Jenis kontrol media yang dapat didukung respons media secara opsional

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

MediaObject

Mewakili satu objek media.

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

string

Nama objek media ini.
description

string

Deskripsi objek media ini.
url

string

URL yang mengarah ke konten media.
image

object (MediaImage)

Gambar yang akan ditampilkan dengan kartu media.

MediaImage

Gambar yang akan ditampilkan di dalam MediaPrompt.

Representasi JSON 
{

  // Union field image can be only one of the following:
  "large": {
    object (StaticImagePrompt)
  },
  "icon": {
    object (StaticImagePrompt)
  }
  // End of list of possible types for union field image.
}
Kolom
Kolom union image. Hanya satu jenis MediaImage yang diizinkan. image hanya dapat berupa salah satu dari berikut:
large

object (StaticImagePrompt)

Gambar berukuran besar, seperti sampul album, dll.
icon

object (StaticImagePrompt)

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

RepeatMode

Jenis mode pengulangan untuk daftar objek media.

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

StaticListPrompt

Kartu untuk menyajikan daftar opsi yang dapat dipilih.

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

string

Opsional. Judul daftar.
subtitle

string

Opsional. Subtitel daftar.
items[]

object (ListItem)

Wajib. Item daftar.

ListItem

Item dalam daftar.

Representasi JSON 
{
  "key": string,
  "title": string,
  "description": string,
  "image": {
    object (StaticImagePrompt)
  }
}
Kolom
key

string

Wajib. Kunci NLU yang cocok dengan nama kunci entri dalam jenis terkait. Saat item diketuk, kunci ini akan diposting kembali sebagai parameter opsi pilih.
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.
description

string

Opsional. Teks isi item.
image

object (StaticImagePrompt)

Opsional. Gambar item.

StaticCollectionPrompt

Kartu untuk menyajikan kumpulan opsi yang dapat dipilih.

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

string

Opsional. Judul koleksi.
subtitle

string

Opsional. Subtitel koleksi.
items[]

object (CollectionItem)

Wajib. Item koleksi.
imageFill

enum (ImageFill)

Opsional. Jenis opsi tampilan gambar.

CollectionItem

Item dalam koleksi.

Representasi JSON 
{
  "key": string,
  "title": string,
  "description": string,
  "image": {
    object (StaticImagePrompt)
  }
}
Kolom
key

string

Wajib. Kunci NLU yang cocok dengan nama kunci entri di Jenis yang terkait. Saat item diketuk, kunci ini akan diposting kembali sebagai parameter opsi pilih.
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.
description

string

Opsional. Teks isi item.
image

object (StaticImagePrompt)

Opsional. Gambar item.

StaticCollectionBrowsePrompt

Menyajikan serangkaian dokumen web sebagai kumpulan item ubin besar. Item dapat dipilih untuk meluncurkan dokumen web terkait di penampil web.

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

object (CollectionBrowseItem)

Item dalam koleksi penjelajahan. Ukuran daftar harus dalam rentang [2, 10].
imageFill

enum (ImageFill)

Opsi tampilan gambar untuk gambar dalam koleksi.

CollectionBrowseItem

Item dalam koleksi.

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

string

Wajib. Judul item koleksi.
description

string

Deskripsi item koleksi.
footer

string

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

object (StaticImagePrompt)

Gambar untuk item koleksi.
openUriAction

object (OpenUrl)

Wajib. URI yang akan dibuka jika item dipilih.

Saran

Mewakili chip saran, yaitu elemen UI yang ditampilkan kepada pengguna untuk memudahkan.

Representasi JSON 
{
  "title": string
}
Kolom
title

string

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

StaticCanvasPrompt

Merepresentasikan respons Canvas Interaktif yang akan dikirim ke pengguna. Ini dapat digunakan bersama dengan kolom firstSimple dalam perintah yang berisi untuk berbicara dengan pengguna selain menampilkan respons kanvas interaktif.

Representasi JSON 
{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "sendStateDataToCanvasApp": boolean,
  "enableFullScreen": boolean
}
Kolom
url

string

Wajib. URL tampilan web yang akan dimuat.
data[]

value (Value format)

Opsional. Data JSON akan diteruskan ke halaman web pengalaman imersif sebagai peristiwa. Jika kolom override dalam perintah yang berisi adalah false, nilai data yang ditentukan dalam perintah Canvas ini akan ditambahkan setelah nilai data ditentukan dalam perintah Canvas sebelumnya.
suppressMic

boolean

Opsional. Nilai sebenarnya berarti bahwa mikrofon tidak akan dibuka untuk menangkap input setelah respons imersif ini ditampilkan kepada pengguna.
sendStateDataToCanvasApp

boolean

Opsional. Jika true, metadata terkait percakapan akan disertakan dan dikirim kembali ke aplikasi kanvas.
enableFullScreen

boolean

Opsional. Jika true aplikasi kanvas akan memenuhi layar penuh dan tidak akan memiliki header di bagian atas. Pesan toast juga akan ditampilkan di layar pemuatan yang menyertakan nama tampilan Action, nama developer, dan petunjuk untuk keluar dari Action. Nilai default: false.

Scene

Scene adalah unit dasar alur kontrol saat mendesain percakapan. Fragmen ini dapat digabungkan dengan scene lain, membuat prompt untuk pengguna akhir, dan menentukan slot. Nama suasana ditetapkan dalam nama file.

Representasi JSON 
{
  "onEnter": {
    object (EventHandler)
  },
  "intentEvents": [
    {
      object (IntentEvent)
    }
  ],
  "conditionalEvents": [
    {
      object (ConditionalEvent)
    }
  ],
  "slots": [
    {
      object (Slot)
    }
  ],
  "onSlotUpdated": {
    object (EventHandler)
  }
}
Kolom
onEnter

object (EventHandler)

Pengendali yang akan dipanggil saat bertransisi ke scene ini.
intentEvents[]

object (IntentEvent)

Daftar peristiwa yang dipicu berdasarkan intent. Peristiwa ini dapat dipicu kapan saja setelah Handler on_load dipanggil. Penting - peristiwa ini menentukan kumpulan intent yang dicakup dalam scene ini dan akan lebih diutamakan daripada peristiwa yang ditetapkan secara global yang memiliki intent yang sama atau frasa pemicunya. Nama intent harus unik dalam scene.
conditionalEvents[]

object (ConditionalEvent)

Daftar peristiwa yang akan dipicu berdasarkan pernyataan bersyarat. Ini dievaluasi setelah formulir diisi atau segera setelah on_load jika adegan ini tidak memiliki formulir (evaluasi hanya dilakukan sekali). Hanya peristiwa pencocokan pertama yang akan dipicu.
slots[]

object (Slot)

Daftar slot yang diurutkan. Setiap slot menentukan jenis data yang akan diselesaikan dan dikonfigurasi untuk menyesuaikan pengalaman resolusi ini (misalnya perintah).
onSlotUpdated

object (EventHandler)

Pengendali dipanggil saat ada perubahan status slot yang tidak disebabkan oleh pembaruan dalam Pengendali lain. Hal ini memungkinkan slot menjadi tidak valid, scene menjadi tidak valid, atau perubahan lain pada status scene.

IntentEvent

Mendaftarkan Peristiwa yang terpicu sebagai hasil dari kecocokan intent.

Representasi JSON 
{
  "intent": string,
  "transitionToScene": string,
  "handler": {
    object (EventHandler)
  }
}
Kolom
intent

string

Wajib. Intent yang memicu peristiwa.
transitionToScene

string

Opsional. Adegan tujuan yang menjadi titik awal percakapan. Status scene saat ini dihapus pada transisi.
handler

object (EventHandler)

Opsional. Pengendali peristiwa yang dipicu saat intent cocok. Harus dieksekusi sebelum bertransisi ke scene tujuan. Berguna untuk membuat prompt sebagai respons terhadap peristiwa.

ConditionalEvent

Mendaftarkan peristiwa yang terpicu sebagai hasil dari kondisi sebenarnya.

Representasi JSON 
{
  "condition": string,
  "transitionToScene": string,
  "handler": {
    object (EventHandler)
  }
}
Kolom
condition

string

Wajib. Kondisi filter untuk memicu peristiwa ini. Jika kondisi dievaluasi ke benar (true), handler yang terkait akan dipicu. Referensi variabel berikut didukung: $session - Untuk mereferensikan data dalam penyimpanan sesi. $user - Untuk mereferensikan data dalam penyimpanan pengguna. Operator boolean berikut didukung (dengan contoh): && - session.params.counter > 0 && session.params.counter < 100 || - session.params.foo == "John" || session.params.counter == "Adam" ! - !(session.params.counter == 5) Perbandingan berikut didukung: ==, !=, <, >, <=, >= Operator daftar dan string berikut didukung (dengan contoh): in - "Semangka" dalam session.params.fruitList size - size(session.params.fruitList) > 2 substring - session.params.fullName.contains("John")
transitionToScene

string

Opsional. Adegan tujuan tempat percakapan harus melompat saat kondisi terkait dievaluasi ke benar (true). Status scene saat ini dihapus pada transisi.
handler

object (EventHandler)

Opsional. Pengendali peristiwa yang dipicu saat kondisi terkait dievaluasi ke true. Harus dieksekusi sebelum bertransisi ke scene tujuan. Berguna untuk membuat Prompt sebagai respons terhadap peristiwa.

Slot

Konfigurasi untuk slot. Slot adalah unit tunggal data yang dapat diisi melalui natural language (yaitu parameter intent), parameter sesi, dan sumber lainnya.

Representasi JSON 
{
  "name": string,
  "type": {
    object (ClassReference)
  },
  "required": boolean,
  "promptSettings": {
    object (PromptSettings)
  },
  "commitBehavior": {
    object (CommitBehavior)
  },
  "config": value,
  "defaultValue": {
    object (DefaultValue)
  }
}
Kolom
name

string

Wajib. Nama slot.
type

object (ClassReference)

Wajib. Mendeklarasikan jenis data slot ini.
required

boolean

Opsional. Menunjukkan apakah slot harus diisi sebelum melanjutkan. Slot wajib yang tidak terisi akan memicu perintah yang dapat disesuaikan kepada pengguna.
promptSettings

object (PromptSettings)

Opsional. Mendaftarkan Perintah untuk berbagai tahap pengisian slot.
commitBehavior

object (CommitBehavior)

Opsional. Perilaku commit yang terkait dengan slot.
config

value (Value format)

Opsional. Konfigurasi tambahan yang terkait dengan slot yang digunakan untuk mengisi slot. Format konfigurasi bersifat khusus untuk jenis slot. Referensi resource untuk parameter pengguna atau sesi dapat ditambahkan ke konfigurasi ini. Konfigurasi ini diperlukan untuk mengisi slot yang terkait dengan transaksi dan engagement pengguna.

Contoh: Untuk slot jenis actions.type.CompletePurchaseValue, konfigurasi berikut mengusulkan pesanan konten digital dengan referensi ke parameter sesi yang ditentukan klien userSelectedSkuId:

{ &quot;@type&quot;: &quot;type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec&quot;, &quot;skuId&quot;: { &quot;skuType&quot;: &quot;SKU_TYPE_IN_APP&quot;, &quot;id&quot;: &quot;$session.params.userSelectedSkuId&quot;, &quot;packageName&quot;: &quot;com.example.company&quot; }
defaultValue

object (DefaultValue)

Opsional. Konfigurasi untuk mengisi nilai default untuk slot ini.

PromptSettings

Satu tempat yang ditentukan untuk perintah slot.

Representasi JSON 
{
  "initialPrompt": {
    object (EventHandler)
  },
  "noMatchPrompt1": {
    object (EventHandler)
  },
  "noMatchPrompt2": {
    object (EventHandler)
  },
  "noMatchFinalPrompt": {
    object (EventHandler)
  },
  "noInputPrompt1": {
    object (EventHandler)
  },
  "noInputPrompt2": {
    object (EventHandler)
  },
  "noInputFinalPrompt": {
    object (EventHandler)
  }
}
Kolom
initialPrompt

object (EventHandler)

Minta nilai slot itu sendiri. Contoh: "Ukuran apa yang Anda inginkan?"
noMatchPrompt1

object (EventHandler)

Prompt untuk memberikan jika input pengguna tidak cocok dengan jenis nilai yang diharapkan untuk slot untuk pertama kalinya. Contoh: "Maaf, saya tidak mengerti".
noMatchPrompt2

object (EventHandler)

Prompt untuk memberikan jika input pengguna tidak cocok dengan jenis nilai yang diharapkan untuk slot untuk kedua kalinya. Contoh: "Maaf, saya tidak mengerti".
noMatchFinalPrompt

object (EventHandler)

Prompt untuk memberikan jika input pengguna tidak cocok dengan jenis nilai yang diharapkan untuk slot untuk terakhir kalinya. Contoh: "Maaf, saya tidak mengerti".
noInputPrompt1

object (EventHandler)

Prompt untuk memberikan jika pengguna tidak memberikan input untuk pertama kalinya. Contoh: "Maaf, saya tidak mengerti".
noInputPrompt2

object (EventHandler)

Prompt untuk memberikan ketika pengguna tidak memberikan input untuk kedua kalinya. Contoh: "Maaf, saya tidak mengerti".
noInputFinalPrompt

object (EventHandler)

Prompt untuk memberikan jika pengguna tidak memberikan input untuk terakhir kalinya. Contoh: "Maaf, saya tidak mengerti".

CommitBehavior

Pesan yang menjelaskan perilaku commit yang terkait dengan slot setelah berhasil diisi.

Representasi JSON 
{
  "writeSessionParam": string
}
Kolom
writeSessionParam

string

Parameter sesi untuk menulis nilai slot setelah diisi. Perhatikan bahwa jalur bertingkat saat ini tidak didukung. "$$" digunakan untuk menulis nilai slot ke parameter sesi dengan nama yang sama dengan slot. Misalnya: writeSessionParam = "fruit" sesuai dengan "$session.params.fruit". writeSessionParam = "tiket" sesuai dengan "$session.params.ticket".

DefaultValue

Konfigurasi untuk mengisi nilai default untuk slot ini.

Representasi JSON 
{
  "sessionParam": string,
  "constant": value
}
Kolom
sessionParam

string

Opsional. Parameter sesi yang akan digunakan untuk melakukan inisialisasi nilai slot, jika memiliki nilai yang tidak kosong. Jenis nilai harus sesuai dengan jenis slot. Perhatikan bahwa jalur bertingkat saat ini tidak didukung. Misalnya: sessionParam = "fruit" sesuai dengan $session.params.fruit. sessionParam = "ticket" sesuai dengan $session.params.ticket.
constant

value (Value format)

Opsional. Nilai default konstan untuk slot. Ini hanya akan digunakan jika nilai untuk slot ini tidak diisi melalui sessionParam. Jenis untuk nilai ini harus sesuai dengan jenis slot.

DataFiles

Wrapper untuk file data berulang. Kolom berulang tidak boleh ada di salah satu dari keduanya.

Representasi JSON 
{
  "dataFiles": [
    {
      object (DataFile)
    }
  ]
}
Kolom
dataFiles[]

object (DataFile)

Beberapa file data.

DataFile

Mewakili satu file yang berisi data tidak terstruktur. Contohnya mencakup file gambar, file audio, dan kode sumber cloud function.

Representasi JSON 
{
  "filePath": string,
  "contentType": string,
  "payload": string
}
Kolom
filePath

string

Jalur relatif file data dari root project dalam struktur file SDK. Jalur file yang diizinkan: - Gambar: resources/images/{multiple directories}?/{ImageName}.{extension} - Audio: resources/audio/{multiple directories}?/{AudioFileName}.{extension} - Kode Cloud Function Inline: webhooks/{WebhookName}.zip Ekstensi yang diizinkan: - Gambar: png, jpg, jpeg - Audio: mp3, mpeg - Fungsi Cloud Inline: zip
contentType

string

Wajib. Jenis konten aset ini. Contoh: text/html. Jenis konten harus mematuhi spesifikasi (http://www.w3.org/Protocols/rfc1341/4_Content-Type.html). Cloud Functions harus dalam format zip dan jenis kontennya harus application/zip;zip_type=cloud_function. Parameter zip_type menunjukkan bahwa zip ditujukan untuk fungsi cloud.
payload

string (bytes format)

Konten file data. Contohnya dapat berupa byte mentah gambar, file audio, atau format zip cloud function. Ada batas ketat 10 MB untuk ukuran payload.

String berenkode base64.