Toplantı alanı, konferansların yapıldığı sanal bir yeri veya kalıcı bir nesneyi (ör. toplantı odası) ifade eder. Toplantı alanı, kullanıcıların buluşmasına ve paylaşılan kaynakları bulmasına da yardımcı olur.
spaces.create yöntemini kullanarak toplantı alanı oluşturduğunuzda spaces kaynağının bir örneği döndürülür. Kaynak, toplantı alanının yapılandırması olan SpaceConfig nesnesini içerir. Ayrıca, toplantı alanındaki geçerli conferenceRecords kaynağına bağlantı olan ActiveConference nesnesini de içerir. Toplantı alanı yönetimi 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 nesneleri ve yöntemleri kullanarak toplantı alanı yapılandırma hakkında ayrıntılı bilgi verilmektedir.
Moderasyon ve toplantı erişimini ayarlama
Kullanıcıların toplantıya katılma şeklini, moderasyon modlarını, özellik kısıtlamalarını ve toplantıya katıldıklarında aldıkları izinleri SpaceConfig nesnesi aracılığıyla ayarlayabilirsiniz.
Toplantı alanlarına erişme
Katılım isteği göndermeden toplantı alanına kimlerin katılabileceğini belirlemek için accessType alanını AccessType nesnesini kullanarak ayarlayın.
Katılımcıların otomatik olarak katılmasına izin verilip verilmeyeceğiyle ilgili birden fazla ayar arasından seçim yapabilirsiniz. Bu alan, varsayılan olarak kullanıcının varsayılan erişim ayarlarını kullanır.
Toplantı alanında düzenlenen toplantılara katılmak için kullanılabilecek giriş noktalarını tanımlamak üzere entryPointAccess alanını EntryPointAccess nesnesini kullanarak ayarlayın. Tüm giriş noktalarına izin vermek için ALL, giriş noktalarını yalnızca toplantı alanı oluşturan Google Cloud projesine ait olanlarla sınırlamak için CREATOR_APP_ONLY olarak ayarlayın.
Katılım raporu oluşturma
Toplantı alanı için katılım raporu oluşturmak üzere AttendanceReportGenerationType nesnesini kullanarak boolean attendanceReportGenerationType alanını ayarlayın. Katılım raporu istenirse Google Meet, katılım raporunu toplantıyı düzenleyen kullanıcının Google Drive'ına kaydeder ve e-posta da gönderilir.
Toplantı alanlarını yönetme
Toplantıyı yönetmek için Moderation nesnesini kullanarak boolean moderation alanını ayarlayabilirsiniz.
moderation modu on olduğunda toplantıyı düzenleyen kullanıcı, yardımcı düzenleyen yönetimi (bkz. spaces.members) ve moderationRestrictions alanını kullanarak özellik kısıtlamaları gibi özelliklerle toplantıyı kontrol edebilir. Üyeler hakkında daha fazla bilgi için Alan üyelerini yönetme başlıklı makaleyi inceleyin.
Toplantı yönetilirken özellik kısıtlamalarını tanımlamak için (moderation on), ModerationRestrictions nesnesini kullanarak moderationRestrictions alanını ayarlayın. Kısıtlamalar, toplantı alanında kimlerin sohbet mesajı veya tepki gönderme ya da ekranını paylaşma iznine sahip olduğunu tanımlar.
moderationRestrictions alanında özellik kısıtlamalarını ayarlamak için chatRestriction, reactionRestriction, presentRestriction değerlerini uygulamak üzere RestrictionType enum'ını kullanın. İzinleri hem toplantıyı düzenleyen kişiye hem de yardımcı düzenleyene uygulamak için HOSTS_ONLY, tüm katılımcılara uygulamak için NO_RESTRICTION olarak ayarlayın.
Kullanıcılara görüntüleyici olarak atanan varsayılan rolü kısıtlamak için DefaultJoinAsViewerType enum'ını kullanarak defaultJoinAsViewerType boolean 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'dır. spaces.members içinde bir kullanıcı için açık bir rol ayarlanmışsa kullanıcı bu rolüyle katılır.
Otomatik yapıları yönetme
Toplantıyı düzenleyenler, yardımcı düzenleyenler değil, toplantı alanında otomatik kayıt, otomatik transkript ve "benim için not al" özelliklerini önceden yapılandırabilir. Bu ayarlar etkinleştirildiğinde toplantı alanı kaydedilir, transkriptler oluşturulur ve toplantı notları otomatik olarak Google Dokümanlar'a kaydedilip düzenlenir. Her özellik bağımsızdır ve toplantı alanına göre ayarlanır. Kayıt altyazıları yalnızca İngilizce olarak kullanılabilir.
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 yapay nesneler ayarlamanıza da 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 yapay nesneleri ayarlamak için SpaceConfig nesnesi 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 nesneyi ayarlamak için yapılandırma nesnesi on veya off arasında geçiş yapmak üzere AutoGenerationType Boole enum'ını kullanın.
Ayarlar için OAuth kapsamları
Toplantı ayarlarını belirlemek veya bunlara 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 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.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| Kullanıcının Takvim gibi diğer uygulamalar üzerinden erişebileceği tüm toplantı alanlarının ayarlarını okuyup düzenleme | 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üzenleyen kişiler her zaman katılım isteği göndermeden toplantıya katılabilir. Ayrıca, diğer üyelerin de katılım isteği göndermeden toplantıya katılmasını sağlayabilirsiniz.
Ayrıca, üyeler toplantıda rol sahibi olacak şekilde yapılandırılabilir. Örneğin, COHOST rolü, toplantıyı düzenleyen kullanıcıyla aynı toplantı yönetimi özelliklerini kullanmalarını sağlar. Toplantı alanına kapıyı çalmadan 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.
Üyenin katılımcıdan farklı olduğunu unutmayın. Katılımcı, bir aramaya katılan veya Tamamlayıcı Mod'u kullanan, izleyici olarak izleyen ya da bir aramaya bağlı olan 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öntemde bir yol parametresi kullanılır. Toplantı alanını belirtmek için parent alanı, sonuçları toplantı alanına ve üye adına göre filtrelemek için ise name alanı kullanılır.
Silme hariç tüm yöntemler, SystemParameterContext içinde fields parametresini destekler.
fields parametresi kullanılmadığında API yanıtı varsayılan olarak "name,email,role,user" olur.
fields parametresi, yanıt filtreleme için FieldMask'e bağlıdır. FieldMask, API çağrılarını yapanların bir isteğin döndürmesi gereken alanları listelemesinin bir yoludur. Bu, bir nesnede yalnızca belirli alanların kullanılacağını, diğer alanların ise değiştirilmeyeceğini belirtmek için kullanılan, virgülle ayrılmış bir alan listesidir.
FieldMask kullanmak, API'nin gereksiz işlerden kaçınmasını sağlar 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'sinin Alan maskelerini kullanma başlıklı makalesini inceleyin.