Bu sayfada, Google Chat uygulamalarının nasıl mesaj alabileceği ve yanıt verebileceği açıklanmaktadır. etkinlikleri Google Chat'te bulabilirsiniz.
Google Chat etkinliği, Chat'teki bir etkinliği veya değişikliği temsil eder. Örneğin bir alandaki yeni bir mesaj. Chat uygulamanız şunları kullanabilir: anlamlı bir şekilde harekete geçmek veya yanıt vermek için bir yöntem olacaktır.
Aşağıda, etkinlikleri nasıl kullanabileceğinize ilişkin bazı örnekler verilmiştir:
- Bir alandaki yeni mesajları takip etme ve yanıtlama (ör. anahtar kontrolü) size yardımcı olur.
- Alana katılan kullanıcılara, alanı açıklamak için karşılama mesajı gönderin. talimatları uygulayın veya Chat uygulaması.
- Chat etkinliğini izleme ve analiz etme. Örneğin, bir yeni üyeler veya en çok gönderilen mesajlarla ilgili aylık rapor veya yanıtlarınız olabilir.
- Farklı mesajlaşma platformlarında iletişim kurun. Örneğin, kullanıcılar Ayrıca farklı bir mesajlaşma platformundaki kullanıcılardan mesaj almak için Chat'ten ayrılıyorsunuz.
Etkinliklerin işleyiş şekli
Google Chat'te bir sorun olduğunda Google Chat API kaynağı (güncellenmesi denebilir.) Chat, etkinlikleri teslim etmek için etkinlikleri kullanır. Chat uygulamanıza yeni ve etkilenen Chat API kaynağı gösterilir.
Message
kaynağı oluşturan Chat alanı.
Chat, yeni kullanıcı arayüzüyle ilgili verileri içeren bir etkinlik
mesajını alırsınız.Chat, etkinlikleri türe göre sınıflandırır. Etkinlik türleri, yüksek kaliteli içerikleri filtrelemenize yalnızca ihtiyacınız olan bilgi türünü alır ve benzer teşvik edebilirsiniz.
Aşağıdaki tabloda, Chat'teki bir etkinliğin ve ilgili Chat API kaynağını ve Google Ad Manager'ın Chat uygulaması şunları alır:
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 takip etmek için:
- Etkinlik almak için Google Workspace Events API'yi kullanarak etkinliklere abone olma tespit edebilirsiniz.
- Chat API'yi çağırarak son etkinlikleri sorgulama.
Aşağıdaki tabloda etkinliklere abone olma:
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 bkz. Abonelik oluşturmaya yönelik etkinlik türleri: Google Workspace Events API dokümanları |
Desteklenen etkinlik türlerinin listesi için bkz. Chat API'de spaceEvents kaynak
referans belgeler.
|
Etkinlik biçimi | Şuna göre biçimlendirilmiş bir Google Cloud Pub/Sub mesajı: CloudEvent spesifikasyonu. Ayrıntılar için bkz. Google Workspace etkinliklerinin yapısı. |
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. Örneğin yük için referans belgeler. |
Örnek: Bir alandaki üyeliklerle ilgili etkinlikleri sorgulama veya abone olma
Bu örnekte, bir Chat uygulaması Chat alanının üyelerinde yapılan değişikliklerle ilgili bilgiler. İçinde alanda aşağıdaki üyelik etkinlikleri gerçekleşir:
- Kullanıcı alana katıldığında
Membership
kaynağı oluşturulur ve tetikleyici bir yeni üye etkinliği. - Kullanıcı, alan yöneticisi hâline gelir ve
Membership
kaynağı güncellenir. ve güncellenmiş bir üye etkinliğini tetikler. - Bir kullanıcı alandan ayrılır ve içeriğe ait
Membership
kaynağı silinir bir üye tarafından silinme etkinliğini tetikler.
Üyelik etkinliklerine abone olma
Etkinlikleri gerçek zamanlı olarak almak için
Chat uygulaması, Google Workspace Events API'yi çağırır
subscriptions.create()
Bu, her türlü üyelik etkinliği için alana abone olma yöntemini kullanır. Şu tarihten sonra:
Chat uygulaması bir sonraki
üyelik etkinliklerini kabul edebilir.
Şekil 2'de, Chat uygulamasının Alana üye olunduğunda uygulama bir etkinlik alır anlamına gelir. Chat uygulaması, oturum açtığınızda anlık mesaj gönderebilirsiniz. Örneğin, Arkadaş Bitkiler hizmetine özel hoş geldiniz mesajı Alana katılan üye olur.
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
Üyelik etkinliklerini gerçekleştiği anda almak yerine, Chat uygulaması, aşağıdakileri listelemek için Chat API'yi çağırabilir: üyelik etkinliğiyle ilgili son alan etkinlikleri
Şekil 3'te bir Chat uygulaması, Chat API'yi çağırır
spaces.spaceEvents.list()
yöntemini kullanır ve sorguyu filtreler
(yeni, güncellenen ve silinen üyelik etkinlikleri için) Chat API geri döndü
üyelik değişikliklerinin her birini temsil eden spaceEvent
kaynaklarının listesi.
Daha sonra Chat uygulaması
son etkinlikler (örneğin,
alanın son 7 gündeki üyelik etkinliğini gösterir.
Chat API'yi kullanarak etkinlikleri sorgulamak için bkz. Bir Google Chat alanındaki etkinlikleri listeleyin.
Sınırlamalar
-
Kullanıcı abonelikleri için doğrudan mesajlardaki veya adsız grup sohbetlerindeki yeni üyelerle ilgili etkinlikler (
google.workspace.chat.membership.v1.created
), 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. Kullanıcı eklendiyse bir Google Grubu aracılığıyla dolaylı olarak bir alana güncellendiğinde veya ekleyebilirsiniz. Google Grubu üyeliklerinin işleyiş şeklini öğrenmek için şu makaleyi inceleyin: Alanlara Google Grubu ekleyin.
İ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 ilişkin örnekler için şu eğiticiye göz atın: Gemini yapay zeka ile Chat sohbetlerinde Chat uygulaması kapsayıcılık konusunda yardım alabilmeniz için Codelab'de Chat uygulaması Gemini ile Google Chat için uygulama geliştirme