Bu sayfada, Google Chat uygulamalarının Google Chat'teki etkinlikleri nasıl alabileceği ve 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, neler olduğunu anlamak, işlem yapmak veya kullanıcılarınız için anlamlı bir şekilde yanıt vermek için etkinlikleri kullanabilir.
Aşağıda, etkinlikleri nasıl kullanabileceğinize ilişkin bazı örnekler verilmiştir:
- Bir alandaki yeni mesajları izleyip yanıtlayın (ör. anahtar kelimeleri veya kelime öbeklerini kontrol etme).
- Alana katılan kullanıcılara, alan kurallarını açıklamak veya Chat uygulamasının etkili bir şekilde kullanılmasıyla ilgili ipuçları vermek için karşılama mesajı gönderin.
- Chat etkinliğini izleme ve analiz etme. Örneğin, yeni üyeler veya en çok tepki veya yanıt alan mesajlar hakkında aylık rapor göndermek için.
- Farklı mesajlaşma platformlarında iletişim kurun. Örneğin, kullanıcılar farklı bir mesajlaşma platformundaki kullanıcılardan Chat'ten ayrılmadan mesaj gönderip alabilir.
Etkinliklerin işleyiş şekli
Google Chat'te bir işlem söz konusu olduğunda, bir 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 göndermek için etkinlikleri kullanır.
Chat, etkinlikleri türe göre sınıflandırır. Etkinlik türleri, yalnızca ihtiyacınız olan bilgi türünü filtreleyip almanıza yardımcı olur ve 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ü |
---|---|---|
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 verdiğinde. | Bir Reaction kaynağı oluşturulur. |
Yeni tepki |
Bir kullanıcı alandan ayrılır. | Bir Membership kaynağı silindi. |
Üyelik silindi |
Google Chat'ten etkinlik alma
Chat uygulamanız, etkinlikleri almak için aşağıdakilerden birini yapabilir:
- Etkinlikleri gerçekleştiği anda almak için Google Workspace Events API'yi kullanarak etkinliklere abone olun.
- Chat API'yi çağırarak son etkinlikleri sorgulama.
Aşağıdaki tabloda, etkinliklerin sorgulanması veya etkinliklere abone olma nedenleri ve farklılıkları açıklanmaktadır:
Etkinliklere abone olma | Etkinlikler için sorgu | |
---|---|---|
Kullanım alanları |
|
|
API | Google Workspace Events API | Chat API |
Etkinliklerin kaynağı | Alanlar ve kullanıcılar | Yalnızca alanlar |
Desteklenen etkinlikler |
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. |
Desteklenen etkinlik türlerinin listesi için Chat API referans dokümanlarındaki 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. 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. Yükler için referans belgelerine bakın. |
Örnek: Bir alandaki üyeliklerle ilgili etkinlikleri sorgulama veya abone olma
Bu örnekte, bir Chat uygulaması, Chat alanının üyelerinde yapılan değişiklikler hakkında bilgi almak istiyor. Alanda aşağıdaki üyelik etkinlikleri 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 hâline gelir. Bu durumda kullanıcının
Membership
kaynağı güncellenir ve güncellenmiş üye etkinliği tetiklenir. - Bir kullanıcı alandan ayrılır. Bu durumda kullanıcı için
Membership
kaynağı silinir ve üyenin silinmesi işlemi tetiklenir.
Üyelik etkinliklerine abone olma
Chat uygulaması, etkinlikleri gerçek zamanlı olarak almak için Google Workspace Events API subscriptions.create()
yöntemini çağırarak alana her türlü üyelik etkinliği için abone olur. Aboneliği oluşturduktan sonra Chat uygulaması üyelik etkinliklerini almaya başlayabilir.
Şekil 2'de Chat uygulamasının alana etkin bir aboneliği vardır. Bu nedenle, alandaki bir üyelik her değiştiğinde uygulama bir etkinlik alır. Böylece Chat uygulaması, alana katılan üyeye özel bir karşılama mesajı yayınlamak gibi etkinliklerden herhangi birini gerçek zamanlı olarak işleyebilir veya bunlara yanıt verebilir.
Google Workspace Events API'yi kullanarak abonelik oluşturma hakkında bilgi edinmek için Google Workspace Events API dokümanlarını inceleyin.
En son üyelik etkinlikleri için sorgu
Chat uygulaması, üyelik etkinliklerini gerçekleştiği anda almak yerine, üyelik etkinliğiyle ilgili son alan etkinliklerini listelemek için Chat API'yi çağırabilir.
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 silinen üyelik etkinliklerine göre filtreler. Chat API, üyelik değişikliklerinin her birini temsil eden spaceEvent
kaynaklarının listesini döndürür.
Ardından Chat uygulaması son etkinliğe göre işlemleri yapabilir veya yanıt verebilir. Örneğin, alanın son 7 gündeki üyelik etkinliğinin özetini içeren haftalık bir mesaj yayınlayabilir.
Chat API'yi kullanarak etkinlikleri sorgulamak için Bir Google Chat alanındaki etkinlikleri listeleme başlıklı makaleyi inceleyin.
Sınırlamalar
-
Kullanıcı abonelikleri söz konusu olduğunda, 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. - Üyelik etkinliklerini almak için kullanıcının alanın doğrudan üyesi olması gerekir. Bir kullanıcı, bir Google Grubu aracılığıyla bir alana dolaylı olarak eklenmiş, güncellenmiş veya kaldırılmışsa abonelik bu üyelik etkinliklerini almaz. Google Grubu üyeliklerinin işleyiş şeklini öğrenmek için Alana Google Grubu ekleme başlıklı makaleyi inceleyin.
İlgili konular
- Google Workspace Events API'ye genel bakış
- Abonelik oluşturma
- Bir Google Chat alanı etkinliğiyle ilgili ayrıntıları öğrenme
- Bir Google Chat alanındaki etkinlikleri listeleme
- Etkinliklerin nasıl kullanılacağına dair örnekler için Gemini AI Chat uygulamasıyla sohbet sohbetlerine dayalı soruları yanıtlama veya sorun yönetiminin kapsayıcılık yardım özelliği Codelab'deki Chat uygulaması Gemini ile Google Chat için uygulama geliştirme başlıklı eğiticiye göz atın.