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 kesinti nedeniyle bir abonelikte kaçırmış olabileceğiniz etkinlikleri yakalayabilirsiniz. Meet etkinliklerini alma ve yanıtlama yöntemleri hakkında bilgi edinmek için Meet belgelerindeki Google Meet'teki etkinliklere yanıt verme başlıklı makaleyi inceleyin.
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'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 kayıt başlatıldığında, sonlandırıldığında veya konferans için bir dosya oluşturulduğunda
- Bir akıllı not başlatıldığında, sona erdiğinde veya bir konferans için dosya oluşturulduğunda Geliştirici Önizlemesi
- 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 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 |
|
| Kullanıcı | //cloudidentity.googleapis.com/users/USER
Burada USER, Meet REST API |
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 katılan yeni katılımcılarla 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ında 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 akıllı not başlatılır. Geliştirici Önizlemesi |
google.workspace.meet.smartNote.v2.started |
conferenceRecord.smartNote |
| Toplantı alanındaki bir konferans için akıllı not sona erer. Geliştirici Önizlemesi |
google.workspace.meet.smartNote.v2.ended |
conferenceRecord.smartNote |
| Toplantı alanındaki bir konferans için akıllı not dosyası oluşturulur. Geliştirici Önizlemesi |
google.workspace.meet.smartNote.v2.fileGenerated |
conferenceRecord.smartNote |
| 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 erer. | 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 (örneğin, 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 sona erer.
|
Kaynak verileri hariç tutulur:
{
"conferenceRecord":
{
"name": "conferenceRecords/ |
Bir katılımcı Meet toplantı alanında konferansa katılır veya konferanstan ayrılırsa
|
Kaynak verileri hariç tutulur:
{
"participantSession":
{
"name": "conferenceRecords/ |
Meet toplantı alanında bir konferans için kayıt başlatıldığında, sonlandırıldığında veya dosya oluşturulduğunda
|
Kaynak verileri hariç tutulur:
{
"recording":
{
"name": "conferenceRecords/ |
Meet toplantı alanında bir konferans için akıllı not başlatılır, sonlandırılır veya dosya oluşturulur.
|
Kaynak verileri hariç tutulur:
{
"smartNote":
{
"name": "conferenceRecords/ |
Meet toplantı alanında bir konferans için transkript başlatıldığında, sonlandırıldığında veya dosya oluşturulduğunda
|
Kaynak verileri hariç tutulur:
{
"transcript":
{
"name": "conferenceRecords/ |
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.startedvegoogle.workspace.meet.transcript.v2.fileGenerated.