Toplantı alanı, konferansların düzenlendiği sanal bir yeri veya kalıcı bir nesneyi (toplantı odası gibi) temsil eder. Toplantı alanları, kullanıcıların bir araya gelmesine ve paylaşılan kaynakları bulmasına da yardımcı olur.
spaces.create yöntemini kullanarak bir toplantı alanı oluşturduğunuzda bu yöntem, spaces kaynağının bir örneğini döndürür. Kaynak, toplantı alanının yapılandırması olan SpaceConfig nesnesini içerir. Ayrıca, toplantı alanındaki mevcut conferenceRecordskaynağın bağlantısı olan ActiveConferencenesnesi de bu öğede bulunur. Toplantı alanını yönetme hakkında daha fazla bilgi için Toplantı alanı oluşturma ve yönetme başlıklı makaleyi inceleyin.
Aşağıdaki bölümlerde, bu nesne ve yöntemleri kullanarak toplantı alanının nasıl yapılandırılacağı ayrıntılı olarak açıklanmıştır.
Moderasyon ve toplantı erişimini ayarlama
Kullanıcıların toplantılara nasıl katılacağını, moderasyon modlarını, özellik kısıtlamalarını ve kullanıcıların toplantılara katıldıklarında hangi izinleri alacağını SpaceConfig nesnesini kullanarak ayarlayabilirsiniz.
Toplantı alanlarına erişim
Toplantı alanına kimlerin katılım isteği göndermeden katılabileceğini belirlemek için AccessType nesnesini kullanarak accessType alanını ayarlayın.
Katılımcıların otomatik olarak katılmasına izin verilip verilmeyeceğine dair birden fazla ayar arasından seçim yapabilirsiniz. Alan, varsayılan olarak kullanıcının varsayılan erişim ayarlarını kullanır.
Toplantı alanında barındırılan toplantılara katılmak için kullanılabilecek giriş noktalarını tanımlamak üzere EntryPointAccess nesnesini kullanarak entryPointAccess alanını ayarlayın. Tüm giriş noktalarına izin vermek için ALL'e veya giriş noktalarını yalnızca toplantı alanını oluşturan Google Cloud projesine ait olanlarla sınırlamak için CREATOR_APP_ONLY'e ayarlayın.
Katılım raporu oluşturma
Toplantı alanı için katılım raporu oluşturmak istiyorsanız AttendanceReportGenerationType nesnesini kullanarak attendanceReportGenerationType boole alanını ayarlayın. Rapor istenirse Google Meet, katılım raporunu toplantıyı düzenleyen kullanıcının Google Drive'ına kaydeder ve bir e-posta da gönderir.
Toplantı alanlarını yönetme
Bir toplantıyı yönetmek için Moderation nesnesini kullanarak doğru/yanlış moderation alanını ayarlayabilirsiniz.
moderation modu on olduğunda toplantıyı düzenleyen kullanıcı, yardımcı düzenleyen yönetimi (spaces.members bölümüne bakın) ve moderationRestrictions alanını kullanarak özellik kısıtlamaları gibi özelliklerle toplantıyı kontrol eder. Üyeler hakkında daha fazla bilgi için Alan üyelerini yönetme başlıklı makaleyi inceleyin.
Toplantı moderatörlüyken (moderation on ise) özellik kısıtlamalarını tanımlamak için ModerationRestrictions nesnesini kullanarak moderationRestrictions alanını ayarlayın. Kısıtlamalar, toplantı alanında sohbet mesajı veya tepki gönderme ya da ekranını paylaşma izninin kimlere ait olduğunu tanımlar.
moderationRestrictions alanındaki özellik kısıtlamalarını ayarlamak için chatRestriction, reactionRestriction, presentRestriction değerlerini uygulamak üzere RestrictionType enumerasyonunu kullanın. İzinleri hem toplantıyı düzenleyen hem de yardımcı düzenleyen için uygulamak üzere HOSTS_ONLY olarak ayarlayın veya tüm katılımcılar için uygulamak üzere NO_RESTRICTION olarak ayarlayın.
Kullanıcılara görüntüleyici olarak atanan varsayılan rolü kısıtlamak için DefaultJoinAsViewerTypeenum'unu kullanarak boole defaultJoinAsViewerType alanını ayarlayın. defaultJoinAsViewerType on ise kullanıcılar izleyici olarak katılır. off ise kullanıcılar katkıda bulunan olarak katılır. Varsayılan değer off'tir. spaces.members'te bir kullanıcı için açık bir rol ayarlanırsa kullanıcı bu rolde katılır.
Otomatik yapıları yönetme
Toplantıyı düzenleyenler, yardımcı düzenleyenler değil, otomatik kaydı, otomatik transkriptleri ve "benim için not al" özelliğini toplantı alanında önceden yapılandırabilir. Bu ayarlar etkinleştirildiğinde toplantı alanı kaydedilir, transkriptler oluşturulur ve toplantı notları alınıp otomatik olarak Google Dokümanlar'da düzenlenir. Her özellik bağımsızdır ve toplantı alanı başına ayarlanır. Kayıt altyazılarını yalnızca İngilizce olarak görebilirsiniz.
Otomatik yapıları toplantı alanı oluştururken veya toplantı alanı oluşturulduktan sonra önceden yapılandırabilirsiniz. Bu özellik, Google Takvim'den oluşturulan toplantılar için otomatik yapı taşlarını da ayarlamanıza olanak tanır. Her iki yöntem için de meetings.space.settings OAuth kapsamı gerekir. Daha fazla bilgi için Ayarlar için OAuth kapsamları başlıklı makaleyi inceleyin.
Otomatik yapıları ayarlamak için SpaceConfig nesnesinin altındaki ArtifactConfig nesnesini kullanın. ArtifactConfig, recordingConfig, transcriptionConfig ve smartNotesConfig alanlarından oluşur.
Her alan, RecordingConfig, TranscriptionConfig ve SmartNotesConfig gibi benzer bir nesneyle eşlenir. Her bir nesneyi ayarlamak için AutoGenerationType on veya off yapılandırma nesnesini değiştirmek üzere boole enum'unu kullanın.
Ayarlar için OAuth kapsamları
Toplantı ayarlarını belirlemek veya bu ayarlara erişmek için aşağıdaki OAuth kapsamları gerekir:
| Kullanım alanı | Kapsam kodu |
|---|---|
| Diğer uygulamalar tarafından oluşturulan alanlar için otomatik yapı oluşturma ayarını yapın. | https://www.googleapis.com/auth/meetings.space.settings |
| Diğer uygulamalar tarafından oluşturulan konferanslardaki yapıları alma veya listeleme. | https://www.googleapis.com/auth/meetings.space.readonly |
| Üçüncü taraf uygulaması tarafından oluşturulan bir toplantı alanının diğer toplantı öncesi ayarlarını alın veya listeleyin. | https://www.googleapis.com/auth/meetings.space.createdhttps://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ı okuyabilir ve düzenleyebilir. | https://www.googleapis.com/auth/meetings.space.settings |
OAuth kapsamları hakkında daha fazla bilgi için Meet REST API kapsamları başlıklı makaleyi inceleyin.
Alan üyelerini yönetme
Toplantıyı düzenleyenler her zaman katılım isteği göndermeden toplantıya girebilir. Ayrıca, toplantıya katılım isteği göndermeden katılacak ek üyeler de yapılandırabilirsiniz.
Ayrıca, üyeler toplantıda COHOST gibi bir role sahip olacak şekilde yapılandırılabilir. Bu rol, toplantıyı düzenleyen kullanıcıyla aynı toplantı yönetimi özelliklerini sağlar. Toplantı mekanına kapıyı çalmaya gerek kalmadan erişme hakkında daha fazla bilgi için AccessType başlıklı makaleyi inceleyin.
spaces.members kaynağı name, user ve role alanlarını içerir.
Üyelerin katılımcılardan farklı olduğunu unutmayın. Katılımcı, görüşmeye katılan veya Tamamlayıcı Mod'u kullanarak izleyici olarak izleyen bir kişi ya da görüşmeye bağlı bir oda cihazıdır. Her kişi için bir conferenceRecords.participants
kaynak vardır.
Alan üyelerini aşağıdaki yöntemlerle yönetebilirsiniz:
Her yöntem, toplantı alanını belirtmek için parent alanını kullanan oluşturma ve listeleme yöntemleriyle ve sonuçları toplantı alanına ve üye adına göre filtrelemek için name alanını kullanan silme ve alma yöntemleriyle bir yol parametresi alır.
Silme dışındaki tüm yöntemler, SystemParameterContext içinde fields parametresini destekler.
fields parametresi atlandığında API yanıtı varsayılan olarak "name,email,role,user" olur.
fields parametresi, yanıt filtreleme için bir FieldMask kullanır. FieldMask, API çağrısı yapanların bir isteğin döndürmesi gereken alanları listelemesi için kullanılan bir yöntemdir. Bir nesnenin yalnızca belirli alanlarının kullanılacağını ve diğer alanların değiştirilmeyeceğini belirtmek için virgülle ayrılmış bir alan listesidir.
FieldMask kullanmak, API'nin gereksiz çalışmalardan kaçınmasına olanak tanır ve performansı artırır. Alan maskesi, oluşturma, alma ve listeleme yöntemleri için kullanılır. Alan maskeleri hakkında daha fazla bilgi için Google E-Tablolar API'nin Alan maskelerini kullanma başlıklı makalesine bakın.