Membuat ruang dan menambahkan pengguna tertentu ke dalamnya. Pengguna yang menelepon akan otomatis ditambahkan ke ruang, dan tidak boleh ditetapkan sebagai keanggotaan dalam permintaan. Untuk contohnya, lihat Menyiapkan ruang dengan anggota awal.
Untuk menentukan anggota manusia yang akan ditambahkan, tambahkan keanggotaan dengan member.name
yang sesuai di SetUpSpaceRequest
. Untuk menambahkan pengguna manusia, gunakan users/{user}
, dengan {user}
dapat menjadi alamat email pengguna tersebut. Untuk pengguna di organisasi Workspace yang sama, {user}
juga dapat berupa id
untuk pengguna dari People API, atau id
untuk pengguna di Directory API. Misalnya, jika ID profil Orang People API untuk user@example.com
adalah 123456789
, Anda dapat menambahkan pengguna ke ruang dengan menyetel membership.member.name
ke users/user@example.com
atau users/123456789
.
Untuk ruang atau chat grup, jika penelepon memblokir atau diblokir oleh beberapa anggota, anggota tersebut tidak akan ditambahkan ke ruang yang dibuat.
Untuk membuat pesan langsung (DM) antara pengguna yang melakukan panggilan dan pengguna manusia lainnya, tentukan satu keanggotaan untuk mewakili pengguna manusia. Jika satu pengguna memblokir pengguna yang lain, permintaan akan gagal dan DM tidak akan dibuat.
Untuk membuat DM antara pengguna yang melakukan panggilan dan aplikasi panggilan, tetapkan Space.singleUserBotDm
ke true
dan jangan tetapkan keanggotaan apa pun. Anda hanya dapat menggunakan metode ini untuk menyiapkan DM dengan aplikasi panggilan. Untuk menambahkan aplikasi panggilan sebagai anggota ruang atau DM yang sudah ada antara dua pengguna manusia, lihat Mengundang atau menambahkan pengguna atau aplikasi ke ruang.
Jika DM sudah ada di antara dua pengguna, meskipun salah satu pengguna memblokir pengguna lainnya saat permintaan dibuat, DM yang ada akan ditampilkan.
Ruang dengan balasan berangkai tidak didukung. Jika Anda menerima pesan error ALREADY_EXISTS
saat menyiapkan ruang, coba displayName
lain. Ruang yang sudah ada dalam organisasi Google Workspace mungkin sudah menggunakan nama tampilan ini.
Memerlukan autentikasi pengguna.
Permintaan HTTP
POST https://chat.googleapis.com/v1/spaces:setup
URL menggunakan sintaksis gRPC Transcoding.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "space": { object ( |
Kolom | |
---|---|
space |
Wajib. Kolom Untuk membuat ruang, tetapkan Untuk membuat chat grup, tetapkan Untuk membuat percakapan 1:1 antarmanusia, tetapkan Untuk membuat percakapan 1:1 antara manusia dan aplikasi Chat panggilan, tetapkan Jika ruang |
requestId |
Opsional. ID unik untuk permintaan ini. Sebaiknya gunakan UUID acak. Menentukan ID permintaan yang ada akan mengembalikan 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. |
memberships[] |
Opsional. Pengguna Google Chat yang akan diundang untuk bergabung ke ruang. Abaikan pengguna yang melakukan panggilan, karena pengguna tersebut ditambahkan secara otomatis. Set saat ini memungkinkan hingga 20 keanggotaan (selain pemanggil). Kolom Opsional saat menetapkan Wajib saat Wajib saat Harus kosong saat membuat percakapan 1:1 antara manusia dan aplikasi Chat panggilan (saat menetapkan |
Isi respons
Jika berhasil, isi respons akan berisi instance Space
.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.create
Untuk informasi selengkapnya, lihat Panduan otorisasi.