Google Meet etkinliklerine abone olma

Bu belgede, Google Workspace Events API'yi kullanarak uygulamanızın 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.

Etkinliklere abone olmanın yanı sıra Google Meet REST API'yi çağırarak da etkinlikleri sorgulayabilirsiniz. Meet REST API'yi çağırarak etkinlikleri düzenli olarak alabilir veya bir kesinti nedeniyle abonelikten kaçırmış olabileceğiniz etkinlikleri yakalayabilirsiniz. Meet etkinliklerini alma ve yanıtlama yöntemleri hakkında bilgi edinmek için Meet belgelerindeki Google Meet etkinliklerini yanıtlama başlıklı makaleyi inceleyin.

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
  • Bir konferans için kayıt başlatıldığında, sonlandırıldığında veya dosya oluşturulduğunda
  • Bir konferans için transkript başlatıldığında, sonlandırıldığında veya dosya oluşturulduğunda

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 spaces 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 participants 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 toplantı alanının sahibi olduğu tüm toplantı alanlarıyla ilgili etkinlikleri alır. Toplantı alanı sahibi genellikle toplantı alanıyla ilişkili Google Takvim etkinliğinin de düzenleyicisidir.

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ındaki konferansa yeni katılanlarla ilgili etkinlikleri almak için 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, Meet kaynaklarına yönelik abonelikler için hangi etkinlik türlerinin desteklendiği gösterilmektedir:

Etkinlik türü Biçim Kaynak verileri
Toplantı alanında bir konferans başlatılır. google.workspace.meet.conference.v2.started conferenceRecord
Toplantı alanında bir konferans sona erdiğinde google.workspace.meet.conference.v2.ended conferenceRecord
Bir katılımcı, toplantı alanındaki etkin bir konferansa katıldığında google.workspace.meet.participant.v2.joined conferenceRecord.participantSession
Bir katılımcı, toplantı alanında etkin bir konferanstan ayrılırsa google.workspace.meet.participant.v2.left conferenceRecord.participantSession
Toplantı alanında bir konferans için kayıt başlatılır. google.workspace.meet.recording.v2.started conferenceRecord.recording
Toplantı alanındaki bir konferansın kaydı sona erdiğinde google.workspace.meet.recording.v2.ended conferenceRecord.recording
Toplantı alanındaki bir konferans için kayıt dosyası oluşturulur. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
Toplantı alanında bir konferans için transkript başlatılır. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
Toplantı alanındaki bir konferansın transkripti sona erdiğinde google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
Toplantı alanındaki bir konferans için transkript dosyası oluşturulur. google.workspace.meet.transcript.v2.fileGenerated 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ı, etkinliğin yükünü içerir. Bu yük, değişen Google Workspace kaynağı hakkında bilgi içerir. Örneğin, bir alandaki yeni transkriptlerle ilgili etkinliklere abone olduysanız bu etkinliklerin yükü, değişen transcripts 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, toplantı alanını tanımlamak için konferans kaydı kimliği (ör. conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) 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ında bir konferans başlatılır veya sonlandırılır.
  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

Kaynak verileri hariç tutulur:

{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
Bir katılımcı Meet toplantı alanında konferansa katılır veya konferanstan ayrılırsa
  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left

Kaynak verileri hariç tutulur:

{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
Meet toplantı alanında bir konferans için kayıt başlatıldığında, sonlandırıldığında veya dosya oluşturulduğunda
  • google.workspace.meet.recording.v2.started
  • google.workspace.meet.recording.v2.ended
  • google.workspace.meet.recording.v2.fileGenerated

Kaynak verileri hariç tutulur:

{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
Meet toplantı alanında bir konferans için transkript başlatıldığında, sonlandırıldığında veya dosya oluşturulduğunda
  • google.workspace.meet.transcript.v2.started
  • google.workspace.meet.transcript.v2.ended
  • google.workspace.meet.transcript.v2.fileGenerated

Kaynak verileri hariç tutulur:

{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}

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.