Google Meet etkinliklerine abone olma

Bu belgede, uygulamanızın Google Workspace Events API'yi kullanarak abone olabileceği Meet etkinlikleri açıklanmaktadır. İhtiyacınız olan etkinlik türlerine karar verdikten sonra Meet'ten etkinlik almaya başlamak için bir abonelik oluşturun.

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

Meet için uygulama geliştirme hakkında daha fazla bilgi edinmek istiyorsanız 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 etkinlikleri almanıza olanak tanır:

  • Toplantı alanında bir konferans başlar veya biter.
  • Bir katılımcı konferansa katıldığında veya konferanstan ayrıldığında
  • Bir konferans için kayıt başlatıldığında, sona erdiğinde veya dosya oluşturulduğunda.
  • Akıllı not başlatıldığında, sona erdiğinde veya konferans için bir dosya oluşturulduğunda.
  • Bir konferans için transkript başlatılır, sonlandırılır veya dosya oluşturulur.

Etkinlikler için izleyebileceğiniz kaynaklar

Etkinlikleri almak için izlenecek bir Meet kaynağı belirtin. 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 spaces kaynağının kaynak adındaki kimliktir. Ayrıntılı bilgi için Meet, toplantı alanlarını nasıl tanımlar? başlıklı makaleyi inceleyin.

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

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. Genellikle toplantı alanının sahibi, toplantı alanıyla ilişkili Google Takvim etkinliğinin düzenleyicisidir.

Abonelik oluşturma etkinlik türleri

Bir Meet kaynağına abonelik oluşturduğunuzda, almak istediğiniz etkinlik türlerini belirtmek için eventTypes[] alanını kullanın. Etkinlik türleri, CloudEvents spesifikasyonuna göre biçimlendirilir (ör. google.workspace.APPLICATION.RESOURCE.VERSION.ACTION).

Örneğin, bir Meet alanındaki konferansa katılan yeni katılımcılarla ilgili etkinlikleri almak için etkinlik türünü google.workspace.meet.participant.v2.joined olarak belirtin. 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 abonelikler için desteklenen etkinlik türleri gösterilmektedir:

Etkinlik türü Biçim Kaynak verileri
Toplantı alanında bir konferans başlar. 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ındaki etkin bir konferanstan ayrıldığında. google.workspace.meet.participant.v2.left conferenceRecord.participantSession
Toplantı alanındaki bir konferans için kayıt başlatıldığında 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ındaki bir konferans için akıllı not başlatıldığında google.workspace.meet.smartNote.v2.started conferenceRecord.smartNote
Toplantı alanındaki bir konferans için akıllı not sona erdiğinde. google.workspace.meet.smartNote.v2.ended conferenceRecord.smartNote
Toplantı alanındaki bir konferans için akıllı not dosyası oluşturulur. google.workspace.meet.smartNote.v2.fileGenerated conferenceRecord.smartNote
Toplantı alanındaki bir konferans için transkript başlatılır. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
Toplantı alanındaki bir konferans için transkript 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ğı hakkında bilgi içerir.

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 (ö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:

Etkinlik türleri JSON yükü

Meet toplantı alanında bir konferans başlar veya biter.

  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

Kaynak verileri hariç:

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}
      

Bir katılımcı Meet toplantı alanındaki bir konferansa katıldığında veya konferanstan ayrıldığında.

  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left

Kaynak verileri hariç:

{
  "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ç:

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}
      

Meet toplantı alanında bir konferans için akıllı not başlatıldığında, sonlandırıldığında veya dosya oluşturulduğunda

  • google.workspace.meet.smartNote.v2.started
  • google.workspace.meet.smartNote.v2.ended
  • google.workspace.meet.smartNote.v2.fileGenerated

Kaynak verileri hariç:

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}
      

Meet toplantı alanında bir konferans için transkript başlatıldığında, sona erdiğinde 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ç:

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

Sınırlamalar

  • Takvim davetlileri ve bir 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.