Google Meet toplantı alanlarına genel bakış

Google Meet REST API illustration

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. Herhangi bir zamanda bir alanda 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ı oluşturma ve yönetme başlıklı makaleyi inceleyin. Toplantı alanını programatik olarak yapılandırma hakkında bilgi edinmek için Toplantı alanlarını ve üyelerini yapılandırma başlıklı makaleyi inceleyin.

Toplantı alanı yöntemlerini çağırma

Aşağıdaki tabloda, toplantı alanı yöntemlerini kullanmak için gereken toplantı rolleri açıklanmaktadır:

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

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

Google 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ının 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 bağlanmak 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 aşağıdaki URL'ye {meetingCode} 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. 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} kullanabilirsiniz. Daha fazla bilgi için Etkin konferansı sonlandırma 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.

  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 bildirimi 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. Konferans sona erdi (STATE=ENDED) ancak yapılar henüz oluşturulmadı. Konferans için startTime ve endTime da doldurulur. Yapı nesnesi STATE, FILE_GENERATED olarak okunana kadar yapı uç noktasına yoklama yapmanız gerekir.

    Anket yapmak yerine Meet etkinliklerine abone olarak push bildirimi alabilirsiniz.

  8. Konferans sonrası dokümanları alma Kayıtlar ve transkriptler gibi yapay ürünleri 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.