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 platformundan 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. Etkinlikler, etkinliğin ne zaman gerçekleştiği ve etkilenen Chat API kaynağı hakkında bilgi sağlar.
Chat, etkinlikleri türe göre kategorilere ayırır. Etkinlik türleri, yalnızca ihtiyacınız olan bilgi türünü filtreleyip istemenize 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 etkinlikleri sorgulayın.
Google Workspace Event API ve Chat API, aynı etkinlik türlerini destekler. Etkinliklere abone olmanız veya etkinlikler için sorgulama yapmanız gerekip gerekmediğini anlamak için aşağıdaki tabloyu inceleyin:
| Etkinliklere abone ol | Etkinlikler için sorgu | |
|---|---|---|
| Kullanım alanları |
|
|
| API | Google Workspace Events API | Chat API |
| Etkinliklerin kaynağı | Alanlar ve kullanıcılar | Yalnızca alanlar |
| 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. Yükler örnek olarak SpaceEvents referans belgelerine göz atın. |
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. Chat API'yi kullanarak etkinlikleri sorgulamak için aşağıdaki kılavuzları inceleyin:
- Google Chat alanı etkinliğiyle ilgili ayrıntıları öğrenme
- Bir Google Chat alanındaki etkinlikleri listeleme
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.