Google Meet etkinliklerine abone olma

Bu sayfada, Google Workspace Events API'yi kullanarak uygulamanızın abone olabileceği Google Meet etkinlikleri açıklanmaktadır. İhtiyacınız olan etkinlik türlerine 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 üzere Google Meet REST API'ye genel bakış başlıklı makaleyi inceleyin.

Desteklenen Meet etkinlikleri

Google Workspace abonelikleri, Meet'teki aşağıdaki değişiklik türleriyle ilgili etkinlikleri almanıza olanak tanır:

  • Toplantı alanında konferans başlatılır veya sonlandırılır.
  • Bir katılımcı konferansa katıldığında veya konferanstan ayrıldığında
  • Konferans için kayıt oluşturulur.
  • Konferans için transkript oluşturulur.

Etkinlikler için izleyebileceğiniz kaynaklar

Etkinlikleri almak için izlenecek bir Meet kaynağı belirtirsiniz. Bu kaynağa aboneliğin hedef kaynağı adı verilir.

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ı alanı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 etkinlikleri alır:

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

Abonelik oluşturmak için kullanılan 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, CloudEvents spesifikasyonuna göre biçimlendirilir. Örneğin: google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

Örneğin, bir Meet alanı için konferanstaki yeni katılımcılarla ilgili etkinlikleri almak üzere 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çıklamaları 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ında etkin bir konferanstan ayrılırsa

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ındaki etkinliklerle ilgili etkinlik verileri ve örnek yükler 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ştirilen Google Workspace kaynağı hakkında bilgi içerir. Örneğin, bir alandaki yeni transkriptlerle ilgili etkinliklere abone olduysanız bu etkinliklerin yükünde, değişen transcript kaynağıyla ilgili bilgiler yer alır.

Etkinlik yükündeki kaynak verileri

Aşağıdaki tabloda, bir Meet toplantı alanına abonelik için JSON yükü örnekleri verilmiştir. Örneklerde, toplantı alanını tanımlamak için konferans kaydı kimliği (örneğin, conferenceRecords/AAA-BBB-CCC-DDD-EEE) kullanılır. Daha fazla bilgi için Meet, toplantı alanlarını nasıl tanımlar? başlıklı makaleyi inceleyin.

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 konferans başlatılır.

google.workspace.meet.conference.v2.started
Kaynak verileri hariç tutulur.
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
Bir katılımcı, Meet toplantı alanında bir konferansa katıldığında

google.workspace.meet.participant.v2.joined
Kaynak verileri hariç tutulur.
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
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/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
Meet toplantı alanındaki bir konferans için transkript oluşturulur. google.workspace.meet.transcript.v2.fileGenerated
Kaynak verileri hariç tutulur.
{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}