Google Meet etkinliklerine abone olma

Bu sayfada, uygulamanızın Google Workspace Events API'yi kullanarak abone olabileceği Google Meet etkinlikleri açıklanmaktadır. Hangi tür etkinliklere ihtiyacınız olduğuna karar verdikten sonra Meet'ten etkinlik almaya başlamak için abonelik oluşturun.

Meet için uygulama geliştirme hakkında daha fazla bilgi edinmek istiyorsanız Google Meet REST API'ye genel bakış başlıklı makaleyi inceleyin.

Desteklenen Meet etkinlikleri

Google Workspace abonelikleri, Meet'te aşağıdaki değişiklik türleriyle ilgili etkinlikler almanızı sağlar:

  • Konferans, toplantı alanında başlar veya biter.
  • Bir katılımcı konferansa katılır veya konferanstan ayrılır.
  • Konferans için bir kayıt oluşturulur.
  • Konferans için bir transkript oluşturulur.

Etkinlikler için izleyebileceğiniz kaynaklar

Etkinlik almak için izlenecek bir Meet kaynağı belirtirsiniz. Bu kaynak, aboneliğin hedef kaynağı olarak adlandırılır.

Google Workspace Events API, Meet için aşağıdaki hedef kaynakları destekler:

Hedef kaynak Biçim Sınırlamalar (varsa)
Toplantı alanı //meet.googleapis.com/spaces/SPACE

Burada SPACE, Meet REST API space kaynağının kaynak adındaki kimliktir. Ayrıntılı bilgi için Meet'in toplantı mekanlarını nasıl tanımladığı başlıklı makaleyi inceleyin.

Kullanıcı //cloudidentity.googleapis.com/users/USER

Burada USER, Meet REST API participant kaynağının signedinUser.user alanındaki kimliktir. Ayrıntılı bilgi için Katılımcılarla çalışma başlıklı makaleyi inceleyin.

Abonelik, kullanıcının aşağıdakilerden biri olduğu toplantı alanlarıyla ilgili etkinlikler alır:

  • Toplantı alanının sahibi.
  • Toplantı alanındaki bir katılımcı.
  • Toplantı alanıyla ilişkili Google Takvim etkinliğinin düzenleyicisi.

Abonelik oluşturmak için etkinlik türleri

Bir Meet kaynağına abonelik oluşturduğunuzda, hangi etkinlik türlerini almak istediğinizi belirtmek için eventTypes[] alanını kullanırsınız. Etkinlik türleri, google.workspace.APPLICATION.RESOURCE.VERSION.ACTION gibi CloudEvents spesifikasyonuna göre biçimlendirilir. Örneğin, Meet alanı için bir konferanstaki yeni katılımcılarla ilgili etkinlikleri almak istiyorsanız etkinlik türünü google.workspace.meet.participant.v2.joined olarak belirtirsiniz. Etkinliklerin işleyiş şekli hakkında daha fazla bilgi edinmek için Google Workspace etkinliklerinin yapısı başlıklı makaleyi inceleyin.

Aşağıdaki tabloda desteklenen etkinlik türleri, açıklama ve etkinlik verilerinde temsil edilen değiştirilmiş Meet kaynağı gösterilmektedir:

Etkinlik türü Açıklama Meet kaynağı

google.workspace.meet.conference.v2.started

Toplantı alanında bir konferans başlatılır.

conferenceRecord

google.workspace.meet.conference.v2.ended

Toplantı alanında bir konferans sona erdiğinde

conferenceRecord

google.workspace.meet.participant.v2.joined

Bir katılımcı, toplantı alanındaki etkin bir konferansa katıldığında

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

Bir katılımcı, toplantı alanındaki etkin bir konferanstan ayrılır.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

Toplantı alanındaki bir konferans için kayıt dosyası oluşturulur.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

Toplantı alanındaki bir konferans için transkript dosyası oluşturulur.

conferenceRecord.transcript

Etkinlik verileri

Bu bölümde, Meet toplantı alanlarında düzenlenen etkinliklerle ilgili etkinlik verileri ve örnek yük verileri açıklanmaktadır.

Google Workspace aboneliğiniz Meet'ten bir etkinlik aldığında data alanında etkinliğin yükü bulunur. Bu yükü, değişen Google Workspace kaynağıyla ilgili bilgiler içerir. Örneğin, bir alandaki yeni transkriptlerle ilgili etkinliklere abone olduysanız bu etkinliklerin yükü, değişen transcript kaynağıyla ilgili bilgileri içerir.

Etkinlik yükündeki kaynak verileri

Aşağıdaki tabloda, Meet toplantı alanına abonelik için JSON yükü örnekleri verilmiştir. Örneklerde, alanda gerçekleşen konferans kullanılmaktadır.conferenceRecords/AAA-BBB-CCC-DDD-EEE Aboneliğin aldığı her etkinlik için yük, etkinliğin data alanında görünür:

Örnek Etkinlik türü JSON yükü

Meet toplantı alanı için bir konferans başlatılır.

google.workspace.meet.conference.v2.started

Kaynak verileri hariç tutulur.
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
      
Bir katılımcı, Meet toplantı alanındaki bir konferansa katılır.

google.workspace.meet.participant.v2.joined

Kaynak verileri hariç tutulur.
{
    "participantSession":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
    }
}
      
Meet toplantı alanındaki bir konferans için kayıt oluşturulur. google.workspace.meet.recording.v2.fileGenerated
Kaynak verileri hariç tutulur.
{
    "recording":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
    }
}
      
Meet toplantı alanındaki bir konferans için transkript oluşturulur. google.workspace.meet.transcript.v2.fileGenerated
Kaynak verileri hariç tutulur.
{
    "transcript":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
    }
}