Method: spaces.create

Membuat ruang. Dapat digunakan untuk membuat ruang bernama, atau chat grup di Import mode. Untuk mengetahui contohnya, lihat Membuat ruang.

Mendukung jenis autentikasi berikut:

  • Autentikasi aplikasi dengan persetujuan administrator dan salah satu cakupan otorisasi berikut:

    • https://www.googleapis.com/auth/chat.app.spaces.create
    • https://www.googleapis.com/auth/chat.app.spaces
  • Autentikasi pengguna dengan salah satu cakupan otorisasi berikut:

    • https://www.googleapis.com/auth/chat.spaces.create
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (khusus ruang mode impor)

Saat mengautentikasi sebagai aplikasi, kolom space.customer harus ditetapkan dalam permintaan.

Saat melakukan autentikasi sebagai aplikasi, aplikasi Chat akan ditambahkan sebagai anggota ruang. Namun, tidak seperti autentikasi manusia, aplikasi Chat tidak ditambahkan sebagai pengelola ruang. Secara default, aplikasi Chat dapat dihapus dari ruang oleh semua anggota ruang. Untuk mengizinkan hanya pengelola ruang menghapus aplikasi dari ruang, setel space.permission_settings.manage_apps ke managersAllowed.

Keanggotaan ruang saat pembuatan bergantung pada apakah ruang dibuat di Import mode:

  • Mode impor: Tidak ada anggota yang dibuat.
  • Semua mode lainnya: Pengguna yang memanggil ditambahkan sebagai anggota. Ini adalah:
    • Aplikasi itu sendiri saat menggunakan autentikasi aplikasi.
    • Pengguna manusia saat menggunakan autentikasi pengguna.

Jika Anda menerima pesan error ALREADY_EXISTS saat membuat ruang, coba displayName lain. Ruang yang ada dalam organisasi Google Workspace mungkin sudah menggunakan nama tampilan ini.

Permintaan HTTP

POST https://chat.googleapis.com/v1/spaces

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
requestId

string

Opsional. ID unik untuk permintaan ini. UUID acak direkomendasikan. Menentukan ID permintaan yang ada akan menampilkan ruang yang dibuat dengan ID tersebut, bukan membuat ruang baru. Menentukan ID permintaan yang ada dari aplikasi Chat yang sama dengan pengguna terautentikasi yang berbeda akan menampilkan error.

Isi permintaan

Isi permintaan memuat instance Space.

Isi respons

Jika berhasil, isi respons memuat instance Space yang baru dibuat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.