- StaticPromptCandidate
- Seçici
- SurfaceCapabilities
- StaticPromptResponse
- StaticSimplePrompt
- Varyant
- StaticContentPrompt
- StaticCardPrompt
- StaticImagePrompt
- StaticLinkPrompt
- OpenUrl
- StaticTablePrompt
- TableColumn
- TableRow
- TableCell
- StaticMediaPrompt
- MediaObject
- MediaImage
- StaticListPrompt
- ListItem
- StaticCollectionPrompt:
- CollectionItem
- Öneri
- StaticCanvasPrompt
İstem adaylarının listesini temsil eder. Bunlardan biri kullanıcıya verilen yanıtta gösterilecek istem olarak seçilir. Bu mesaj yerelleştirilebilir.
JSON gösterimi | |
---|---|
{
"candidates": [
{
object ( |
Alanlar | |
---|---|
candidates[] |
Müşteriye gönderilecek aday istemlerinin listesi. Her istemde, ne zaman kullanılabileceğini belirleyen bir seçici bulunur. Bir istekle eşleşen ilk seçici gönderilir ve geri kalanı yok sayılır. |
StaticPromptCandidate
Statik bir istem adayını temsil eder.
JSON gösterimi | |
---|---|
{ "selector": { object ( |
Alanlar | |
---|---|
selector |
İsteğe bağlı. Bu istemin bir istekle eşleşip eşleşmediğine ilişkin ölçütler. Seçici boşsa bu istem her zaman tetiklenir. |
promptResponse |
Seçiciyle ilişkili istem yanıtı. |
Seçici
İstemin bir istekle eşleşip eşleşmediğine ilişkin ölçütleri tanımlar.
JSON gösterimi | |
---|---|
{
"surfaceCapabilities": {
object ( |
Alanlar | |
---|---|
surfaceCapabilities |
Gerekli yüzey özellikleri grubu. |
SurfaceCapabilities
Kullanıcının işlem için istekte bulunmak üzere kullandığı yüzeyi temsil eder.
JSON gösterimi | |
---|---|
{
"capabilities": [
enum ( |
Alanlar | |
---|---|
capabilities[] |
Zorunlu. İşlem'e istekte bulunan yüzeyin özellikleri. |
StaticPromptResponse
Kullanıcıya gönderilecek yapılandırılmış yanıtları (ör. metin, konuşma, kartlar, tuval verileri, öneri çipleri) temsil eder.
JSON gösterimi | |
---|---|
{ "firstSimple": { object ( |
Alanlar | |
---|---|
firstSimple |
İsteğe bağlı. İlk sesli ve yalnızca metin yanıtı. |
content |
İsteğe bağlı. Kullanıcıya gösterilecek kart, liste veya medya gibi bir içerik. |
lastSimple |
İsteğe bağlı. Sesli ve yalnızca metin içeren son yanıt. |
suggestions[] |
İsteğe bağlı. Öneriler her zaman yanıtın sonunda görünür ve kullanıcıya gösterilir. İçeren istemdeki "ekle" alanı "true" (doğru) değerine ayarlanırsa bu alanda tanımlanan başlıklar, önceden tanımlanmış öneri istemlerinde tanımlanan başlıklara eklenir ve yinelenen değerler kaldırılır. |
link |
İsteğe bağlı. İlişkilendirilmiş uygulamaya veya siteye bağlantı verebilen ek bir öneri çipi. Çip, "Aç |
override |
İsteğe bağlı. Bu mesajların önceden tanımlanmış iletilerle nasıl birleştirileceğini belirleyen mod. "true", önceden tanımlanmış tüm mesajları (ilk ve son basit, içerik, öneriler bağlantısı ve tuval) temizler ve bu istemde tanımlanan mesajları ekler. "false", bu istemde tanımlanan mesajları önceki yanıtlarda tanımlanan iletilere ekler. Bu alanın "false" olarak ayarlanması, Basit istemler, Öneriler istemi ve Tuval istemi (İçerik isteminin bir bölümü) içindeki bazı alanlara eklenmesi de etkinleştirilir. İstemde tanımlanırsa İçerik ve Bağlantı mesajlarının her zaman üzerine yazılır. Varsayılan değer "false" (yanlış) değeridir. |
canvas |
Etkileşimli tuval deneyimi için kullanılacak bir yanıt. |
StaticSimplePrompt
Kullanıcıya gönderilecek basit bir istemi temsil eder.
JSON gösterimi | |
---|---|
{
"variants": [
{
object ( |
Alanlar | |
---|---|
variants[] |
Olası varyantların listesi. |
Varyant
Basit istemin parçası olan bir varyantı temsil eder.
JSON gösterimi | |
---|---|
{ "speech": string, "text": string } |
Alanlar | |
---|---|
speech |
İsteğe bağlı. Kullanıcıya konuşulacak konuşmayı temsil eder. SSML veya metin okuma olabilir. İçeren istemdeki "ekle" alanı "true" (doğru) değerine ayarlanırsa bu alanda tanımlanan konuşma, önceki Basit istemin konuşmasına eklenir. |
text |
İsteğe bağlı. Sohbet balonunda gösterilecek metin. Sağlanmazsa yukarıdaki konuşma alanının bir ekran oluşturma işlemi kullanılır. Uzunluk sınırı 640 karakterdir. İçeren istemdeki "ekle" alanı "true" (doğru) değerine sahipse bu alanda tanımlanan metin, önceki Basit istemin metnine eklenir. |
StaticContentPrompt
StaticPrompt'un İçerik bölümü için bir yer tutucu.
JSON gösterimi | |
---|---|
{ // Union field |
Alanlar | ||
---|---|---|
content alanı. İstemde yalnızca bir içerik türü bulunabilir. content şunlardan yalnızca biri olabilir: |
||
card |
Temel bir kart. |
|
image |
Bir resim. |
|
table |
Tablo kartı. |
|
media |
Oynatılacak medya grubunu belirten yanıt. |
|
list |
Aralarından seçim yapabileceğiniz seçeneklerin listesini sunan bir kart. |
|
collection |
Aralarından seçim yapabileceğiniz seçeneklerin listesini gösteren bir kart. |
StaticCardPrompt
Bazı bilgileri (ör. resim ve/veya metin) gösteren temel bir kart.
JSON gösterimi | |
---|---|
{ "title": string, "subtitle": string, "text": string, "image": { object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Kartın genel başlığı. |
subtitle |
İsteğe bağlı. Kartın alt başlığı. |
text |
Zorunlu. Resim yoksa gereken kart gövde metni. Biçimlendirme için sınırlı bir Markdown söz dizimini destekler. |
image |
İsteğe bağlı. Kartın lokomotif resmi. Yükseklik 192 dp'ye sabitlenir. |
imageFill |
İsteğe bağlı. Resim arka planının nasıl doldurulacağı. |
button |
İsteğe bağlı. Kartta gösterilecek tıklanabilir bir düğme. |
StaticImagePrompt
Kartta gösterilen bir resim.
JSON gösterimi | |
---|---|
{ "url": string, "alt": string, "height": integer, "width": integer } |
Alanlar | |
---|---|
url |
Zorunlu. Resmin kaynak URL'si. Resimler JPG, PNG ve GIF (animasyonlu ve animasyonsuz) olabilir. Örneğin, |
alt |
Zorunlu. Erişilebilirlik için kullanılacak resmin metin açıklaması (ör. ekran okuyucular). |
height |
İsteğe bağlı. Resmin piksel cinsinden yüksekliği. |
width |
İsteğe bağlı. Resmin piksel cinsinden genişliği. |
StaticLinkPrompt
Öneri çipi olarak gösterilecek ve kullanıcı tarafından açılabilecek bir bağlantıyı tanımlar.
JSON gösterimi | |
---|---|
{
"name": string,
"open": {
object ( |
Alanlar | |
---|---|
name |
Bağlantının adı |
open |
Kullanıcı bağlantıyı açtığında nasıl davranacağını tanımlar. |
OpenUrl
Kullanıcı bağlantıyı açtığında nasıl davranacağını tanımlar.
JSON gösterimi | |
---|---|
{
"url": string,
"hint": enum ( |
Alanlar | |
---|---|
url |
Şunlardan herhangi biri olabilecek URL alanı: - Uygulamayla Bağlantılı Uygulama veya web sayfası açmak için http/https URL'leri |
hint |
URL türüyle ilgili bir ipucu gösterir. |
StaticTablePrompt
Metin tablosunu gösteren tablo kartı.
JSON gösterimi | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Tablonun genel başlığı. Altyazı ayarlanmışsa ayarlanmalıdır. |
subtitle |
İsteğe bağlı. Tablonun alt başlığı. |
image |
İsteğe bağlı. Tabloyla ilişkilendirilen resim. |
columns[] |
İsteğe bağlı. Başlıklar ve sütunların hizalaması. |
rows[] |
İsteğe bağlı. Tablonun satır verileri. İlk 3 satırın gösterilmesi garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzey için hangi satırların gösterileceğini görmek üzere lütfen simülatörle test yapın. WEB_BROWSER işlevini destekleyen yüzeylerde kullanıcıyı daha fazla veri içeren bir web sayfasına yönlendirebilirsiniz. |
button |
İsteğe bağlı. Düğme. |
TableColumn
Tablodaki bir sütunu açıklar.
JSON gösterimi | |
---|---|
{
"header": string,
"align": enum ( |
Alanlar | |
---|---|
header |
Sütunun başlık metni. |
align |
İçeriğin sütunla yatay hizalaması. Belirtilmemişse içerik ön kenara hizalanır. |
TableRow
Tablodaki bir satırı açıklar.
JSON gösterimi | |
---|---|
{
"cells": [
{
object ( |
Alanlar | |
---|---|
cells[] |
Bu satırdaki hücreler. İlk 3 hücrenin gösterilmesi garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzey için hangi hücrelerin gösterileceğini görmek üzere lütfen simülatörle test yapın. |
divider |
Her satırdan sonra ayırıcı olup olmadığını gösterir. |
TableCell
Bir satırdaki hücreyi açıklar.
JSON gösterimi | |
---|---|
{ "text": string } |
Alanlar | |
---|---|
text |
Hücrenin metin içeriği. |
StaticMediaPrompt
Medya hakkında ad, açıklama, url vb. bilgiler içerir. Sonraki kimlik: 9
JSON gösterimi | |
---|---|
{ "mediaType": enum ( |
Alanlar | |
---|---|
mediaType |
Bu yanıtın medya türü. |
startOffset |
İlk medya nesnesinin başlangıç ofseti. En fazla dokuz kesir basamağı içeren ve " |
optionalMediaControls[] |
Bu medya yanıt oturumunun destekleyebileceği isteğe bağlı medya denetimi türleri. Ayarlanırsa belirli bir medya etkinliği gerçekleştiğinde 3p'ye istek gönderilir. Ayarlanmazsa 3p yine de TAMAM ve BAŞARISIZ olmak üzere iki varsayılan kontrol türünü işlemelidir. |
mediaObjects[] |
Medya nesnelerinin listesi. |
MediaObject
Tek bir medya nesnesini temsil eder.
JSON gösterimi | |
---|---|
{
"name": string,
"description": string,
"url": string,
"image": {
object ( |
Alanlar | |
---|---|
name |
Bu medya nesnesinin adı. |
description |
Bu medya nesnesinin açıklaması. |
url |
Medya içeriğini işaret eden URL. |
image |
Medya kartıyla birlikte gösterilecek resim. |
MediaImage
MediaPrompt içinde gösterilecek resim.
JSON gösterimi | |
---|---|
{ // Union field |
Alanlar | ||
---|---|---|
image alanı. Yalnızca bir MediaImage türüne izin verilir. image şunlardan yalnızca biri olabilir: |
||
large |
Albümün kapağı vb. büyük bir resim. |
|
icon |
Başlığın sağında gösterilen küçük resim simgesi. 36x36 dp olarak yeniden boyutlandırıldı. |
StaticListPrompt
Aralarından seçim yapabileceğiniz seçeneklerin listesini sunan bir kart.
JSON gösterimi | |
---|---|
{
"title": string,
"subtitle": string,
"items": [
{
object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Listenin başlığı. |
subtitle |
İsteğe bağlı. Listenin alt başlığı. |
items[] |
Zorunlu. Liste öğeleri. |
ListItem
Listedeki bir öğe.
JSON gösterimi | |
---|---|
{
"key": string,
"title": string,
"description": string,
"image": {
object ( |
Alanlar | |
---|---|
key |
Zorunlu. İlişkili türdeki giriş anahtarı adıyla eşleşen NLU anahtarı. Öğeye dokunulduğunda bu anahtar seçim parametresi olarak geri gönderilir. |
title |
Zorunlu. Öğenin başlığı. Bu metine dokunulduğunda, kullanıcı yazmış gibi, görüşmede aynen geri gönderilir. Her başlık, öğe kümesi içinde benzersiz olmalıdır. |
description |
İsteğe bağlı. Öğenin gövde metni. |
image |
İsteğe bağlı. Öğe resmi. |
StaticCollectionPrompt
Aralarından seçim yapabileceğiniz bir dizi seçeneği sunan kart.
JSON gösterimi | |
---|---|
{ "title": string, "subtitle": string, "items": [ { object ( |
Alanlar | |
---|---|
title |
İsteğe bağlı. Koleksiyonun başlığı. |
subtitle |
İsteğe bağlı. Koleksiyonun alt başlığı. |
items[] |
Zorunlu. Koleksiyon öğeleri'ne dokunun. |
imageFill |
İsteğe bağlı. Resim görüntüleme seçeneğinin türü. |
CollectionItem
Koleksiyondaki bir öğe.
JSON gösterimi | |
---|---|
{
"key": string,
"title": string,
"description": string,
"image": {
object ( |
Alanlar | |
---|---|
key |
Zorunlu. İlişkili Tür'deki giriş anahtarı adıyla eşleşen NLU anahtarı. Öğeye dokunulduğunda bu anahtar seçim parametresi olarak geri gönderilir. |
title |
Zorunlu. Öğenin başlığı. Bu metine dokunulduğunda, kullanıcı yazmış gibi, görüşmede aynen geri gönderilir. Her başlık, öğe kümesi içinde benzersiz olmalıdır. |
description |
İsteğe bağlı. Öğenin gövde metni. |
image |
İsteğe bağlı. Öğe resmi. |
Öneri
Bir öneri çipini temsil eder. Kolaylık sağlamak için kullanıcıya gösterilen bir kullanıcı arayüzü öğesidir.
JSON gösterimi | |
---|---|
{ "title": string } |
Alanlar | |
---|---|
title |
Zorunlu. Öneri çipinde gösterilen metin. Bu metine dokunulduğunda, kullanıcı yazmış gibi, görüşmede aynen geri gönderilir. Öneri çipi grubundaki her başlık benzersiz olmalıdır. Maks. 25 karakter |
StaticCanvasPrompt
Kullanıcıya gönderilecek Etkileşimli Tuval yanıtını temsil eder. Bu, etkileşimli bir tuval yanıtı görüntülemenin yanı sıra kullanıcıyla konuşmayı içeren istemdeki "first Simple" alanıyla birlikte kullanılabilir.
JSON gösterimi | |
---|---|
{ "url": string, "data": [ value ], "suppressMic": boolean } |
Alanlar | |
---|---|
url |
Zorunlu. Yüklenecek web görünümünün URL'si. |
data[] |
İsteğe bağlı. Kapsamlı deneyim web sayfasına etkinlik olarak aktarılacak JSON verileri. İçeren istemdeki "geçersiz kıl" alanı "false" (yanlış) değerine sahipse bu Canvas isteminde tanımlanan veri değerleri önceki Canvas istemlerinde tanımlanan veri değerlerinden sonra eklenir. |
suppressMic |
İsteğe bağlı. Doğru değeri, bu kapsamlı yanıt kullanıcıya sunulduktan sonra mikrofonun giriş yakalamak için açılmayacağı anlamına gelir. |