- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- Cobalah!
Membuat keanggotaan manusia atau keanggotaan aplikasi untuk aplikasi panggilan. Membuat keanggotaan untuk aplikasi lain tidak didukung. Sebagai contoh, lihat Mengundang atau menambahkan pengguna atau aplikasi Google Chat ke ruang. Saat membuat langganan, jika anggota tertentu menonaktifkan kebijakan terima otomatis, mereka akan diundang dan harus menerima undangan ruang sebelum bergabung. Jika tidak, membuat keanggotaan akan menambahkan anggota tersebut secara langsung ke ruang yang ditentukan. Memerlukan autentikasi pengguna.
Untuk menentukan anggota yang akan ditambahkan, setel membership.member.name
untuk anggota manusia atau aplikasi, atau setel membership.group_member.name
untuk anggota grup.
Untuk menambahkan aplikasi panggilan ke ruang atau pesan langsung antara dua pengguna, gunakan
users/app
. Tidak dapat menambahkan aplikasi lain ke ruang.Untuk menambahkan pengguna manusia, gunakan
users/{user}
, dengan{user}
yang dapat berupa alamat email pengguna. Untuk pengguna di organisasi Workspace yang sama,{user}
juga dapat berupaid
untuk pengguna dari People API, atauid
untuk pengguna di Directory API. Misalnya, jika ID profil Person API People untukuser@example.com
adalah123456789
, Anda dapat menambahkan pengguna ke ruang dengan menyetelmembership.member.name
keusers/user@example.com
atauusers/123456789
.Untuk menambahkan atau mengundang grup Google di ruang yang telah diberi nama, gunakan
groups/{group}
, dengan{group}
adalahid
untuk grup tersebut dari Cloud Identity Groups API. Misalnya, Anda dapat menggunakan Cloud Identity Groups lookup API guna mengambil ID123456789
untuk email grupgroup@example.com
, lalu Anda dapat menambahkan atau mengundang grup ke ruang yang telah diberi nama dengan menyetelmembership.group_member.name
kegroups/123456789
. Email grup tidak didukung, dan grup Google hanya dapat ditambahkan sebagai anggota dalam ruang yang diberi nama.
Permintaan HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
parent |
Wajib. Nama resource ruang tempat membuat keanggotaan. Format: spasi/{space} |
Parameter kueri
Parameter | |
---|---|
useAdminAccess |
true , metode akan berjalan menggunakan hak istimewa administrator Google Workspace pengguna.Pengguna yang menelepon harus merupakan administrator Google Workspace dengan hak istimewa mengelola percakapan chat dan ruang. Memerlukan cakupan OAuth 2.0 Pembuatan keanggotaan aplikasi atau membuat keanggotaan untuk pengguna di luar organisasi Google Workspace administrator tidak didukung menggunakan akses admin. |
Isi permintaan
Isi permintaan memuat instance Membership
.
Isi respons
Jika berhasil, isi respons memuat instance Membership
yang baru dibuat.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
Untuk informasi selengkapnya, lihat Panduan otorisasi.