Google Chat arayüzleri oluşturma

Bu sayfada, Google Chat'i genişleten Google Workspace eklentileri için kullanıcı arayüzleri (UI) oluşturma hakkında genel bilgiler verilmektedir.

Chat uygulamaları için arayüz oluşturmak üzere aşağıdaki eklenti bileşenlerini kullanırsınız:

  • Tetikleyiciler: Google Chat kullanıcılarının bir Chat uygulamasını çağırmak için kullanabileceği yöntemler (ör. uygulamayı bir alana ekleme veya uygulamaya mesaj gönderme).
  • Etkinlik nesneleri: Chat uygulamalarının tetikleyicilerden veya kullanıcı arayüzü etkileşimlerinden aldığı veriler.
  • İşlemler: Sohbet uygulamalarının etkileşimlere yanıt verebileceği yöntemler (ör. mesaj gönderme veya kart tabanlı bir kullanıcı arayüzü döndürme).
Chat uygulaması, "Alana eklendi" tetikleyicisinden bir etkinlik nesnesi alır.
Şekil 1: Kullanıcı bir alana Chat uygulaması eklediğinde Alana eklendi tetikleyicisi etkinleşir ve bir etkinlik nesnesi gönderir. Mesajla yanıt vermek için Chat uygulaması etkinlik nesnesini işler ve mesajı oluşturan bir işlem döndürür.

Chat uygulamaları, aşağıdaki arayüzlerde kart oluşturup gösterebilir:

  • Metin, statik veya etkileşimli kartlar ve düğmeler içerebilen mesajlar.
  • Yeni bir pencerede açılan ve genellikle kullanıcılardan bilgi göndermelerini isteyen kartlar olan iletişim kutuları.
  • Harici bir hizmetle ilgili bilgileri önizleyen kartlar olan bağlantı önizlemeleri.

Tetikleyiciler

Bu bölümde, Google Workspace eklentilerinin Chat'te kullandığı tetikleyiciler açıklanmaktadır.

Tetikleyiciler, kullanıcıların Chat kullanıcı arayüzünü kullanarak Chat uygulamasını çağırmasının belirli yollarıdır. Örneğin, @bahsetme veya uygulama komutlarını kullanma.

Aşağıdaki tabloda Chat tetikleyicileri, açıklamaları ve Chat uygulamalarının genellikle nasıl yanıt verdiği gösterilmektedir:

Tetikleyici Açıklama Normal yanıt
Alana eklendi

Bir kullanıcı, Chat uygulamasını bir alana ekler veya bir Google Workspace yöneticisi, kuruluşundaki kullanıcılar için doğrudan mesaj alanlarına Chat uygulamasını yükler. Yöneticiler tarafından yüklenen Chat uygulamaları hakkında bilgi edinmek için Google Workspace Yönetici Yardım dokümanlarındaki Marketplace uygulamalarını alanınıza yükleme başlıklı makaleyi inceleyin.

 Chat uygulaması, ne işe yaradığını ve alandaki kullanıcıların uygulamayla nasıl etkileşimde bulunabileceğini açıklayan bir karşılama mesajı gönderir.
Mesaj

Bir kullanıcı, Chat uygulamasıyla aşağıdaki yöntemlerden biriyle etkileşim kurar:

  • Chat uygulamasıyla doğrudan mesaj (DM) alanında mesaj gönderir.
  • Herhangi bir alanda Chat uygulamasından @bahsedilmesi
  • Bağlantı önizlemeleri için URL kalıbıyla eşleşen bir bağlantı içeren mesaj gönderir.
  • Bir selectionInput widget'ının çoklu seçim menüsüne metin yazma.
 Chat uygulaması, mesajın içeriğine göre yanıt verir. Örneğin, bir Chat uygulaması, eğik çizgi komutu /about ile Chat uygulamasının yapabileceği görevleri açıklayan bir mesajla yanıt verir.
Alandan kaldırıldı

Bir kullanıcı, Chat uygulamasını bir alandan kaldırdığında veya bir Google Workspace yöneticisi, kuruluşundaki bir kullanıcı için Chat uygulamasını kaldırdığında.

Kullanıcılar, yöneticileri tarafından yüklenen Chat uygulamalarını kaldıramaz. Kullanıcı daha önce Chat uygulamasını yüklediyse Google Workspace yöneticisi kaldırmaya çalışsa bile Chat uygulaması yüklü kalır.

 Chat uygulaması, alan için yapılandırılmış tüm gelen bildirimleri (ör. webhook'u silme) kaldırır ve dahili depolama birimini temizler. Chat uygulamaları, artık alanın üyesi olmadıkları için bu tetikleyiciye mesajlarla yanıt veremez.
Uygulama komutu

Kullanıcı bir Chat uygulaması komutu kullanır.

 Chat uygulaması komuta yanıt verir. Örneğin, ileti içeren yanıtlar veya iletişim kutusu açma.

Diğer Google Workspace eklentilerinin aksine, bu tetikleyiciler için geri çağırma işlevlerini Google Chat API'sini kullanarak yapılandırmanız gerekir. Yardım için Google Chat uygulaması yapılandırma başlıklı makaleyi inceleyin.

Bir tetikleyiciye yanıt vermek için aşağıdaki kılavuzlara bakın:

Etkinlik nesneleri

Chat uygulamaları, bir Chat tetikleyicisi tetiklendiğinde veya Chat kullanıcıları Chat uygulamasındaki bir kullanıcı arayüzüyle (ör. bir düğmeyi tıklayarak) etkileşimde bulunduğunda etkinlik nesneleri alır. Etkinlik nesnesi, Chat uygulamasının yanıt vermek veya kullanıcı arayüzünü güncellemek için kullanabileceği etkileşimle ilgili verileri içerir.

Etkinlik nesnelerini işleme hakkında bilgi edinmek için aşağıdaki kılavuzları inceleyin:

Chat ve diğer Google Workspace uygulamalarındaki eklenti etkinlik nesneleri hakkında bilgi edinmek için Etkinlik nesneleri başlıklı makaleyi inceleyin.

Sohbet işlemleri

Bu bölümde, Chat uygulamalarının kullanıcı etkileşimlerine yanıt vermek için eklenti işlemlerini nasıl kullanabileceği açıklanmaktadır.

Eklenti işlemiyle yanıt vermek için bir sohbet uygulamasının 30 saniye içinde yanıt vermesi ve yanıtın, etkileşimin gerçekleştiği alanda yayınlanması gerekir. Aksi takdirde, Chat uygulamasının kimlik doğrulamayı ayarlaması ve yanıt vermek için Google Chat API'yi çağırması gerekir.

Sohbet uygulamaları, etkileşimleri birçok şekilde işleyip yanıtlayabilir. Çoğu durumda, Chat uygulamaları mesajla yanıt verir. Sohbet uygulamaları, bir veri kaynağından bazı bilgileri arayabilir, etkinlik nesnesi bilgilerini kaydedebilir veya başka herhangi bir işlemi yapabilir. Bu işleme davranışı, Google Chat uygulamasını tanımlayan temel özelliktir.

Chat uygulamalarının kullanıcı etkileşimlerine yanıt verebilmesi için ilgili etkinlik nesnesini işlemesi ve aşağıdaki JSON nesnelerinden birini döndürmesi gerekir:

Chat uygulaması yanıtı İade için gerekli işlem
Mesaj gönderme veya güncelleme DataActions
İletişim kutusunu açma, güncelleme veya kapatma RenderActions
Bir karttan veya iletişim kutusundan bilgi toplamak için kullanıcıların çoklu seçim menüsüne yazdıklarına göre seçim öğeleri önerin. RenderActions
Chat kullanıcılarının bir alanda gönderdiği mesajlardaki bağlantı önizlemeleri. DataActions

Google Chat API'yi kullanarak yanıt verme

Eklenti işlemi döndürmek yerine, Chat uygulamalarının etkileşime yanıt vermek için Google Chat API'sini kullanması gerekebilir. Örneğin, Chat uygulamalarının aşağıdakilerden herhangi birini yapabilmesi için Google Chat API'yi çağırması gerekir:

  • 30 saniye sonra bir etkileşime yanıt verme
  • Etkileşimin gerçekleştiği alanın dışında görevler gerçekleştirme
  • Chat'te, eklenti işlemleri olarak kullanılamayan görevleri gerçekleştirme Örneğin, bir kullanıcının veya Chat uygulamasının üyesi olduğu alanları listeleyebilir ya da alana kullanıcı ekleyebilirsiniz.
  • Sohbet kullanıcısı adına görev gerçekleştirme (kullanıcı kimlik doğrulaması gerektirir).

Chat API'nin kimliğini doğrulama ve Chat API'yi çağırma hakkında bilgi edinmek için Chat API'ye genel bakış başlıklı makaleyi inceleyin.