Method: spaces.members.create

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 berupa id untuk pengguna dari People API, atau id untuk pengguna di Directory API. Misalnya, jika ID profil Person API People 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 menambahkan atau mengundang grup Google di ruang yang telah diberi nama, gunakan groups/{group}, dengan {group} adalah id untuk grup tersebut dari Cloud Identity Groups API. Misalnya, Anda dapat menggunakan Cloud Identity Groups lookup API guna mengambil ID 123456789 untuk email grup group@example.com, lalu Anda dapat menambahkan atau mengundang grup ke ruang yang telah diberi nama dengan menyetel membership.group_member.name ke groups/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

string

Wajib. Nama resource ruang tempat membuat keanggotaan.

Format: spasi/{space}

Parameter kueri

Parameter
useAdminAccess

boolean

Saat 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 chat.admin.memberships.

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.