Event

Google Chat uygulaması etkileşim etkinliği.

Etkileşim etkinlikleri hakkında bilgi edinmek için Google Chat uygulamanızla etkileşimleri alma ve yanıtlama başlıklı makaleyi inceleyin. Etkinlik türleri ve örneğin etkinlik yükleri hakkında bilgi edinmek için Google Chat uygulaması etkileşim etkinliği türleri başlıklı makaleyi inceleyin.

Chat uygulamaları, kullanıcı etkileşimlerinden etkinlik almanın yanı sıra alanlarda yapılan değişikliklerle ilgili etkinlikler de (ör. alana yeni bir üye eklenmesi) 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)

Etkileşim etkinliğinin türü. Ayrıntılar için Google Chat uygulaması etkileşim etkinliklerinin türleri başlıklı makaleyi inceleyin.

eventTime

string (Timestamp format)

Etkileşim etkinliğinin ne zaman gerçekleştiğini belirten zaman damgası.

token

string

Eski Chat uygulamalarının, 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 edinebilir, 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 spaces.messages.thread.threadKey sayfasını inceleyin.

message

object (Message)

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

user

object (User)

Etkileşim etkinliğini tetikleyen kullanıcı.

space

object (Space)

Etkileşim etkinliğinin gerçekleştiği alan.

action

object (FormAction)

CARD_CLICKED etkileşim etkinlikleri için, kullanıcının bir kartı veya iletişim kutusunu tıklamasıyla ilişkilendirilen form işlemi verileri. Daha fazla bilgi edinmek için Kartlardaki kullanıcıların form verilerini girmesini okuma bölümüne bakın.

configCompleteRedirectUrl

string

Kullanıcı Google Chat dışında bir yetkilendirme veya yapılandırma akışı 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 etkileşim etkinlikleri için, kullanıcının bir iletişim kutusu ile etkileşimde bulunup bulunmadığı.

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. Chat uygulamalarında CommonEventObject, iletişim kutularıyla etkileşimde bulunan kullanıcılar tarafından gönderilen 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. Chat uygulamalarında CommonEventObject, kartlarla etkileşimde bulunan kullanıcılar tarafından gönderilen verileri (ör. iletişim kutularına girilen veriler) 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çiminde, "en-US" gibi tam locale.displayName.

hostApp

enum (HostApp)

Eklentinin çağrıldığı uygulamayı belirten HostApp sıralaması. Chat uygulamaları için her zaman CHAT.

platform

enum (Platform)

Etkinliğin kaynaklandığı platformu belirten platform sıralaması (WEB, IOS veya ANDROID). Chat uygulamaları tarafından desteklenmez.

timeZone

object (TimeZone)

Saat dilimi kimliği ve Eşgüdümlü Evrensel Saat (UTC) ile arasındaki fark. 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. Eşleme anahtarları her bir widget'a atanan dize kimlikleridir. Değerler ise widget'a yapılan girişleri temsil eder.

Ayrıntılar için Kullanıcılar tarafından girilen bilgiler başlıklı makaleye göz atın.

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şkili çağrılan işlevin adı. Yalnızca Chat uygulamaları için ayarlandı.

TimeZone

Saat dilimi kimliği ve Eşgüdümlü Evrensel Saat (UTC) ile arasındaki fark. 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. "America/Toronto").

offset

integer

Kullanıcının Eşgüdümlü Evrensel Zaman'dan (UTC) olan saat dilimi farkı (milisaniye).

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'ta girdiği değerleri temsil eden dize listesi.

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

dateTimeInput

object (DateTimeInput)

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

dateInput

object (DateInput)

Yalnızca tarih değerlerini kabul eden bir DateTimePicker widget'ındaki tarih girişi değerleri.

timeInput

object (TimeInput)

Yalnızca zaman değerlerini kabul eden bir DateTimePicker widget'ındaki zaman 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)

Dönemden beri geçen süre (milisaniye).

hasDate

boolean

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

hasTime

boolean

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

DateInput

Tarih giriş değerleri.

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

string (int64 format)

Dönemden beri geçen süre (milisaniye).

TimeInput

Zaman giriş değerleri.

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

integer

24 saatlik biçimde saat.

minutes

integer

Saatin geçtiği dakika sayısı. Geçerli değerler 0 ile 59 arasındadır.