Google Chat'teki etkinliklerle çalışma

Bu sayfada, Google Chat uygulamalarının Google Chat'teki etkinlikleri nasıl alıp yanıtlayabileceği açıklanmaktadır.

Google Chat etkinliği, Chat'teki bir etkinliği veya değişikliği (ör. bir alandaki yeni mesaj) ifade eder. Chat uygulamanız, ne olduğunu anlamak ve kullanıcılarınız için anlamlı bir şekilde işlem yapmak veya yanıt vermek üzere etkinlikleri kullanabilir.

Etkinlikleri nasıl kullanabileceğinize dair bazı örnekler:

  • Bir alandaki yeni mesajları izleme ve yanıtlama (ör. anahtar kelimeleri veya ifadeleri kontrol etme)
  • Alana katılan kullanıcılara hoş geldiniz mesajı göndererek alan kurallarını açıklayın veya Chat uygulamasını etkili bir şekilde kullanmayla ilgili ipuçları paylaşın.
  • Chat etkinliğini izleme ve analiz etme Örneğin, yeni üyeler veya en çok tepki ya da yanıt alan iletiler hakkında aylık rapor göndermek için.
  • Mesajlaşma platformları arasında iletişim kurun. Örneğin, kullanıcılar Chat'ten ayrılmadan farklı bir mesajlaşma platformundaki kullanıcılardan mesaj gönderip alabilir.

Etkinliklerin işleyiş şekli

Google Chat'te bir işlem yapıldığında Google Chat API kaynağı oluşturulur, güncellenir veya silinir. Chat, etkinlikleri kullanarak Chat uygulamanıza gerçekleşen etkinlik türü ve etkilenen Chat API kaynağı hakkında bilgi verir.

Google Chat alanında yayınlanan bir mesajın nasıl etkinlik tetiklediğiyle ilgili örnek.
1. şekil. Bir kullanıcı Chat alanında mesaj yayınladığında Message kaynağı oluşturulur. Ardından Chat, yeni mesajla ilgili verileri içeren bir etkinlik oluşturur.

Chat, etkinlikleri türe göre kategorize eder. Etkinlik türleri, yalnızca ihtiyacınız olan bilgileri filtrelemenize ve almanıza yardımcı olur. Ayrıca benzer etkinlikleri aynı şekilde yönetmenizi sağlar.

Aşağıdaki tabloda, Chat'teki bir etkinliğin ilgili Chat API kaynağını nasıl etkilediği ve Chat uygulamanızın aldığı etkinlik türü gösterilmektedir:

Etkinlik Chat API kaynağı Etkinlik türü
Bir kullanıcı Chat alanında mesaj yayınladığında Message kaynağı oluşturulur. Yeni mesaj
Bir kullanıcı alan yöneticisi olduğunda Membership kaynağı güncellendiğinde Üyelik güncellendi
Kullanıcı bir mesaja tepki verir. Reaction kaynağı oluşturulur. Yeni tepki
Bir kullanıcı alandan ayrıldığında Membership kaynağı silindiğinde Silinen üyelik

Google Chat'ten etkinlik alma

Etkinlik almak için Chat uygulamanız aşağıdakilerden birini yapabilir:

  • Etkinlikleri gerçekleşir gerçekleşmez almak için Google Workspace Events API'yi kullanarak etkinliklere abone olun.
  • Chat API'yi çağırarak son etkinlikleri sorgulayın.

Aşağıdaki tabloda, etkinlikleri sorgulama veya etkinliklere abone olma arasındaki fark ve nedenler açıklanmaktadır:

Etkinliklere abone olma Etkinlik sorgulama
Kullanım alanları
  • Etkinlikleri anında işleme veya yanıtlama
  • Kullanıcıların üyelik etkinliklerini izleyin ve izlenecek yeni alanlar keşfedin.
  • Etkinlikleri düzenli olarak veya bir tetikleyici aracılığıyla işleme ya da yanıtlama
  • Abonelikteki kaçırılan etkinlikleri getirme (kesinti veya etkin olmayan abonelik nedeniyle).
API Google Workspace Events API Chat API
Etkinlik kaynağı Alanlar ve kullanıcılar Yalnızca alanlar
Desteklenen etkinlikler
  • Mesajlar
  • Üyelikler
  • Tepkiler
  • Boşluk

Desteklenen etkinlik türlerinin listesi için Google Workspace Events API belgelerindeki Abonelik oluşturmak için etkinlik türleri başlıklı makaleyi inceleyin.
  • Mesajlar
  • Üyelikler
  • Tepkiler
  • Boşluk

Desteklenen etkinlik türlerinin listesi için Chat API referans belgelerindeki spaceEvents kaynağına bakın.
Etkinlik biçimi CloudEvent spesifikasyonuna göre biçimlendirilmiş bir Google Cloud Pub/Sub mesajı. Ayrıntılar için Google Workspace etkinliklerinin yapısı başlıklı makaleyi inceleyin. Chat API kaynağı ( spaces.spaceEvent)
Etkinlik verileri Kaynak verileri içeren veya içermeyen Base64 kodlu dize. Örnek yükler için Etkinlik verileri bölümüne bakın. Kaynak verilerini içeren JSON yükü. Bazı etkinlik türleri yalnızca belirli kaynak alanlarını içerir. Örnek yükler için referans belgelerine bakın.

Örnek: Bir alandaki üyeliklerle ilgili etkinlikleri sorgulama veya bu etkinliklere abone olma

Bu örnekte, bir Chat uygulaması, Chat alanının üyelerinde yapılan değişikliklerle ilgili bilgileri almak istiyor. Alanda aşağıdaki üyelik etkinliği gerçekleşir:

  • Bir kullanıcı alana katıldığında Membership kaynağı oluşturulur ve yeni üye etkinliği tetiklenir.
  • Bir kullanıcı alan yöneticisi olur. Bu durumda, kullanıcı için Membership kaynağı güncellenir ve güncellenmiş bir üye etkinliği tetiklenir.
  • Bir kullanıcı alandan ayrıldığında, kullanıcının Membership kaynağı silinir ve üye silindi etkinliği tetiklenir.

Üyelik etkinliklerine abone olma

Etkinlikleri gerçek zamanlı olarak almak için Chat uygulaması, tüm üyelik etkinliklerine abone olmak üzere Google Workspace Events API'nin subscriptions.create() yöntemini çağırır. Abonelik oluşturulduktan sonra Sohbet uygulaması, üyelik etkinliklerini almaya başlayabilir.

Google Workspace Events API'yi kullanarak etkinliklere abone olan Chat uygulaması.
Şekil 2. Bir Chat uygulaması, Google Workspace Events API'yi kullanarak abonelik üzerinden üyelik etkinlikleri alır.

Şekil 2'de, Chat uygulamasının alana etkin bir aboneliği vardır. Bu nedenle, alandaki üyelik her değiştiğinde uygulama bir etkinlik alır. Chat uygulaması daha sonra, alana katılan üyeye özel bir karşılama mesajı gönderme gibi etkinlikleri gerçek zamanlı olarak işleyebilir veya yanıtlayabilir.

Google Workspace Events API'yi kullanarak abonelik oluşturma hakkında bilgi edinmek için Google Workspace Events API belgelerine bakın.

Son üyelik etkinlikleri için sorgu oluşturma

Üyelik etkinliklerini gerçekleşir gerçekleşmez almak yerine, Chat uygulaması, üyelik etkinliğiyle ilgili son alan etkinliklerini listelemek için Chat API'yi çağırabilir.

Chat API'yi kullanarak etkinlikleri sorgulayan Chat uygulaması.
3.şekil Bir Chat uygulaması, Chat API'yi kullanarak alan etkinliklerini sorgulayarak son üyelik etkinliklerini alır.

Şekil 3'te, bir Chat uygulaması tüm üyelik etkinlikleri gerçekleştikten sonra Chat API'si spaces.spaceEvents.list() yöntemini çağırır ve sorguyu yeni, güncellenmiş ve silinmiş üyelik etkinlikleri için filtreler. Chat API, üyelik değişikliklerinin her birini temsil eden spaceEvent kaynaklarının listesini döndürür. Chat uygulaması daha sonra son etkinliğe göre işlem yapabilir veya yanıt verebilir. Örneğin, son 7 gün içinde alanın üyelik etkinliğinin özetini içeren haftalık bir mesaj yayınlayabilir.

Chat API'yi kullanarak etkinlikleri sorgulamak için Google Chat alanındaki etkinlikleri listeleme başlıklı makaleyi inceleyin.

Sınırlamalar
  • Kullanıcı abonelikleri için, doğrudan mesajlardaki veya adsız grup sohbetlerindeki yeni üyelerle ilgili etkinlikler (google.workspace.chat.membership.v1.created) yalnızca ilk mesaj gönderildikten sonra tetiklenir.
  • Üyelik etkinliklerini almak için kullanıcının alanın doğrudan üyesi olması gerekir. Bir kullanıcı Google Grubu aracılığıyla alana dolaylı olarak eklendiyse, güncellendiyse veya kaldırıldıysa abonelik bu üyelik etkinliklerini almaz. Google Grubu üyeliklerinin nasıl çalıştığını anlamak için Alana Google Grubu ekleme başlıklı makaleyi inceleyin.