Mengonfigurasi setelan ruang rapat

Ruang rapat mewakili tempat virtual atau objek persisten (seperti ruang rapat) tempat konferensi diadakan. Ruang pertemuan juga membantu pengguna bertemu dan menemukan sumber daya bersama.

Saat Anda membuat ruang rapat menggunakan metode spaces.create, metode ini akan menampilkan instance resource spaces. Resource mencakup objek SpaceConfig yang merupakan konfigurasi untuk ruang rapat. Objek ini juga berisi ActiveConference yang merupakan link ke conferenceRecords resource saat ini dalam ruang rapat. Untuk mengetahui informasi selengkapnya tentang mengelola ruang rapat, lihat Mengelola ruang rapat.

Bagian berikut menjelaskan secara mendetail cara mengonfigurasi ruang rapat menggunakan objek dan metode ini.

Menetapkan moderasi dan akses rapat

Anda dapat menetapkan cara pengguna bergabung ke rapat, mode moderasi, pembatasan fitur, dan izin yang diterima pengguna saat bergabung ke rapat, melalui objek SpaceConfig.

Mengakses ruang rapat

Untuk menentukan siapa yang dapat bergabung ke ruang rapat tanpa meminta izin masuk, tetapkan kolom accessType menggunakan objek AccessType. Anda dapat memilih dari beberapa setelan tentang apakah peserta diizinkan bergabung secara otomatis atau tidak. Secara default, kolom ini akan diisi dengan setelan akses default pengguna.

Untuk menentukan titik entri yang dapat digunakan untuk bergabung ke rapat yang dihosting di ruang rapat, tetapkan kolom entryPointAccess menggunakan objek EntryPointAccess. Setel ke ALL untuk mengizinkan semua titik entri atau CREATOR_APP_ONLY untuk mencakup titik entri hanya ke titik entri yang dimiliki oleh project Google Cloud yang membuat ruang rapat.

Contoh kode berikut menunjukkan cara mengonfigurasi setelan akses untuk ruang rapat:

Java

import com.google.apps.meet.v2.Space;
import com.google.apps.meet.v2.SpaceConfig;
import com.google.apps.meet.v2.SpacesServiceClient;
import com.google.apps.meet.v2.UpdateSpaceRequest;
import com.google.protobuf.FieldMask;

public class ConfigureSpaceAccess {
  public static void main(String[] args) throws Exception {
    try (SpacesServiceClient client = SpacesServiceClient.create()) {
      Space space =
          Space.newBuilder()
              .setName("spaces/SPACE_NAME")
              .setConfig(
                  SpaceConfig.newBuilder()
                      .setAccessType(SpaceConfig.AccessType.RESTRICTED)
                      .setEntryPointAccess(SpaceConfig.EntryPointAccess.ALL)
                      .build())
              .build();
      FieldMask updateMask =
          FieldMask.newBuilder()
              .addPaths("config.access_type")
              .addPaths("config.entry_point_access")
              .build();
      UpdateSpaceRequest request =
          UpdateSpaceRequest.newBuilder()
              .setSpace(space)
              .setUpdateMask(updateMask)
              .build();
      Space response = client.updateSpace(request);
      System.out.println("Updated space: " + response.getName());
    }
  }
}

Node.js

const {SpacesServiceClient} = require('@google-apps/meet').v2;

async function configureSpaceAccess(spaceName) {
  const meetClient = new SpacesServiceClient();
  const [response] = await meetClient.updateSpace({
    space: {
      name: spaceName,
      config: {
        accessType: 'RESTRICTED',
        entryPointAccess: 'ALL',
      },
    },
    updateMask: {
      paths: ['config.access_type', 'config.entry_point_access'],
    },
  });
  console.log(`Updated space: ${response.name}`);
  return response;
}

Python

from google.apps import meet_v2
from google.protobuf import field_mask_pb2

def configure_space_access(space_name):
    client = meet_v2.SpacesServiceClient()
    space = meet_v2.Space(
        name=space_name,
        config=meet_v2.SpaceConfig(
            access_type=meet_v2.SpaceConfig.AccessType.RESTRICTED,
            entry_point_access=meet_v2.SpaceConfig.EntryPointAccess.ALL,
        ),
    )
    update_mask = field_mask_pb2.FieldMask(
        paths=["config.access_type", "config.entry_point_access"]
    )
    request = meet_v2.UpdateSpaceRequest(
        space=space,
        update_mask=update_mask
    )
    response = client.update_space(request=request)
    print(f"Updated space: {response.name}")
    return response

Apps Script

function configureSpaceAccess(spaceName) {
  const baseUrl = 'https://meet.googleapis.com/v2/';
  const mask = 'updateMask=config.accessType,config.entryPointAccess';
  const response = UrlFetchApp.fetch(`${baseUrl}${spaceName}?${mask}`, {
    method: 'patch',
    contentType: 'application/json',
    headers: {
      Authorization: 'Bearer ' + ScriptApp.getOAuthToken(),
    },
    payload: JSON.stringify({
      config: {
        accessType: 'RESTRICTED',
        entryPointAccess: 'ALL',
      },
    }),
  });
  const space = JSON.parse(response.getContentText());
  Logger.log('Updated space: ' + space.name);
  return space;
}

cURL

curl -X PATCH \
  "https://meet.googleapis.com/v2/spaces/SPACE_NAME?updateMask=config.accessType,config.entryPointAccess" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "accessType": "RESTRICTED",
      "entryPointAccess": "ALL"
    }
  }'

Ganti ACCESS_TOKEN dengan token akses yang memberikan akses ke API.

Ganti nilai nama ruang dengan ID unik yang dibuat server untuk ruang rapat.

Memoderasi ruang rapat

Untuk memoderasi rapat, Anda dapat menyetel kolom moderation menggunakan objek Moderation. Jika mode moderation adalah on, penyelenggara rapat memiliki kontrol atas rapat dengan fitur seperti pengelolaan co-host (lihat spaces.members) dan pembatasan fitur menggunakan kolom moderationRestrictions. Untuk mengetahui informasi selengkapnya tentang anggota, lihat Mengelola anggota ruang rapat.

Untuk menentukan batasan fitur saat rapat dimoderasi (moderation adalah on), tetapkan kolom moderationRestrictions menggunakan objek ModerationRestrictions. Pembatasan menentukan siapa yang memiliki izin dalam ruang rapat untuk mengirim pesan atau reaksi chat, atau membagikan layar.

Untuk menyetel batasan fitur pada kolom moderationRestrictions, gunakan RestrictionType untuk menerapkan chatRestriction, reactionRestriction, dan presentRestriction. Setel ke HOSTS_ONLY untuk menerapkan izin ke penyelenggara rapat dan rekan penyelenggara, atau NO_RESTRICTION untuk menerapkan ke semua peserta.

Untuk membatasi peran default yang ditetapkan kepada pengguna sebagai pelihat, tetapkan kolom defaultJoinAsViewerType menggunakan DefaultJoinAsViewerType. Jika defaultJoinAsViewerType adalah on, pengguna bergabung sebagai penonton. Jika off, pengguna bergabung sebagai kontributor. Default-nya adalah off. Jika peran eksplisit ditetapkan untuk pengguna di spaces.members, pengguna akan bergabung dengan peran tersebut.

Membuat laporan kehadiran

Untuk membuat laporan kehadiran untuk ruang pertemuan, tetapkan kolom attendanceReportGenerationType menggunakan objek AttendanceReportGenerationType. Jika laporan diminta, Google Meet akan menyimpan laporan kehadiran ke Google Drive penyelenggara rapat dan email juga akan dikirim.

Mengelola artefak otomatis

Penyelenggara rapat, tetapi bukan rekan penyelenggara, dapat mengonfigurasi perekaman otomatis, transkrip otomatis, dan catatan cerdas dalam ruang rapat. Jika setelan ini diaktifkan, ruang rapat akan direkam, transkrip akan dibuat, dan catatan rapat akan dibuat serta diatur ke dalam Google Dokumen secara otomatis. Setiap fitur bersifat independen dan ditetapkan per ruang rapat. Teks rekaman hanya tersedia dalam bahasa Inggris.

Anda dapat mengonfigurasi artefak otomatis sebelumnya saat membuat ruang pertemuan atau setelah ruang pertemuan dibuat. Kedua metode memerlukan cakupan OAuth meetings.space.settings. Untuk mengetahui informasi selengkapnya, lihat Cakupan OAuth menurut kasus penggunaan.

Anda juga dapat menyiapkan artefak otomatis untuk rapat yang dibuat dari Google Kalender.

Untuk menyetel artefak otomatis, gunakan objek ArtifactConfig dalam objek SpaceConfig. ArtifactConfig terdiri dari kolom recordingConfig, transcriptionConfig, dan smartNotesConfig.

Setiap kolom dipetakan ke objek serupa seperti RecordingConfig, TranscriptionConfig, dan SmartNotesConfig. Untuk menyetel setiap objek, gunakan AutoGenerationType untuk mengganti objek konfigurasi on atau off.

Untuk mengambil artefak yang dibuat selama konferensi, lihat Bekerja dengan artefak.

Perbedaan antara transkrip dan catatan pintar

Meskipun transkrip rapat dan catatan cerdas (juga dikenal sebagai "buat catatan untuk saya") merekam informasi dari rapat Anda, fitur ini memiliki tujuan yang berbeda dan menghasilkan artefak yang berbeda.

Tabel berikut menunjukkan perbedaannya:

Fitur Transkrip Catatan cerdas
Ringkasan Catatan kata demi kata yang persis sama dengan yang diucapkan. Ringkasan singkat poin-poin penting yang dibuat oleh Gemini.
Tingkat detail Detail 100%. Semua yang diucapkan akan ditulis. Tingkat tinggi. Berfokus pada keputusan dan item tindakan.
Kasus penggunaan Kepatuhan hukum, memeriksa kutipan persis, dan aksesibilitas pengguna. Memungkinkan peserta yang terlambat bergabung untuk mengejar ketinggalan secara instan; mengotomatiskan pencatatan notulen dan pelacakan project.
Penggunaan real-time Digunakan untuk teks. File dibuat setelah panggilan. Anda dapat melihat ringkasan yang dibuat di panel samping selama panggilan.
Output Dokumen panjang Docs dengan nama pembicara dan stempel waktu. Dokumen Dokumen yang ringkas berisi catatan rapat dengan bagian dan poin butir.
Kutipan Berisi teks lengkap yang dapat ditautkan. Mencakup kutipan (stempel waktu) yang ditautkan kembali ke momen tertentu dalam transkrip untuk konteks, jika transkrip dan catatan smart diaktifkan. Untuk mengetahui informasi selengkapnya, lihat Jika kedua fitur diaktifkan.

Saat kedua fitur diaktifkan

Meskipun setiap fitur dapat digunakan secara terpisah, transkrip dan catatan cerdas juga dapat digunakan secara bersamaan untuk membuat artefak pasca-rapat yang lebih baik.

Jika keduanya diaktifkan, Anda akan melihat kutipan dalam dokumen catatan pintar yang dibuat. Kutipan ini terletak di seluruh bagian detail dan ditautkan ke stempel waktu tertentu dalam transkrip rapat. Dengan mengklik kutipan ini, Anda dapat langsung membuka bagian yang relevan dalam transkrip untuk mendapatkan pemahaman yang lebih mendalam tentang diskusi.

Selama rapat, peserta akan melihat indikator bahwa kedua fitur tersebut aktif. Mereka harus tetap aktif selama rapat berlangsung untuk membuat kutipan yang dapat diklik. Meskipun file saling terkait, sistem tetap membuat dua dokumen berbeda di Drive host. Kedua file juga dilampirkan secara otomatis ke acara Kalender.

Untuk mengetahui informasi selengkapnya tentang cakupan OAuth yang diperlukan untuk ruang rapat dan setelan, lihat Cakupan OAuth menurut kasus penggunaan.