Event

Kullanıcının Chat uygulamasıyla etkileşimini temsil eden ve içeren bir Google Chat uygulaması etkileşim etkinliği. Chat uygulamanızı, etkileşim etkinlikleri alacak şekilde yapılandırmak için Kullanıcı etkileşimlerini alma ve yanıtlama başlıklı makaleyi inceleyin.

Chat uygulamaları, kullanıcı etkileşimlerinden gelen etkinlikleri almanın yanı sıra alanlarda yapılan değişikliklerle (ör. alana yeni bir üye eklenmesi) ilgili etkinlikleri de alabilir. Alan etkinlikleri hakkında bilgi edinmek için Google Chat'teki etkinliklerle çalışma başlıklı makaleyi inceleyin.

JSON gösterimi 
{
  "type": enum (EventType),
  "eventTime": string,
  "token": string,
  "threadKey": string,
  "message": {
    object (Message)
  },
  "user": {
    object (User)
  },
  "space": {
    object (Space)
  },
  "action": {
    object (FormAction)
  },
  "configCompleteRedirectUrl": string,
  "isDialogEvent": boolean,
  "dialogEventType": enum (DialogEventType),
  "common": {
    object (CommonEventObject)
  }
}
Alanlar
type

enum (EventType)

Kullanıcının Chat uygulamasıyla kurduğu etkileşimin türü (ör. MESSAGE veya ADDED_TO_SPACE).
eventTime

string (Timestamp format)

Etkileşim etkinliğinin ne zaman gerçekleştiğini gösteren zaman damgası.
token

string

Eski Chat uygulamalarının, bir isteğin Google'dan gelip gelmediğini doğrulamak için kullanabileceği gizli bir değerdir. Google, jetonu rastgele oluşturur ve jetonun değeri sabit kalır. Jetonu Google Cloud Console'daki Chat API yapılandırma sayfasından alabilir, iptal edebilir veya yeniden oluşturabilirsiniz.

Modern Chat uygulamaları bu alanı kullanmaz. API yanıtlarında ve Chat API yapılandırma sayfasında yoktur.
threadKey

string

Etkileşim etkinliğiyle ilgili mesaj dizisi için Chat uygulaması tanımlı anahtar. Daha fazla bilgi için bkz. spaces.messages.thread.threadKey.
message

object (Message)

Etkileşim etkinliğini tetikleyen mesaj (varsa).
user

object (User)

Chat uygulamasıyla etkileşimde bulunan kullanıcı.
space

object (Space)

Kullanıcının Chat uygulamasıyla etkileşim kurduğu alan.
action

object (FormAction)

CARD_CLICKED etkileşim etkinlikleri için kullanıcı bir kartı veya iletişim kutusunu tıkladığında ilişkilendirilen form işlemi verileri. Daha fazla bilgi edinmek için Kartlara kullanıcıların girdiği form verilerini okuma bölümüne bakın.
configCompleteRedirectUrl

string

Kullanıcı Google Chat dışında bir yetkilendirme veya yapılandırma akışını tamamladıktan sonra Chat uygulamasının kullanıcıyı yönlendirmesi gereken URL. Daha fazla bilgi için Chat uygulamasını diğer hizmetlere ve araçlara bağlama başlıklı makaleyi inceleyin.
isDialogEvent

boolean

CARD_CLICKED ve MESSAGE etkileşim etkinlikleri için, kullanıcının bir iletişim kutusu ile mi yoksa etkileşime geçmek üzere mi olduğu.
dialogEventType

enum (DialogEventType)

Alınan iletişim kutusu etkileşim etkinliğinin türü.
common

object (CommonEventObject)

Kullanıcının istemcisiyle ilgili yerel ayar, ana makine uygulaması ve platform gibi bilgileri temsil eder. CommonEventObject, Chat uygulamalarında iletişim kutularıyla etkileşimde bulunan kullanıcıların gönderdiği bilgileri (ör. bir karta girilen veriler) içerir.

CommonEventObject

Kullanıcının istemcisiyle ilgili yerel ayar, ana makine uygulaması ve platform gibi bilgileri temsil eder. CommonEventObject, Chat uygulamalarında, kartlarla etkileşimde bulunan kullanıcılar tarafından gönderilen verileri (iletişim kutularına girilen veriler gibi) içerir.

JSON gösterimi 
{
  "userLocale": string,
  "hostApp": enum (HostApp),
  "platform": enum (Platform),
  "timeZone": {
    object (TimeZone)
  },
  "formInputs": {
    string: {
      object (Inputs)
    },
    ...
  },
  "parameters": {
    string: string,
    ...
  },
  "invokedFunction": string
}
Alanlar
userLocale

string

[ISO 639 dil kodu]-[ISO 3166 ülke/bölge kodu] biçimindeki tam locale.displayName (ör. "en-US").
hostApp

enum (HostApp)

Eklentinin çağrıldığı uygulamayı gösteren HostApp sıralaması. Chat uygulamaları için her zaman CHAT.
platform

enum (Platform)

Etkinliğin gerçekleştiği platformu (WEB, IOS veya ANDROID) belirten platform sıralaması. Chat uygulamaları tarafından desteklenmez.
timeZone

object (TimeZone)

Saat dilimi kimliği ve Eşgüdümlü Evrensel Saat'e (UTC) göre uzaklık. Yalnızca CARD_CLICKED ve SUBMIT_DIALOG etkinlik türleri için desteklenir.
formInputs

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

Kullanıcının bir kart veya iletişim kutusundan widget'a girdiği değerleri içeren harita. Harita anahtarları, her bir widget'a atanan dize kimlikleridir ve değerler, widget'a yapılan girişleri temsil eder.

Ayrıntılar için Kullanıcıların girdiği işlem bilgileri başlıklı makaleyi inceleyin.
parameters

map (key: string, value: string)

Çağrılan işleve iletilen özel parametreler. Hem anahtarlar hem de değerler dize olmalıdır.
invokedFunction

string

Widget ile ilişkilendirilmiş çağrılan işlevin adı. Yalnızca Chat uygulamaları için ayarlanır.

TimeZone

Saat dilimi kimliği ve Eşgüdümlü Evrensel Saat'e (UTC) göre uzaklık. Yalnızca CARD_CLICKED ve SUBMIT_DIALOG etkinlik türleri için desteklenir.

JSON gösterimi 
{
  "id": string,
  "offset": integer
}
Alanlar
id

string

IANA TZ saat dilimi veritabanı kodu (ör. "Amerika/Toronto").
offset

integer

Kullanıcının Eşgüdümlü Evrensel Zaman'a (UTC) göre saat dilimi farkı (milisaniye cinsinden).

Girişler

Kullanıcıların kartlara veya iletişim kutularına girebileceği veri türleri. Giriş türü, widget'ın kabul ettiği değerlerin türüne bağlıdır.

JSON gösterimi 
{

  // Union field inputs can be only one of the following:
  "stringInputs": {
    object (StringInputs)
  },
  "dateTimeInput": {
    object (DateTimeInput)
  },
  "dateInput": {
    object (DateInput)
  },
  "timeInput": {
    object (TimeInput)
  }
  // End of list of possible types for union field inputs.
}
Alanlar

Birleştirme alanı inputs.

inputs şunlardan yalnızca biri olabilir:
stringInputs

object (StringInputs)

Kullanıcının bir widget'a girdiği değerleri temsil eden dizelerin listesi.

Widget, TextInput widget'ı gibi yalnızca tek bir değeri kabul ediyorsa liste bir dize nesnesi içerir. Widget birden fazla değeri kabul ediyorsa (ör. onay kutuları içeren SelectionInput widget'ı) listede, kullanıcının girdiği veya seçtiği her bir değer için bir dize nesnesi bulunur.
dateTimeInput

object (DateTimeInput)

Hem tarih hem de saati kabul eden bir DateTimePicker widget'ından tarih ve saat giriş değerleri.
dateInput

object (DateInput)

Yalnızca tarih değerlerini kabul eden bir DateTimePicker widget'ından alınan tarih giriş değerleri.
timeInput

object (TimeInput)

Yalnızca zaman değerlerini kabul eden bir DateTimePicker widget'ından saat girişi değerleri.

StringInputs

Normal widget'lar için giriş parametresi. Tek değerli widget'lar için tek bir değer listesidir. Onay kutusu gibi birden çok değerli widget'lar için tüm değerler sunulur.

JSON gösterimi 
{
  "value": [
    string
  ]
}
Alanlar
value[]

string

Kullanıcı tarafından girilen dizelerin listesi.

DateTimeInput

Tarih ve saat giriş değerleri.

JSON gösterimi 
{
  "msSinceEpoch": string,
  "hasDate": boolean,
  "hasTime": boolean
}
Alanlar
msSinceEpoch

string (int64 format)

Sıfırdan bu yana geçen süre (milisaniye cinsinden).
hasDate

boolean

datetime girişinin takvim tarihi içerip içermediğini belirtir.
hasTime

boolean

datetime girişinin zaman damgası içerip içermediğini belirtir.

DateInput

Tarih giriş değerleri.

JSON gösterimi 
{
  "msSinceEpoch": string
}
Alanlar
msSinceEpoch

string (int64 format)

Sıfırdan bu yana geçen süre (milisaniye cinsinden).

TimeInput

Saat giriş değerleri.

JSON gösterimi 
{
  "hours": integer,
  "minutes": integer
}
Alanlar
hours

integer

24 saatlik biçimde saat.
minutes

integer

Saatten sonraki dakika sayısı. Geçerli değerler 0 ile 59 arasındadır.