Google Chat'teki etkinliklerle çalışma

Bu sayfada, Google Chat uygulamalarının Google Chat'teki etkinlikleri nasıl alabileceği ve bunlara nasıl yanıt verebileceği açıklanmaktadır.

Google Chat etkinliği, Chat'te bir etkinliği veya değişikliği (ör. alandaki yeni bir mesaj) temsil eder. Chat uygulamanız, neler olduğunu anlamak ve işlem yapmak ya da kullanıcılarınıza anlamlı bir şekilde yanıt vermek için etkinlikleri kullanabilir.

Etkinlikleri nasıl kullanabileceğinize dair bazı örnekleri aşağıda bulabilirsiniz:

  • Alandaki yeni mesajları izleyip yanıtlayın (ör. anahtar kelimeleri veya kelime öbeklerini kontrol edin).
  • Alana katılan kullanıcılara alan kurallarını açıklamak veya Chat uygulamasını etkili bir şekilde kullanmayla ilgili ipuçları paylaşmak için karşılama mesajı gönderin.
  • Chat etkinliğini izleyip analiz edin. Örneğin, yeni üyeler veya en çok tepki ya da yanıt alan mesajlar 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ılara mesaj gönderebilir ve bu kullanıcılardan mesaj alabilir.

Etkinliklerin işleyiş şekli

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

Google Chat alanına gönderilen bir mesajın etkinliği nasıl tetiklediğini gösteren örnek.
Şekil 1. Kullanıcı bir Chat alanında mesaj yayınladığında Message kaynağı oluşturulur. Ardından sohbet, yeni mesajla ilgili verileri içeren bir etkinlik oluşturur.

Chat, etkinlikleri türüne göre kategorilere ayırır. Etkinlik türleri, yalnızca ihtiyacınız olan bilgi türünü filtrelemenize ve almanıza yardımcı olur ve benzer etkinlikleri aynı şekilde işlemenize olanak tanır.

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ü
Kullanıcı Chat alanında mesaj yayınladığında Bir Message kaynağı oluşturulur. Yeni mesaj
Bir kullanıcı alan yöneticisi olur. Bir Membership kaynağı güncellenir. Güncellenen üyelik
Kullanıcı bir mesaja tepki verir. Bir Reaction kaynağı oluşturulur. Yeni tepki
Bir kullanıcı alandan ayrıldığında Bir Membership kaynağı silinir. Silinen üyelik

Google Chat'ten etkinlik alma

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

  • Etkinlikleri gerçekleştikçe 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 sorgulamak veya etkinliklere abone olmak arasındaki fark ve nedenler açıklanmaktadır:

Etkinliklere abone olma Etkinlik sorgusu
Kullanım alanları
  • Etkinlikleri gerçek zamanlı olarak işleyin veya yanıtlayın.
  • Kullanıcıların üyelik etkinliklerini izleyin ve izleyebileceğiniz yeni alanları keşfedin.
  • Etkinlikleri düzenli olarak veya bir tetikleyici aracılığıyla işleme veya yanıtlama.
  • Kesinti veya etkin olmayan abonelik nedeniyle bir abonelikten kaçırılan etkinlikleri getirme
API Google Workspace Events API Chat API
Etkinliklerin 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 dokümanlarında Abonelik oluşturmak için etkinlik türleri bölümüne bakın.
  • Mesajlar
  • Üyelikler
  • Tepkiler
  • Boşluk

Desteklenen etkinlik türlerinin listesi için Chat API referans dokümanlarında bulunan 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 olan veya olmayan Base64 kodlu dize. Örneğin, yük verileri 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. Örneğin, yük verileri için referans dokümanlarına bakın.

Örnek: Bir alandaki üyeliklerle ilgili etkinlikleri sorgulayın veya etkinliklere abone olun

Bu örnekte, bir Chat uygulaması bir Chat alanının üyelerinde yapılan değişikliklerle ilgili bilgi 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 durum, kullanıcının Membership kaynağını günceller ve güncellenmiş bir üye etkinliği tetikler.
  • Bir kullanıcı alandan ayrıldığında, kullanıcının Membership kaynağı silinir ve üyenin silindiği etkinliği tetiklenir.

Üyelik etkinliklerine abone olma

Chat uygulaması, etkinlikleri anlık olarak almak için Google Workspace Events API subscriptions.create() yöntemini çağırarak tüm üyelik etkinlikleri türleri için alana abone olur. Abonelik oluşturulduktan sonra Chat uygulaması üyelik etkinlikleri almaya başlayabilir.

Google Workspace Events API'yi kullanarak etkinliklere abone olan Chat uygulaması.
Şekil 2. Chat uygulaması, Google Workspace Events API'yi kullanarak bir abonelik aracılığıyla üyelik etkinliklerini alır.

2. resimde Chat uygulamasının alana etkin bir aboneliği vardır. Bu nedenle, alandaki üyelik değiştiğinde uygulama bir etkinlik alır. Chat uygulaması, bu bilgileri işleme alabilir veya gerçek zamanlı olarak yanıt verebilir. Örneğin, alana katılan üyeye özel bir karşılama mesajı yayınlayabilir.

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

Son üyelik etkinlikleri için sorgu

Chat uygulamaları, üyelik etkinliklerini gerçekleştikçe almak yerine Chat API'yi çağırarak üyelik etkinliğiyle ilgili son alan etkinliklerini listeleyebilir.

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

3. şekilde, bir Chat uygulaması tüm üyelik etkinlikleri gerçekleştikten sonra Chat API 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 bir listesini döndürür. Chat uygulaması, son etkinliğe göre işlem yapabilir veya yanıt verebilir. Örneğin, alanın son 7 gün içindeki ü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ılara aboneliklerde, doğrudan mesajlarda veya adsız grup sohbetlerinde (google.workspace.chat.membership.v1.created) yeni üyelerle ilgili etkinlikler 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ı, bir alana Google Grubu üzerinden dolaylı olarak eklendiyse, güncellendiyse veya kaldırıldıysa abonelik bu üyelik etkinliklerini almaz. Google grubu üyeliklerinin işleyiş şeklini anlamak için Alanlara Google grubu ekleme başlıklı makaleyi inceleyin.