Google Chat'teki etkinliklerle çalışma

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

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

Aşağıda, etkinlikleri nasıl kullanabileceğinize ilişkin bazı örnekler verilmiştir:

  • Alandaki yeni mesajları izleyip yanıtlayın (ör. anahtar kelimeleri veya ifadeleri kontrol etme).
  • Alana katılan kullanıcılara alan kurallarını açıklamak veya Chat uygulamasının etkili bir şekilde kullanımıyla ilgili ipuçları paylaşmak için bir karşılama mesajı gönderin.
  • Chat etkinliğini izleyin ve analiz edin. Örneğin, yeni üyeler veya en çok tepki ya da yanıt alan mesajlarla ilgili aylık rapor göndermek için.
  • Farklı mesajlaşma platformları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 onlardan mesaj alabilir.

Etkinliklerin işleyiş şekli

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

Google Chat alanında yayınlanan bir mesajın etkinliği nasıl tetiklediğini gösteren örnek.
Şekil 1. Kullanıcının Chat alanında mesaj yayınlaması, Message kaynağı oluşturur. Daha sonra Chat, yeni mesajla ilgili verileri içeren bir etkinlik oluşturur.

Chat, etkinlikleri türe göre kategorilere ayırır. Etkinlik türleri yalnızca ihtiyacınız olan türde bilgileri filtreleyip almanıza ve benzer etkinlikleri aynı şekilde yönetmenize yardımcı olur.

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ınlar Bir Message kaynağı oluşturulur. Yeni mesaj
Kullanıcı, alan yöneticisi olur. Bir Membership kaynağı güncellendi. Üyelik güncellendi
Kullanıcı bir mesaja tepki verir. Bir Reaction kaynağı oluşturulur. Yeni tepki
Bir kullanıcının alandan ayrılması. Bir Membership kaynağı silindi. Üyelik silindi

Google Chat'ten etkinlik alma

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

  • Gerçekleşen etkinlikleri almak için Google Workspace Etkinlikleri API'sini kullanarak etkinliklere abone olun.
  • Chat API'yi çağırarak son etkinlikler için sorgulama yapın.

Aşağıdaki tabloda, etkinlikleri sorgulamanın veya abone olmanın farkları ve nedenleri açıklanmaktadır:

Etkinliklere abone ol Etkinlikler için sorgu
Kullanım alanları
  • Etkinlikleri gerçek zamanlı olarak işleyin veya yanıtlayın.
  • Kullanıcıların üyelik etkinliğini izleyin ve izlenecek yeni alanlar keşfedin.
  • Etkinlikleri düzenli olarak veya bir tetikleyici aracılığıyla işleme ya da yanıtlama.
  • Bir abonelikteki kaçırılan etkinlikleri (kesinti veya etkin olmayan abonelik nedeniyle) getirin.
API Google Workspace Events API Chat API
Etkinliklerin kaynağı Alanlar ve kullanıcılar Yalnızca alanlar
Desteklenen etkinlikler
  • Mesajlar
  • Üyelikler
  • Tepkiler
  • Alan

Desteklenen etkinlik türlerinin listesi için Google Workspace Etkinlikleri API dokümanlarındaki Abonelik oluşturmaya yönelik etkinlik türleri bölümüne bakın.
  • Mesajlar
  • Üyelikler
  • Tepkiler
  • Alan

Desteklenen etkinlik türlerinin listesi için Chat API referans dokümanlarındaki spaceEvents kaynağını inceleyin.
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ı bölümüne bakın. Chat API kaynağı ( spaces.spaceEvent)
Etkinlik verileri Kaynak verileri olan veya olmayan Base64 kodlu dize. Örnek yük 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ük örnekleri için referans belgelerini inceleyin.

Örnek: Alanlarda üyeliklerle ilgili etkinlikleri sorgulama veya bunlara abone olma

Bu örnekte, bir Chat uygulaması bir Chat alanının üyelerinde yapılan değişiklikler hakkında 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 bir üye etkinliği tetiklenir.
  • Kullanıcı, alan yöneticisi haline gelir. Bu işlem, kullanıcı için Membership kaynağını günceller ve güncellenmiş bir üye etkinliğini tetikler.
  • Bir kullanıcı alandan ayrılır. Bu durumda kullanıcı için Membership kaynağı silinir ve üye tarafından silinen bir etkinliği tetikler.

Üyelik etkinliklerine abone olma

Chat uygulaması, etkinlikleri gerçek zamanlı olarak almak için her tür üyelik etkinliği için alana abone olmak amacıyla Google Workspace Events API subscriptions.create() yöntemini çağırır. Aboneliği oluşturduktan sonra Chat uygulaması, üyelik etkinliklerini almaya başlayabilir.

Google Workspace Etkinlikleri API'sini kullanarak etkinliklere abone olan
      Chat uygulaması.
Şekil 2. Bir Chat uygulaması, üyelik etkinliklerini Google Workspace Etkinlikler API'sini kullanan bir abonelik aracılığıyla alır.

Şekil 2'de, Chat uygulamasının alan için etkin bir aboneliği vardır. Bu nedenle, alandaki bir üyelik değişikliği her defasında uygulama bir etkinlik alır. Ardından Chat uygulaması, alana katılan üyeye özel karşılama mesajı yayınlamak gibi herhangi bir etkinliği gerçek zamanlı olarak işleyebilir veya yanıt verebilir.

Google Workspace Etkinlikleri API'sini kullanarak abonelik oluşturma hakkında bilgi edinmek için Google Workspace Etkinlikler API'si dokümanlarına bakın.

Son üyelik etkinlikleriyle ilgili sorgu

Chat uygulamaları, üyelik etkinliklerini gerçekleştiği sırada 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 en son üyelik etkinliklerini alır.

Şekil 3'te, 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 silinen ü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. Ardından Chat uygulaması son etkinliğe (ör. alanın son 7 gün içindeki üyelik etkinliğinin özetini içeren haftalık bir mesaj yayınlamak) göre işlem yapabilir veya yanıt verebilir.

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

Sınırlamalar

  • Kullanıcılara yönelik aboneliklerde, doğrudan mesajlardaki veya adsız grup sohbetlerindeki (google.workspace.chat.membership.v1.created) yeni üyelerle ilgili etkinlikler yalnızca ilk mesaj yayınlandıktan sonra tetiklenir.
  • Alan geçmişinde yapılan değişiklikler, güncellenen alan etkinliklerini tetiklemez (Etkinlik türü: google.workspace.chat.spaces.v1.updated).
  • Üyelik etkinliklerini almak için kullanıcının alanın doğrudan üyesi olması gerekir. Kullanıcı bir Google grubu aracılığıyla bir alana dolaylı olarak eklenir, güncellenir veya kaldırılırsa abonelik bu üyelik etkinliklerini almaz. Google Grubu üyeliklerinin işleyiş şeklini anlamak için Bir alana Google Grubu ekleme başlıklı makaleyi inceleyin.