Google Chat'teki etkinliklerle çalışma

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.

Google Chat alanında yayınlanan bir mesajın nasıl etkinliği tetiklediğini gösteren örnek.
Şekil 1. Bir kullanıcı şurada bir ileti yayınladığında: 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ı
  • Etkinlikleri gerçek zamanlı olarak işleyin veya yanıtlayın.
  • Kullanıcıları izleme yeni alanlar keşfedebilirsiniz. anlamına gelir.
  • Etkinlikleri periyodik olarak ya da bir tetikleyici aracılığıyla işleme veya yanıtlama.
  • Bir abonelikteki kaçırılan etkinlikleri (bir kesinti veya etkin olmayan abonelik).
API Google Workspace Events API Chat API
Etkinliklerin kaynağı Alanlar ve kullanıcılar Yalnızca alanlar
Desteklenen etkinlikler
  • Mesajlar
  • Üyelikler
  • Tepkiler
  • Boşluk

Desteklenen etkinlik türlerinin listesi için bkz. Abonelik oluşturmaya yönelik etkinlik türleri: Google Workspace Events API belgeleri.
  • Mesajlar
  • Üyelikler
  • Tepkiler
  • Boşluk

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.

Etkinliklere abone olan Chat uygulaması: Google Workspace Events API.
Şekil 2. Chat uygulaması Kullanıcı, aşağıdakileri kullanarak bir abonelik üzerinden üyelik etkinlikleri aldığında, .

Ş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

Şu API'yi kullanarak etkinlikleri sorgulayan Chat uygulaması: Chat API'ye gidin.
Şekil 3. CEVAP Chat uygulaması, son üyelik etkinliklerini alan: Chat API'yi kullanarak alan etkinlikleri için sorgu oluşturma.

Ş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.