Method: spaces.patch

Memperbarui ruang. Untuk contoh, lihat Memperbarui ruang.

Jika Anda memperbarui kolom displayName dan menerima pesan error ALREADY_EXISTS, coba nama tampilan yang berbeda. Ruang yang sudah ada dalam organisasi Google Workspace mungkin sudah menggunakan nama tampilan ini.

Memerlukan autentikasi pengguna.

Permintaan HTTP

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
space.name

string

Nama resource ruang.

Format: spaces/{space}

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Wajib diisi. Jalur kolom yang diperbarui, dipisahkan koma jika ada beberapa.

Jalur kolom yang saat ini didukung:

  • displayName (Hanya mendukung perubahan nama tampilan ruang dengan jenis SPACE, atau jika menyertakan mask spaceType juga untuk mengubah jenis ruang GROUP_CHAT menjadi SPACE. Mencoba memperbarui nama tampilan ruang GROUP_CHAT atau DIRECT_MESSAGE akan menghasilkan error argumen yang tidak valid. Jika Anda menerima pesan error ALREADY_EXISTS saat mengupdate displayName, coba displayName lain. Ruang yang sudah ada di organisasi Google Workspace mungkin sudah menggunakan nama tampilan ini.)

  • spaceType (Hanya mendukung perubahan jenis ruang GROUP_CHAT menjadi SPACE. Sertakan displayName bersama dengan spaceType dalam mask update dan pastikan ruang yang ditentukan memiliki nama tampilan yang tidak kosong dan jenis ruang SPACE. Menyertakan mask spaceType dan jenis SPACE di ruang yang ditentukan saat memperbarui nama tampilan bersifat opsional jika ruang yang ada sudah memiliki jenis SPACE. Mencoba memperbarui jenis ruang dengan cara lain akan menghasilkan error argumen yang tidak valid).

  • spaceDetails

  • spaceHistoryState (Mendukung mengaktifkan atau menonaktifkan histori untuk ruang jika organisasi mengizinkan pengguna mengubah setelan histori mereka. Peringatan: saling eksklusif dengan semua jalur kolom lainnya.)

  • Pratinjau Developer: accessSettings.audience (Mendukung perubahan setelan akses ruang. Jika tidak ada audiens yang ditentukan di setelan akses, setelan akses ruang akan diperbarui menjadi dibatasi. Peringatan: saling eksklusif dengan semua jalur kolom lainnya.)

Isi permintaan

Isi permintaan memuat instance Space.

Isi respons

Jika berhasil, isi respons akan berisi instance Space.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

Untuk informasi selengkapnya, lihat Panduan otorisasi.