Method: projects.sendInteraction

string

Zorunlu. Test edilen proje (Proje Kimliği ile belirtilir). Biçim: projeler/{proje}

{
  "query": string,
  "type": enum (InputType)
}

string

Kullanıcı tarafından gönderilen girişin içeriği.

enum (InputType)

Girişin türü.

{
  "surface": enum (Surface),
  "location": {
    object (Location)
  },
  "locale": string,
  "timeZone": string
}

enum (Surface)

İşlem ile etkileşim için kullanılan yüzey.

object (Location)

Enlem, boylam ve biçimlendirilmiş adres gibi cihaz konumu.

string

Cihazda belirlenen yerel ayar. Biçim, BCP 47'ye uygun olmalıdır: https://tools.ietf.org/html/bcp47 Örnekler: en, en-US, es-419 (daha fazla örnek için https://tools.ietf.org/html/bcp47#appendix-A).

string

Cihazda ayarlanan saat dilimi. Biçim, IANA Saat Dilimi Veritabanı'na uygun olmalıdır; ör. "America/New_York": https://www.iana.org/time-zones

{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string
}

object (LatLng)

Coğrafi koordinatlar. [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] izni.

string

Görünen adres, ör. "Basın Sitesi Mahallesi, 215 Sokak, Karabağlar, İzmir 35150". [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] izni.

string

Posta kodu. [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] izni.

string

Şehir. [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] izni.

{
  "latitude": number,
  "longitude": number
}

number

Derece cinsinden enlem. [-90,0, +90,0] aralığında olmalıdır.

number

Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır.

{
  "text": string,
  "speech": [
    string
  ],
  "canvas": {
    object (Canvas)
  },
  "actionsBuilderPrompt": {
    object (Prompt)
  }
}

string

Kullanıcıya düz dize olarak gönderilen sözlü yanıt.

string

İşlem tarafından oluşturulan konuşma içeriği. Bu, SSML gibi işaretleme öğelerini içerebilir.

object (Canvas)

Etkileşimli Tuval içeriği.

object (Prompt)

Görüşme turunun sonundaki istemin durumu. İstem hakkında daha fazla bilgi: https://developers.google.com/assistant/conversational/prompts

{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "enableFullScreen": boolean
}

string

Yüklenecek etkileşimli kanvas web uygulamasının URL'si. Ayarlanmazsa mevcut etkin tuvaldeki URL yeniden kullanılır.

value (Value format)

İsteğe bağlı. Tam sayfa deneyim web sayfasına etkinlik olarak aktarılacak JSON verileri. "Geçersiz kıl" içeren istemdeki alanın "false" olması Bu Canvas isteminde tanımlanan veri değerleri, önceki Canvas istemlerinde tanımlanan veri değerlerinden sonra eklenecek.

boolean

İsteğe bağlı. Varsayılan değer: false.

boolean

true ise tuval uygulaması tam ekranı kaplar ve üst tarafta başlık içermez. Yükleme ekranında, işlemin görünen adını, geliştiricinin adını ve İşlemden çıkma talimatlarını içeren bir durum mesajı da görüntülenir. Varsayılan değer: false.

{
  "append": boolean,
  "override": boolean,
  "firstSimple": {
    object (Simple)
  },
  "content": {
    object (Content)
  },
  "lastSimple": {
    object (Simple)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (Link)
  },
  "canvas": {
    object (Canvas)
  }
}

boolean

İsteğe bağlı. Bu iletilerin önceden tanımlanmış iletilerle birleştirilme şekli. "yanlış" önceden tanımlanmış tüm iletileri (ilk ve son basit, içerik, öneri bağlantısı ve tuval) temizler ve bu istemde tanımlanan iletileri ekler. "true" (doğru) bu istemde tanımlanan iletileri önceki yanıtlarda tanımlanan iletilere ekler. Bu alanın "true" olarak ayarlanması Basit istemler, Öneri istemi ve Kanvas istemi (İçerik isteminin bir parçası) içindeki bazı alanlara ekleme özelliğini de etkinleştirir. İstemde tanımlanırsa İçerik ve Bağlantı iletilerinin üzerine her zaman yazılır. Varsayılan değer "false"tur.

boolean

İsteğe bağlı. Bu iletilerin önceden tanımlanmış iletilerle birleştirilme şekli. "true" (doğru) önceden tanımlanmış tüm iletileri (ilk ve son basit, içerik, öneri bağlantısı ve tuval) temizler ve bu istemde tanımlanan iletileri ekler. "yanlış" bu istemde tanımlanan iletileri önceki yanıtlarda tanımlanan iletilere ekler. Bu alan "false" olarak bırakılıyor Basit istemler, Öneriler istemi ve Kanvas istemi (İçerik isteminin bir parçası) içindeki bazı alanlara da ekleme yapılabilir. İstemde tanımlanırsa İçerik ve Bağlantı iletilerinin her zaman üzerine yazılır. Varsayılan değer "false"tur.

object (Simple)

İsteğe bağlı. İlk sesli ve yalnızca metin yanıt.

object (Content)

İsteğe bağlı. Kullanıcıya gösterilecek kart, liste veya medya gibi bir içerik.

object (Simple)

İsteğe bağlı. Son sesli ve yalnızca metin yanıt.

object (Suggestion)

İsteğe bağlı. Kullanıcıya gösterilecek öneriler. Bunlar, her zaman yanıtın sonunda gösterilir. "Geçersiz kıl" alanına "false" (yanlış) değeri eklenirse bu alanda tanımlanan başlıklar, önceden tanımlanmış tüm öneri istemlerinde tanımlanan başlıklara eklenir ve yinelenen değerler kaldırılır.

object (Link)

İsteğe bağlı. İlişkili uygulama veya siteye bağlantı verebilecek ek bir öneri çipi. Çip, "Aç " başlığıyla oluşturulur. Maksimum 20 karakter.

object (Canvas)

İsteğe bağlı. Kullanıcıya gönderilecek Etkileşimli Tuval yanıtını temsil eder.

{
  "speech": string,
  "text": string
}

string

İsteğe bağlı. Kullanıcıya söylenecek konuşmayı temsil eder. SSML veya metin okuma olabilir. "Geçersiz kıl" alanındaki istem "true" değerine ayarlandığında, bu alanda tanımlanan konuşma önceki Basit istemin konuşmasının yerini alır.

string

Sohbet balonunda görüntülenecek isteğe bağlı metin. Belirtilmezse yukarıdaki konuşma alanının görüntülemesi kullanılır. Uzunluk sınırı 640 karakterdir. "Geçersiz kıl" alanındaki istem "true" ise bu alanda tanımlanan metin önceki Basit istemin metniyle değiştirilir.

{

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

object (Card)

Temel kart.

object (Image)

Bir resim.

object (Table)

Tablo kartı.

object (Media)

Oynatılacak bir grup medyayı gösteren yanıt.

object (Canvas)

Etkileşimli tuval deneyimi için kullanılacak yanıt.

object (Collection)

Bir dizi seçenek sunan kart.

object (List)

Seçebileceğiniz seçeneklerin listesini sunan bir kart.

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

string

Kartın genel başlığı. İsteğe bağlı.

string

İsteğe bağlı.

string

Kartın gövde metni. Biçimlendirme için sınırlı bir Markdown söz dizimi grubunu destekler. Resim mevcut olmadığı sürece gereklidir.

object (Image)

Kart için hero resim. Yükseklik 192 dp olarak sabitlendi. İsteğe bağlı.

enum (ImageFill)

Resim arka planının nasıl doldurulacağı. İsteğe bağlı.

object (Link)

Düğme. İsteğe bağlı.

{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}

string

Resmin kaynak URL'si. Resimler JPG, PNG ve GIF (animasyonlu ve animasyonsuz) olabilir. Örneğin,https://www.agentx.com/logo.png. Zorunlu.

string

Erişilebilirlik için kullanılacak resmin metin açıklaması, ör. Ekran okuyucular. Zorunlu.

integer

Resmin piksel cinsinden yüksekliği. İsteğe bağlı.

integer

Resmin piksel cinsinden genişliği. İsteğe bağlı.

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

string

Bağlantının adı

object (OpenUrl)

Kullanıcı bağlantıyı açtığında ne olur?

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

string

Şunlardan herhangi biri olabilecek URL alanı: - Uygulamaya bağlı bir uygulamayı veya web sayfasını açmak için http/https urls

enum (UrlHint)

URL türüyle ilgili bir ipucunu gösterir.

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

string

Tablonun genel başlığı. İsteğe bağlıdır ancak alt başlık ayarlanmışsa ayarlanmalıdır.

string

Tablonun alt başlığı. İsteğe bağlı.

object (Image)

Tabloyla ilişkilendirilen resim. İsteğe bağlı.

object (TableColumn)

Başlıklar ve sütunların hizalaması.

object (TableRow)

Tablonun satır verileri. İlk 3 satırın gösterileceği garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzeyde hangi satırların gösterileceğini görmek için lütfen simülasyon aracıyla test edin. WEB_BROWSER özelliğini destekleyen yüzeylerde, kullanıcıyı daha fazla veri içeren bir web sayfasına yönlendirebilirsiniz.

object (Link)

Düğme.

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

string

Sütunun başlık metni.

enum (HorizontalAlignment)

İçerik sütunuyla yatay hizalama. Belirtilmemişse içerik ön kenarla hizalanır.

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

object (TableCell)

Bu satırdaki hücreler. İlk 3 hücrenin gösterileceği 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ülasyon aracıyla test yapın.

boolean

Her satırdan sonra bir ayırıcı olması gerekip gerekmediğini belirtir.

{
  "text": string
}

string

Hücrenin metin içeriği.

{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ]
}

enum (MediaType)

Medya türü.

string (Duration format)

İlk medya nesnesinin başlangıç ofseti.

En fazla dokuz kesirli basamağa sahip, "s" ile sonlandırılmış, saniye cinsinden süre. Örnek: "3.5s".

enum (OptionalMediaControls)

Bu medya yanıtı oturumunun destekleyebileceği isteğe bağlı medya kontrolü türleri. Ayarlanırsa belirli bir medya etkinliği gerçekleştiğinde 3. tarafa istek gönderilir. Ayarlanmazsa 3p yine de TAMAMLANDI ve BAŞARISIZ olmak üzere iki varsayılan kontrol türünü işlemelidir.

object (MediaObject)

Medya Nesneleri Listesi

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

string

Bu medya nesnesinin adı.

string

Bu medya nesnesinin açıklaması.

string

Medya içeriğini gösteren URL.

object (MediaImage)

Medya kartıyla gösterilecek resim.

{

  // 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.
}

object (Image)

Albümün kapağı gibi büyük bir resim.

object (Image)

Başlığın sağında küçük bir resim simgesi görüntülenir. 36x36 dp olarak yeniden boyutlandırıldı.

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

string

Koleksiyonun başlığı. İsteğe bağlı.

string

Koleksiyonun alt başlığı. İsteğe bağlı.

object (CollectionItem)

minimum: 2 maks: 10

enum (ImageFill)

Koleksiyon öğelerinin resim arka planlarının nasıl doldurulacağı. İsteğe bağlı.

{
  "key": string
}

string

Zorunlu. İlişkili Türdeki giriş anahtarı adıyla eşleşen NLU anahtarı.

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

string

Listenin başlığı. İsteğe bağlı.

string

Listenin alt başlığı. İsteğe bağlı.

object (ListItem)

minimum: 2 maks: 30

{
  "key": string
}

string

Zorunlu. İlişkili Türdeki giriş anahtarı adıyla eşleşen NLU anahtarı.

{
  "title": string
}

string

Zorunlu. Öneri çipinde gösterilen metin. Bu metin dokunulduğunda, kullanıcı yazmış gibi görüşmede olduğu gibi yayınlanır. Her başlık, öneri çipi grubu içinde benzersiz olmalıdır. Maksimum 25 karakter

{
  "actionsBuilderEvents": [
    {
      object (ExecutionEvent)
    }
  ]
}

object (ExecutionEvent)

Actions Builder etkileşim modelinin aşamalarında görüşme turunun işlenmesiyle ilgili ayrıntıları içeren etkinliklerin listesi. Actions Builder ve Yalnızca Actions SDK uygulamaları.

{
  "eventTime": string,
  "executionState": {
    object (ExecutionState)
  },
  "status": {
    object (Status)
  },
  "warningMessages": [
    string
  ],

  // Union field EventData can be only one of the following:
  "userInput": {
    object (UserConversationInput)
  },
  "intentMatch": {
    object (IntentMatch)
  },
  "conditionsEvaluated": {
    object (ConditionsEvaluated)
  },
  "onSceneEnter": {
    object (OnSceneEnter)
  },
  "webhookRequest": {
    object (WebhookRequest)
  },
  "webhookResponse": {
    object (WebhookResponse)
  },
  "webhookInitiatedTransition": {
    object (WebhookInitiatedTransition)
  },
  "slotMatch": {
    object (SlotMatch)
  },
  "slotRequested": {
    object (SlotRequested)
  },
  "slotValidated": {
    object (SlotValidated)
  },
  "formFilled": {
    object (FormFilled)
  },
  "waitingUserInput": {
    object (WaitingForUserInput)
  },
  "endConversation": {
    object (EndConversation)
  }
  // End of list of possible types for union field EventData.
}

string (Timestamp format)

Etkinliğin gerçekleştiği zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

object (ExecutionState)

Bu etkinlik sırasındaki yürütme durumu.

object (Status)

Belirli bir yürütme adımının sonuç durumu.

string

Bu Etkinliğin yürütülmesi sırasında oluşturulan uyarıların listesi. Uyarılar, geliştiriciye görüşme isteği sırasında keşfedilen ipuçlarıdır. Bunlar genellikle kritik değildir ve isteğin yürütülmesini durdurmaz. Örneğin, webhook mevcut olmayan bir özel türü geçersiz kılmaya çalıştığında uyarı oluşturulabilir. Hatalar, başarısız durum kodu olarak raporlanır ancak durum normal olsa bile uyarı gösterilebilir.

object (UserConversationInput)

Kullanıcı girişi işleme etkinliği.

object (IntentMatch)

Intent eşleştirme etkinliği.

object (ConditionsEvaluated)

Durum değerlendirme etkinliği.

object (OnSceneEnter)

OnSceneEnter yürütme etkinliği.

object (WebhookRequest)

Webhook isteği gönderme etkinliği.

object (WebhookResponse)

Webhook yanıt makbuzu etkinliği.

object (WebhookInitiatedTransition)

Webhook tarafından başlatılan geçiş etkinliği.

object (SlotMatch)

Alan eşleştirme etkinliği.

object (SlotRequested)

Alan isteğinde bulunan etkinlik.

object (SlotValidated)

Alan doğrulama etkinliği.

object (FormFilled)

Form doldurma etkinliği.

object (WaitingForUserInput)

Kullanıcı girişi bekleniyor.

object (EndConversation)

Görüşme sonu etkinliği.

{
  "currentSceneId": string,
  "sessionStorage": {
    object
  },
  "slots": {
    object (Slots)
  },
  "promptQueue": [
    {
      object (Prompt)
    }
  ],
  "userStorage": {
    object
  },
  "householdStorage": {
    object
  }
}

string

Şu anda etkin olan sahnenin kimliği.

object (Struct format)

Oturum depolama alanının durumu: https://developers.google.com/assistant/conversational/storage-session

object (Slots)

Alanlar doldurulduğunda durum (varsa): https://developers.google.com/assistant/conversational/scenes#slot_filling

object (Prompt)

İstem sırası: https://developers.google.com/assistant/conversational/prompts

object (Struct format)

Kullanıcı depolama alanının durumu: https://developers.google.com/assistant/conversational/storage-user

object (Struct format)

Ev depolama alanının durumu: https://developers.google.com/assistant/conversational/storage-home

{
  "status": enum (SlotFillingStatus),
  "slots": {
    string: {
      object (Slot)
    },
    ...
  }
}

enum (SlotFillingStatus)

Boşluk doldurma işleminin mevcut durumu.

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

Geçerli sahneyle ilişkilendirilen alanlar.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

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

enum (SlotMode)

Alan modu (zorunlu veya isteğe bağlı). Geliştirici tarafından ayarlanabilir.

enum (SlotStatus)

Zaman aralığının durumu.

value (Value format)

Alanın değeri. Yanıtta bu değerin değiştirilmesi, alan doldurmadaki değeri değiştirir.

boolean

Slot değerinin son dönüşte toplanıp toplanmadığını gösterir. Bu alan salt okunurdur.

object (Prompt)

İsteğe bağlı. Bu istem, gerekli bir alanı doldurması gerektiğinde kullanıcıya gönderilir. Bu istem, konsolda tanımlanmış mevcut istemi geçersiz kılar. Bu alan webhook isteğine dahil değildir.

{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}

integer

google.rpc.Code olması gereken durum kodu.

string

Geliştiricilere yönelik, İngilizce olması gereken bir hata mesajı. Kullanıcılara yönelik tüm hata mesajları yerelleştirilip google.rpc.Status.details alanında gönderilmeli veya istemci tarafından yerelleştirilmelidir.

object

Hata ayrıntılarını içeren mesajların listesi. API'lerin kullandığı bir dizi mesaj türü vardır.

Rastgele türden alanlar içeren nesne. Ek bir "@type" alanı, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

{
  "type": string,
  "originalQuery": string
}

string

Kullanıcı girişinin türü. Ör. klavye, ses, dokunma vb.

string

Kullanıcının orijinal metin girişi.

{
  "intentId": string,
  "intentParameters": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "handler": string,
  "nextSceneId": string
}

string

Bu etkileşimi tetikleyen amaç kimliği.

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

Bu etkileşimi tetikleyen intent parametreleri.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

string

Bu etkileşime ekli işleyicinin adı.

string

Bu etkileşimin yönlendirdiği sahne.

{
  "failedConditions": [
    {
      object (Condition)
    }
  ],
  "successCondition": {
    object (Condition)
  }
}

object (Condition)

"Yanlış" olarak değerlendirilen koşulların listesi.

object (Condition)

Varsa "doğru" olarak değerlendirilen ilk koşul.

{
  "expression": string,
  "handler": string,
  "nextSceneId": string
}

string

Bu koşulda ifade belirtildi.

string

Değerlendirilen koşulda belirtilen işleyici adı.

string

Değerlendirilen koşulda belirtilen hedef sahne.

{
  "handler": string
}

string

onSceneEnter etkinliğinde belirtilen işleyici adı.

{
  "requestJson": string
}

string

Webhook isteğinin yükü.

{
  "responseJson": string
}

string

Webhook yanıtının yükü.

{
  "nextSceneId": string
}

string

Geçişin yönlendirdiği sahnenin kimliği.

{
  "nluParameters": {
    string: {
      object (IntentParameterValue)
    },
    ...
  }
}

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

NLU tarafından kullanıcı girişinden ayıklanan parametreler.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

{
  "slot": string,
  "prompt": {
    object (Prompt)
  }
}

string

İstenen zaman aralığının adı.

object (Prompt)

Alan istemi.