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) 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.
Etkinlikleri nasıl kullanabileceğinize dair bazı örnekler:
- Alandaki yeni mesajları izleyip yanıtlayın (ör. anahtar kelimeleri veya ifadeleri kontrol edin).
- Kullanıcılar alana katıldığında onlara bir karşılama 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 mesajlar hakkında aylık rapor göndermek için kullanılabilir.
- Mesajlaşma platformları üzerinden iletişim kurun. Örneğin, kullanıcılar Chat'ten ayrılmadan farklı bir mesajlaşma platformundaki kullanıcılardan mesaj alıp onlara mesaj gönderebilir.
Etkinliklerin işleyiş şekli
Google Chat'te bir işlem yapıldığında 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.
Message kaynağı oluşturulur.
Chat, yeni mesajla ilgili verileri içeren bir etkinlik oluşturur.Chat, etkinlikleri türlerine göre kategorilere ayı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 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 | Message kaynağı oluşturulur. |
Yeni mesaj |
| Bir kullanıcı alan yöneticisi olduğunda | Membership kaynağı güncellendiğinde. |
Üyelik güncellendi |
| Bir kullanıcı bir mesaja tepki verdiğinde | Reaction kaynağı oluşturulur. |
Yeni tepki |
| Bir kullanıcı bir alandan ayrıldığında | Membership kaynağı silindiğinde. |
Silinen üyelik |
Google Chat'ten etkinlik alma
Etkinlikleri almak için Chat uygulamanız aşağıdakilerden birini yapabilir:
- Etkinlikleri gerçekleştikleri 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, etkinlikleri sorgulama veya etkinliklere abone olma arasındaki fark ve nedenleri açıklanmaktadır:
| Etkinliklere abone olma | Etkinlikleri sorgulama | |
|---|---|---|
| Kullanım alanları |
|
|
| API | Google Workspace Events API | Chat API |
| Etkinliklerin kaynağı | Alanlar, kullanıcılar ve Google Workspace kuruluşları ( Geliştirici Önizlemesi) | Yalnızca alanlar |
| Desteklenen etkinlikler |
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. |
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 ile kodlanmış 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ı, 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ılır. Bu işlem, bir
Membershipkaynağı oluşturur ve yeni üye etkinliğini tetikler. - Bir kullanıcı alan yöneticisi olduğunda kullanıcının
Membershipkaynağı güncellenir ve güncellenmiş üye etkinliği tetiklenir. - Bir kullanıcı alandan ayrıldığında kullanıcının
Membershipkaynağı silinir ve üye silindi etkinliği tetiklenir.
Üyelik etkinliklerine abone olma
Chat uygulaması, etkinlikleri anlık olarak almak için Google Workspace Events API'nin subscriptions.create() yöntemini çağırarak tüm üyelik etkinliği türleri için alana abone olur. Abonelik oluşturulduktan 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 değiştiğinde uygulama bir etkinlik alır. Chat uygulaması, etkinlikleri gerçek zamanlı olarak işleyebilir veya bunlara yanıt verebilir. Örneğin, alana katılan üyeye özel bir karşılama mesajı gönderebilir.
Google Workspace Events API'yi kullanarak abonelik oluşturma hakkında bilgi edinmek için Google Workspace Events API belgelerini inceleyin.
Son üyelik etkinliklerini sorgulama
Chat uygulaması, üyelik etkinliklerini gerçekleştikleri anda almak yerine Chat API'yi çağırarak üyelik etkinliğiyle ilgili son alan etkinliklerini listeleyebilir.
Şekil 3'te, bir Chat uygulaması tüm üyelik etkinlikleri gerçekleştikten sonra Chat API'nin 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ı, son etkinliğe göre işlem 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 Google Chat alanındaki etkinlikleri listeleme başlıklı makaleyi inceleyin.
Sınırlamalar ve yayınlama davranışları
Genel sınırlamalar
- Üyelik etkinliklerini almak için kullanıcının veya Chat uygulamasının alanın doğrudan üyesi olması gerekir. 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 anlamak için Alana Google Grubu ekleme başlıklı makaleyi inceleyin.
Kullanıcı abonelikleri
-
Kullanıcı aboneliklerinde, 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.
Müşteri abonelikleri
Müşteri abonelikleri için aşağıdaki sınırlamalar geçerlidir:
- Google Workspace kuruluşunun en az bir Enterprise SKU lisansı olmalıdır.
- Bir Chat uygulaması, belirli bir Google Workspace kuruluşu için yalnızca bir müşteri aboneliği oluşturabilir. Bir Google Workspace kuruluşunun toplamda en fazla beş müşteri aboneliği (farklı Chat uygulamaları tarafından oluşturulmuş) olabilir.
Müşteri abonelikleri için etkinlik yayınlama aşağıdaki genel kurallara uyar:
- Alan etkinlikleri: Yalnızca etkinlik, Google Workspace kuruluşunuz tarafından yönetilen bir alanda gerçekleşirse yayınlanır.
- Kullanıcı etkinlikleri: Yalnızca Google Workspace kuruluşunuza ait bir kullanıcı için etkinlik gerçekleşirse yayınlanır.
Bu kuralların tek istisnası üyelik etkinlikleridir. Aboneliğiniz, hem kuruluşunuz tarafından yönetilen alanlardan hem de harici kuruluşlar tarafından yönetilen alanlardan üyelik etkinlikleri alabilir. Ancak bu etkinliklerin nasıl yayınlanacağı, alanı hangi kuruluşun yönettiğine bağlıdır:
Google Workspace kuruluşunuz tarafından yönetilen alanlar
Google Workspace kuruluşu tarafından yönetilen bir alanda üyelik değişikliği olursa bu değişiklik alan etkinliği olarak yayınlanır.
Alan etkinliğinin kaynak adı aşağıdaki biçimi kullanır:
spaces/{spaceId}/spaceEvents/{spaceEventId}
Harici kuruluşlar tarafından yönetilen alanlar
Google Workspace kuruluşunuz tarafından yönetilen bir kullanıcının üyeliği, harici bir kuruluş tarafından yönetilen bir alanda (ör. harici bir adlandırılmış alan veya harici bir kullanıcı tarafından oluşturulan doğrudan mesaj) değişirse aboneliğiniz bu etkinliği kullanıcı etkinliği olarak alır.
Kullanıcı etkinliğinin kaynak adı aşağıdaki biçimi kullanır:
users/{userId}/userEvents/{userEventId}