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 etkinlik türlerine ihtiyacınız olduğuna karar verdikten sonra Google Meet'ten etkinlik almaya başlamak için abonelik oluşturun.

Google 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ıza olanak tanır:

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

Etkinlikler için izleyebileceğiniz kaynaklar

Etkinlik almak için, aboneliğin hedef kaynağı olarak adlandırılan ve izlenecek bir Meet kaynağı belirtirsiniz.

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ıyla ilişkili Google Takvim etkinliğinin düzenleyicisi.

Abonelik oluşturmak için etkinlik türleri

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, CloudEvents spesifikasyonuna göre biçimlendirilir (ör. google.workspace.APPLICATION.RESOURCE.VERSION.ACTION). Ö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 etkinliklerin etkinlik verileri ve örnek yükü açıklanmaktadır.

Google Workspace aboneliğiniz Meet'ten bir etkinlik aldığında data alanı etkinliğin yükü içerir. 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"
    }
}