Method: spaces.create

Membuat ruang. Dapat digunakan untuk membuat ruang bernama, atau chat grup dalam Import mode. Untuk 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 melakukan autentikasi 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 hanya mengizinkan pengelola ruang menghapus aplikasi dari ruang, tetapkan space.permission_settings.manage_apps ke managersAllowed.

Keanggotaan ruang saat pembuatan bergantung pada apakah ruang dibuat dalam 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 yang lain. Ruang yang ada dalam organisasi Google Workspace mungkin sudah menggunakan nama tampilan ini.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
requestId

string

Opsional. ID unik untuk permintaan ini. UUID acak direkomendasikan. Menentukan ID permintaan membuat permintaan menjadi idempoten, yang memastikan bahwa beberapa permintaan identik dengan ID permintaan yang sama hanya akan menghasilkan satu ruang yang dibuat. Permintaan berikutnya dengan ID permintaan yang sama akan menampilkan ruang yang ada dan tidak memperbarui ruang, meskipun detail yang diminta berbeda dari status saat ini.

Untuk menggunakan kolom ini secara efektif:

  • Pastikan permintaan berikutnya identik dan menggunakan kredensial autentikasi yang sama dengan permintaan asli.
  • Jika ruang sudah dibuat dengan ID permintaan yang diberikan, permintaan akan menampilkan ruang tersebut. Perhatikan bahwa ruang yang ditampilkan mungkin tidak terisi sepenuhnya; API akan mengulang ruang dalam permintaan Anda dengan nama resource yang ditetapkan sistem. Untuk mengambil metadata terbaru untuk ruang, panggil spaces.get.
  • Menggunakan kembali ID permintaan yang ada dengan pengguna yang diautentikasi yang berbeda akan menghasilkan error.

Isi permintaan

Isi permintaan memuat instance Space.

Isi respons

Jika berhasil, isi respons akan 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.