Google Meet'ten etkinliklere yanıt verme

Bu belgede, Google Cloud Pub/Sub'dan Google Meet etkinliklerinin nasıl alınacağı ve yanıtlanacağı açıklanmaktadır.

Meet etkinliği, yeni toplantı oluşturma gibi bir Meet kaynağındaki etkinliği veya değişikliği ifade eder. Etkinlikleri kullanarak ne olduğunu anlayabilir, ardından işlem yapabilir veya kullanıcılarınıza anlamlı bir şekilde yanıt verebilirsiniz.

Etkinlikleri nasıl kullanabileceğinize dair bazı örnekler:

  • Toplantıların başlama veya bitiş zamanı gibi değişiklikleri gözlemleyip yanıtlayın.

  • Yasal düzenlemeler veya eğitim amacıyla toplantıya katılanları takip edin.

  • Dosya içeriklerinin ayrıştırılıp bir CRM'ye veya veritabanına kaydedilebilmesi için toplantı transkriptini dinleyin.

Etkinliklerin işleyiş şekli

Google Meet'te bir işlem yapıldığında Google Meet REST API kaynağı oluşturulur veya güncellenir. Meet, etkinlikleri kullanarak uygulamanıza, gerçekleşen etkinlik türü ve etkilenen Meet REST API kaynağı hakkında bilgi verir.

Yeni bir toplantı alanının etkinliği nasıl tetiklediğine dair örnek.
Şekil 1. Kullanıcı bir toplantı alanı oluşturur. Bu işlem, bir Space kaynağı oluşturur. Ardından Meet, yeni toplantı alanı hakkındaki verileri içeren bir etkinlik oluşturur.

Meet, etkinlikleri türe göre kategorize eder. Etkinlik türleri, yalnızca ihtiyacınız olan bilgileri filtrelemenize ve almanıza yardımcı olur. Ayrıca benzer etkinlikleri aynı şekilde yönetmenizi sağlar.

Aşağıdaki örnekte, Meet'teki bir etkinliğin ilgili Meet REST API kaynağını nasıl etkilediği ve Meet uygulamanızın aldığı etkinlik türü gösterilmektedir:

Etkinlik Meet REST API kaynağı Etkinlik türü
Bir kullanıcı toplantı alanına katıldığında ConferenceRecord kaynağı oluşturulur. Yeni konferans kaydı

Google Meet'ten etkinlik verileri alma

Uygulamanız, etkinlik verilerini almak için aşağıdakilerden birini yapabilir:

Aşağıdaki tabloda, etkinliklere abone olma ile etkinlikleri sorgulama arasındaki fark ve nedenler açıklanmaktadır:

Etkinliklere abone olma Veri sorgulama
Kullanım alanları
  • Etkinlikleri anında işleme veya yanıtlama
  • Uygulamanızın performansını artırmak için kaynaklardaki değişiklikleri izleyin.
  • Verileri manuel olarak alın.
  • Meet'teki tüm verileri getirme (kesinti veya etkin olmayan abonelik nedeniyle).
API Google Workspace Events API Meet REST API
Etkinlik kaynağı Konferans kaydı ve kullanıcılar Alan ve konferans kaydı
Desteklenen etkinlikler Konferans kaydı

Desteklenen etkinlik türlerinin listesi için Google Workspace Events API belgelerindeki Abonelik oluşturmaya yönelik etkinlik türleri başlıklı makaleye bakın. 		Alan ve konferans kaydı

Desteklenen uç noktaların listesi için Meet REST API belgelerindeki Space kaynağına ve ConferenceRecord 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. Meet REST API kaynağı (Space ve ConferenceRecord)
Etkinlik verileri Kaynak verileri içeren veya içermeyen Base64 kodlu dize. Örnek yükler için Etkinlik verileri bölümüne bakın. Kaynak verilerini içeren JSON yükü. Örnek yük için referans belgelerindeki ConferenceRecord kaynağına bakın.

Örnek: Toplantı alanındaki katılımcılarla ilgili etkinlikleri alma

Bu örnekte, bir Meet uygulaması, toplantı alanındaki katılımcı değişiklikleriyle ilgili bilgi almak istiyor. Toplantı alanında bir katılımcı, etkin bir konferansa katılır. Bu durumda ParticipantSession kaynağı doldurulur ve yeni bir etkinlik tetiklenir. Daha sonra subscribe veya query yöntemini kullanarak bu etkinlikler hakkında bilgi edinebilirsiniz.

Etkinliklere abone olma

Etkinlikleri gerçek zamanlı olarak almak için Meet uygulaması, Google Workspace Events API'nin subscriptions.create yöntemini çağırarak toplantı alanına tüm etkinlik türleri için abone olur. Abonelik oluşturulduktan sonra Meet uygulaması etkinlikleri almaya başlayabilir.

Google Workspace Events API'yi kullanarak katılımcı etkinliklerine abone olan bir Meet uygulaması.
Şekil 2. Bir Meet uygulaması, Google Workspace Events API'yi kullanarak abone olduğu etkinlikler aracılığıyla katılımcı etkinliklerini alır.

Şekil 2'de, Meet uygulamasının toplantı alanına etkin bir aboneliği vardır. Bu nedenle, toplantı alanında bir katılımcı oturumu her değiştiğinde uygulama bir etkinlik alır. Meet uygulaması daha sonra, bir katılımcının etkin bir konferansa katılması veya konferanstan ayrılması gibi etkinliklere anında yanıt verebilir.

Google Workspace Events API'yi kullanarak abonelik oluşturma hakkında bilgi edinmek için Google Workspace Events API belgelerine bakın.

Son etkinlikleri sorgulama

Meet uygulaması, etkinlikleri gerçekleştiği sırada almak yerine, katılımcı etkinliğiyle ilgili son toplantı alanı etkinliklerini listelemek için Meet REST API'yi de çağırabilir.

Meet REST API'yi kullanarak katılımcı etkinliklerini sorgulayan bir Meet uygulaması.
Şekil 3. Bir Meet uygulaması, Meet REST API'yi kullanarak toplantı alanı etkinliklerini sorgulayarak son katılımcı etkinliklerini alır.

Şekil 3'te, bir Meet uygulaması tüm katılımcı oturumu etkinlikleri gerçekleştikten sonra Meet REST API conferenceRecords.participants.participantSessions.list yöntemini çağırıyor. Meet REST API, değişikliklerin her birini temsil eden ParticipantSession kaynakların listesini döndürür. Meet uygulaması daha sonra, konferansa katılan ve ayrılan katılımcıların listesini oluşturma gibi son etkinliğe göre işlem yapabilir veya yanıt verebilir.

Meet REST API'yi kullanarak etkinlikleri sorgulamak için Tüm katılımcı oturumlarını listeleme başlıklı makaleyi inceleyin.

Sınırlamalar
  • Takvim davetlileri ve konferansa davet edilen diğer katılımcılar yalnızca şu etkinlikleri alabilir: google.workspace.meet.conference.v2.started ve google.workspace.meet.transcript.v2.fileGenerated.