Method: projects.sendInteraction

string

Zorunlu. Proje Kimliği ile belirtilen, test edilmekte olan proje. Biçim: projeler/{project}

{
  "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)

İşlemle 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) adresine bakın.)

string

Cihazda ayarlandığı şekliyle 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] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] iznini gerektirir.

string

Görünen adres, ör. "Talatpaşa Bulvarı No.: 22, İstanbul, 34111". [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] iznini gerektirir.

string

Posta kodu. [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] iznini gerektirir.

string

Şehir. [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] iznini gerektirir.

{
  "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 Canvas 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 tuval web uygulamasının URL'si. Ayarlanmazsa mevcut etkin tuvaldeki URL yeniden kullanılır.

value (Value format)

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

boolean

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

boolean

true ise tuval uygulaması tüm ekranı kaplar ve en üstte bir başlık gösterilmez. Yükleme ekranında işlemin görünen adını, geliştiricinin adını ve İşlemden çıkışla ilgili talimatları içeren bir kısa mesaj da gösterilir. 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 mesajların önceden tanımlanmış iletilerle nasıl birleştirileceğini belirleyen mod. "false", önceden tanımlanmış tüm iletileri (ilk ve son basit, içerik, öneriler bağlantısı ve tuval) temizler ve bu istemde tanımlanan iletileri ekler. "true", bu istemde tanımlanan mesajları önceki yanıtlarda tanımlanan iletilere ekler. Bu alanın "true" (doğru) değerine ayarlanması, Basit istemler, Öneri istemi ve Kanvas istemi (İçerik isteminin bir bölümü) içindeki bazı alanlara da eklenmesini sağlar. İ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.

boolean

İsteğe bağlı. Bu mesajların önceden tanımlanmış iletilerle nasıl birleştirileceğini belirleyen mod. "true", önceden tanımlanmış tüm iletileri (ilk ve son basit, içerik, öneriler bağlantısı ve tuval) temizler ve bu istemde tanımlanan iletileri ekler. "false", bu istemde tanımlanan iletileri önceki yanıtlarda tanımlanan iletilere ekler. Bu alanın "false" olarak bırakılması, Basit istemler, Öneriler istemi ve Tuval istemi (İçerik isteminin bir bölümü) içindeki bazı alanlara da eklenmesine olanak tanır. İ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.

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ı. Sesli ve yalnızca metin içeren son yanıt.

object (Suggestion)

İsteğe bağlı. Öneriler her zaman yanıtın sonunda görünür ve kullanıcıya gösterilir. İçeren istemdeki "geçersiz kıl" alanı "false" (yanlış) 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.

object (Link)

İsteğe bağlı. İlişkilendirilmiş uygulamaya veya siteye bağlantı verebilen ek bir öneri çipi. Çip, "Aç " başlığıyla oluşturulur. En fazla 20 karakter kullanılabilir.

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 konuşulacak konuşmayı temsil eder. SSML veya metin okuma olabilir. İçeren istemdeki "geçersiz kıl" alanı "true" (doğru) değerine sahipse bu alanda tanımlanan konuşma, önceki Basit istemin konuşmasının yerini alır.

string

Sohbet balonunda gösterilecek isteğe bağlı 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 "geçersiz kıl" alanı "true" (doğru) değerine sahipse 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 bir kart.

object (Image)

Bir resim.

object (Table)

Tablo kartı.

object (Media)

Oynatılacak medya grubunu belirten yanıt.

object (Canvas)

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

object (Collection)

Aralarından seçim yapabileceğiniz bir dizi seçenek sunan kart.

object (List)

Aralarından seçim yapabileceğiniz seçeneklerin listesini gösteren 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 dizimini destekler. Resim yoksa gereklidir.

object (Image)

Kartın lokomotif resmi. Yükseklik 192 dp'ye sabitlenir. İ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)

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

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

string

Şunlardan herhangi biri olabilecek URL alanı: - Uygulamayla Bağlantılı Uygulama veya web sayfası açmak için http/https URL'leri

enum (UrlHint)

URL türüyle ilgili bir ipucu 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 altyazı 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ö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.

object (Link)

Düğme.

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

string

Sütunun başlık metni.

enum (HorizontalAlignment)

İçeriğin sütunla yatay hizalaması. Belirtilmemişse içerik ön kenara hizalanır.

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

object (TableCell)

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.

boolean

Her satırdan sonra ayırıcı olup olmadığını gösterir.

{
  "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 kesir basamağı içeren ve "s" ile sonlandırılan saniye cinsinden bir süre. Örnek: "3.5s".

enum (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.

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 işaret eden URL.

object (MediaImage)

Medya kartıyla birlikte 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ğı vb. büyük bir resim.

object (Image)

Başlığın sağında gösterilen küçük resim simgesi. 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)

min: 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ür'deki 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)

min: 2 maks.: 30

{
  "key": string
}

string

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

{
  "title": string
}

string

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

{
  "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. Yalnızca Actions Builder & Actions SDK'sı uygulamaları için doldurulur.

{
  "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ı.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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, görüşme isteği sırasında keşfedilen geliştiriciye yönelik 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ılar gösterilebilir.

object (UserConversationInput)

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

object (IntentMatch)

Amaç 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)

Slot eşleştirme etkinliği.

object (SlotRequested)

Etkinlik isteyen alan.

object (SlotValidated)

Slot doğrulama etkinliği.

object (FormFilled)

Form doldurma etkinliği.

object (WaitingForUserInput)

User-input etkinliğ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)

Varsa alanların doldurulma durumu: 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)

Slot doldurmanın 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)

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

enum (SlotStatus)

Alanın durumu.

value (Value format)

Alanın değeri. Yanıtta bu değer değiştirildiğinde, slot doldurma değeri de değişir.

boolean

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

object (Prompt)

İsteğe bağlı. Gerekli bir alanı doldurması gerektiğinde bu istem kullanıcıya gönderilir. Bu istem, konsolda tanımlanan 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 değerinin enum değeri olması gereken durum kodu.

string

Geliştiricinin karşılaştığı İngilizce 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 kullanabileceği yaygın bir dizi mesaj türü vardır.

Rastgele türde alanlar içeren bir nesne. "@type" adlı ek 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 amaç 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 götürdüğü 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 işleyici adı belirtildi.

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 gittiği sahnenin kimliği.

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

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

Kullanıcı girişinden NLU tarafından çıkarılan parametreler.

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

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

string

İstenen alanın adı.

object (Prompt)

Slot istemi.