Method: spaces.create

• Permintaan HTTP
• Parameter kueri
• Isi permintaan
• Isi respons
• Cakupan otorisasi
• Cobalah!

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 di Pratinjau Developer 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 mengautentikasi 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, tetapkan space.permission_settings.manage_apps ke managersAllowed.

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

• Mode impor: Tidak ada anggota yang dibuat.
• Semua mode lainnya: Pengguna yang menelepon 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 yang berbeda. 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. Sebaiknya gunakan UUID acak. 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.