Kullanıcının bir Chat uygulamasıyla etkileşimini temsil eden ve bu etkileşimle ilgili verileri içeren bir Google Chat uygulaması etkileşim etkinliği. Chat uygulamanızı etkileşim etkinliklerini 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 ( |
Alanlar | |
---|---|
type |
Kullanıcının Chat uygulamasıyla kurduğu etkileşimin türü (ör. |
eventTime |
Etkileşim etkinliğinin ne zaman gerçekleştiğini gösteren zaman damgası. |
token |
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 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 |
Etkileşim etkinliğiyle ilgili mesaj dizisi için Chat uygulaması tanımlı anahtar. Daha fazla bilgi için bkz. |
message |
|
user |
Chat uygulamasıyla etkileşimde bulunan kullanıcı. |
space |
Kullanıcının Chat uygulamasıyla etkileşim kurduğu alan. |
action |
|
configCompleteRedirectUrl |
|
isDialogEvent |
|
dialogEventType |
Alınan iletişim kutusu etkileşim etkinliğinin türü. |
common |
Kullanıcının istemcisiyle ilgili yerel ayar, ana makine uygulaması ve platform gibi bilgileri temsil eder. |
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 ( |
Alanlar | |
---|---|
userLocale |
[ISO 639 dil kodu]-[ISO 3166 ülke/bölge kodu] biçimindeki tam |
hostApp |
Eklentinin çağrıldığı uygulamayı gösteren HostApp sıralaması. Chat uygulamaları için her zaman |
platform |
Etkinliğin gerçekleştiği platformu belirten platform sıralaması ( |
timeZone |
Saat dilimi kimliği ve Eşgüdümlü Evrensel Saat'e (UTC) göre uzaklık. Yalnızca |
formInputs |
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 |
Çağrılan işleve iletilen özel parametreler. Hem anahtarlar hem de değerler dize olmalıdır. |
invokedFunction |
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 |
IANA TZ saat dilimi veritabanı kodu (ör. "Amerika/Toronto"). |
offset |
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 |
Alanlar | |
---|---|
Birleştirme alanı
|
|
stringInputs |
Kullanıcının bir widget'a girdiği değerleri temsil eden dizelerin listesi. Widget, |
dateTimeInput |
Hem tarih hem de saati kabul eden bir |
dateInput |
Yalnızca tarih değerlerini kabul eden bir |
timeInput |
Yalnızca zaman değerlerini kabul eden bir |
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[] |
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 |
Sıfırdan bu yana geçen süre (milisaniye cinsinden). |
hasDate |
|
hasTime |
|
DateInput
Tarih giriş değerleri.
JSON gösterimi |
---|
{ "msSinceEpoch": string } |
Alanlar | |
---|---|
msSinceEpoch |
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 |
24 saatlik biçimde saat. |
minutes |
Bir saati geçen dakika sayısı. Geçerli değerler 0 ile 59 arasındadır. |