Google Meet toplantı alanlarına genel bakış

spaces.create yöntemini kullanarak Google Meet alanı oluşturma

Bu kılavuzda, Google Meet REST API'nin Google Meet için toplantı oluşturmanıza ve yönetmenize nasıl olanak tanıdığı açıklanmaktadır.

Toplantı alanı, konferansların yapıldığı sanal bir yeri veya kalıcı bir nesneyi (ör. toplantı odası) ifade eder. Bir alanda herhangi bir zamanda yalnızca bir etkin konferans düzenlenebilir. Toplantı alanı, kullanıcıların buluşmasına ve paylaşılan kaynakları bulmasına da yardımcı olur.

Toplantı alanlarıyla çalışma hakkında bilgi edinmek için Toplantı alanlarını yönetme başlıklı makaleyi inceleyin. Toplantı alanını programatik olarak yapılandırma hakkında bilgi edinmek için Toplantı alanı ayarlarını yapılandırma başlıklı makaleyi inceleyin. Toplantı alanı üyelerini yönetmek için Toplantı alanı üyelerini yönetme başlıklı makaleye bakın.

Toplantı alanı yöntemi izinleri

Aşağıdaki karşılaştırma tablosunda, toplantı alanı yöntemlerini kullanmak için gereken toplantı rolleri ayrıntılı olarak açıklanmaktadır:

Yöntem Sahipler Katılımcı sayısı Diğer
endActiveConference
get
     ayarlarla
     etkin konferansla
patch

Meet, toplantı alanlarını nasıl tanımlar?

Meet REST API, her toplantı alanı için bir spaces kaynağı oluşturur. spaces kaynağı, konferansa katılmak için birden fazla giriş noktası sunar.

Aşağıdaki tabloda, toplantı alanının nasıl tanımlanacağı ve toplantı alanına nasıl katılınacağı gösterilmektedir:

Alan adı Açıklama
name Alan adı. {space} dizesi, alanın kaynak tanımlayıcısıdır ve spaces/{space} olarak biçimlendirilir. Bu, benzersiz ve sunucu tarafından oluşturulan bir kimliktir ve büyük/küçük harfe duyarlıdır. Örneğin, spaces/jQCFfuBOdN5z.
meetingCode Alan adının diğer adı. {meetingCode}, yazılabilir, benzersiz bir karakter dizesidir ve büyük/küçük harfe duyarlı değildir. spaces/{meetingCode} olarak biçimlendirilir. Örneğin, spaces/abc-mnop-xyz. Maksimum uzunluk 128 karakterdir. meetingUri'in bir parçasıdır: https://meet.google.com/abc-mnop-xyz.
phoneAccess Bu toplantı alanına telefonla erişim yöntemleri. phoneAccess nesnesi, toplantı alanının bölgesel telefon numaraları ve bu telefon numarasına özel bir PIN kodu da dahil olmak üzere konferansa telefonla katılmak için gereken bilgileri içerir. PIN yalnızca ondalık basamaklardan oluşur ve uzunluğu değişebilir. Örneğin, "pin": 19707127300.

Meet kullanıcı arayüzüne benzer şekilde, spaces kaynağı sınırlı sayıda aranacak numara içerir. Bir toplantı alanının ek telefon numaralarını görmek için {meetingCode} ifadesini şu URL'ye ekleyin: https://meet.google.com/tel/. Örneğin, https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess Bu toplantı alanı için Oturum Başlatma Protokolü (SIP) erişim yöntemleri. SIP adresi, üçüncü taraf video konferans donanımının Meet konferansını nasıl bulup katılabileceğini ayrıntılı olarak açıklar. The gatewaySipAccess nesnesi bir URI ve sayısal erişim kodu içerir. Meet, SIP URI şemasını destekler.

Toplantı alanını yönetmek için name alanı için aşağıdaki değerleri kullanın:

  • Toplantı alanı hakkında ayrıntılı bilgi edinmek için spaces/{space} veya spaces/{meetingCode} takma adını kullanabilirsiniz. Daha fazla bilgi için Toplantı alanı edinme başlıklı makaleyi inceleyin.

  • Toplantı alanının ayrıntılarını güncellemek için yalnızca spaces/{space} simgesini kullanabilirsiniz. Daha fazla bilgi için Toplantı alanını güncelleme başlıklı makaleyi inceleyin.

  • Bir toplantı alanındaki etkin konferansı sonlandırmak için yalnızca spaces/{space} simgesini kullanabilirsiniz. Daha fazla bilgi için Etkin bir konferansı sonlandırma başlıklı makaleyi inceleyin.

  • Toplantı alanı üyelerini yönetmek için yalnızca spaces/{space} uygulamasını kullanabilirsiniz. {meetingCode} takma adı desteklenmez. Daha fazla bilgi için Toplantı alanı üyelerini yönetme başlıklı makaleyi inceleyin.

Kullanım alanına göre OAuth kapsamları

Meet ile kimlik doğrulama kılavuzunda tüm Meet REST API kapsamları ve bunların doğrulama hassasiyeti katmanları listelenir. Ancak toplantı alanlarıyla çalışırken kapsam gereksinimleri, alanın uygulamanız veya harici bir uygulama (ör. Google Takvim) tarafından oluşturulup oluşturulmadığına bağlı olarak değişir.

Aşağıdaki tabloda, belirli toplantı alanı kullanım alanlarına göre gereken OAuth kapsamları özetlenmiştir:

Kullanım alanı Kapsam kodu
Diğer uygulamalar tarafından oluşturulan alanlar için otomatik yapay nesne oluşturmayı ayarlayın. https://www.googleapis.com/auth/meetings.space.settings
Diğer uygulamalar tarafından oluşturulan konferanslardaki çıktıları alma veya listeleme https://www.googleapis.com/auth/meetings.space.readonly
Üçüncü taraf uygulaması tarafından oluşturulan bir toplantı alanının toplantı öncesi diğer ayarlarını alma veya listeleme. https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
Kullanıcının Takvim gibi başka bir uygulama üzerinden erişebileceği tüm toplantı alanlarının ayarlarını okuma ve düzenleme https://www.googleapis.com/auth/meetings.space.settings

Desteklenen tüm kapsamların ve yetkilendirme hassasiyeti katmanlarının tam listesi için Meet REST API kapsamları başlıklı makaleyi inceleyin.

Toplantı alanının yaşam döngüsü

Bir toplantı alanı, yaşam döngüsü boyunca çeşitli durumlardan geçer. Aşağıdaki şemada, toplantı alanı yaşam döngüsünün üst düzey adımları gösterilmektedir:

Toplantı alanı yaşam döngüsü
Şekil 1. Toplantı alanının yaşam döngüsü.

  1. Ara spaces.create. Toplantı alanı oluşturulur ve döndürülen spaces nesnesi meetingUri dizesini içerir. Ardından meetingUri katılımcılara dağıtılır. Konferans başlamadan önce toplantı alanı ayarlarını yapılandırabilir ve toplantı alanı üyelerini yönetebilirsiniz.

  2. Yeni toplantı alanında anket yapın. Konferans durumunu kontrol etmek için spaces.get yöntemini çağırın.

    Anketlere katılmak yerine Meet etkinliklerine abone olarak push bildirimleri de alabilirsiniz.

  3. Konferansı başlatın. İlk katılımcı toplantı alanında meetingUri simgesini tıkladığında konferans başlar. activeConference nesnesi doldurulur ve activeConference.conferenceRecord dizesi ayarlanır.

  4. (İsteğe bağlı) Konferans verilerini alma Etkin bir konferans sırasında bazı conferenceRecord değerlerine erişebilirsiniz. Örneğin, konferanstaki tüm katılımcıları görmek için conferenceRecords.participants.list yöntemini çağırın. Bu bilgilere konferanstan sonraki 30 gün boyunca da erişebilirsiniz.

  5. (İsteğe bağlı) Konferansı sonlandırın. Konferans sırasında toplantı sahibi, etkin bir konferansı tüm katılımcılar için programatik olarak sonlandırmak üzere spaces.endActiveConference yöntemini çağırabilir.

  6. Konferans sona erer. Son katılımcı ayrıldığında konferans sona erer.

  7. Konferans sonrası çıktıları için anket yapma Konferans sona erdi (STATE=ENDED) ancak yapılar henüz oluşturulmadı. Konferans için startTime ve endTime da doldurulur. Çıktı nesnesi STATE, FILE_GENERATED olarak okunana kadar çıktı uç noktasına düzenli olarak istek göndermeniz gerekir.

    Anket yapmak yerine Meet etkinliklerine abone olarak push bildirimi alabilirsiniz.

  8. Konferans sonrası yapıtları alma Kayıtlar, transkriptler ve akıllı notlar gibi yapayları oluşturulduktan sonra alabilirsiniz. Örneğin, kayıt kimliğine göre kayıt almak için conferenceRecords.recordings.get yöntemini çağırın.

    Hazır olduğunda, yapay nesne nesnesinin URI'si doldurulur ve kaynak nesnenin bir parçası olarak döndürülür.