REST Resource: spaces.members

Resource: Membership

Mewakili hubungan keanggotaan di Google Chat, seperti apakah pengguna atau aplikasi Chat diundang ke, menjadi bagian dari, atau tidak ada di ruang.

Representasi JSON 
{
  "name": string,
  "state": enum (MembershipState),
  "role": enum (MembershipRole),
  "createTime": string,
  "deleteTime": string,
  "affiliation": enum (Affiliation),

  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
}
Kolom
name

string

ID. Nama resource keanggotaan, yang ditetapkan oleh server.

Format: spaces/{space}/members/{member}
state

enum (MembershipState)

Hanya output. Status keanggotaan.
role

enum (MembershipRole)

Opsional. Peran pengguna dalam ruang Chat, yang menentukan tindakan yang diizinkan di ruang tersebut.

Kolom ini hanya dapat digunakan sebagai input di members.patch.
createTime

string (Timestamp format)

Opsional. Tidak dapat diubah. Waktu pembuatan keanggotaan, seperti saat anggota bergabung atau diundang untuk bergabung ke ruang. Kolom ini hanya berupa output, kecuali saat digunakan untuk mengimpor keanggotaan historis di ruang mode impor.
deleteTime

string (Timestamp format)

Opsional. Tidak dapat diubah. Waktu penghapusan keanggotaan, seperti saat anggota keluar atau dihapus dari ruang. Kolom ini hanya berupa output, kecuali saat digunakan untuk mengimpor keanggotaan historis di ruang mode impor.
affiliation

enum (Affiliation)

Hanya output. Hubungan pengguna dengan organisasi Workspace yang memiliki ruang. Di ruang yang dimiliki oleh akun konsumen, afiliasi semua anggota adalah EXTERNAL.
Anggota yang terkait dengan keanggotaan ini. Jenis anggota lainnya mungkin didukung pada masa mendatang. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
member

object (User)

Opsional. Pengguna atau aplikasi Google Chat yang sesuai dengan keanggotaan. Jika aplikasi Chat Anda mengautentikasi sebagai pengguna, output akan mengisi name dan type pengguna.
groupMember

object (Group)

Opsional. Grup Google yang sesuai dengan keanggotaan.

Membaca atau mengubah keanggotaan untuk Google Grup memerlukan autentikasi pengguna.
Akhir kolom yang saling eksklusif.

MembershipState

Menentukan hubungan anggota dengan ruang. Status keanggotaan lainnya mungkin didukung pada masa mendatang.

Enum
MEMBERSHIP_STATE_UNSPECIFIED Nilai default. Jangan gunakan.
JOINED Pengguna ditambahkan ke ruang, dan dapat berpartisipasi di ruang.
INVITED Pengguna diundang untuk bergabung ke ruang, tetapi belum bergabung.
NOT_A_MEMBER Pengguna bukan anggota ruang dan tidak memiliki undangan yang menunggu keputusan untuk bergabung ke ruang.

MembershipRole

Mewakili tindakan yang diizinkan pengguna di ruang Chat. Nilai enum lainnya mungkin ditambahkan di masa mendatang.

Enum
MEMBERSHIP_ROLE_UNSPECIFIED Nilai default. Untuk users: orang tersebut bukan anggota ruang, tetapi dapat diundang. Untuk Google Groups: mereka selalu diberi peran ini (nilai enum lainnya dapat digunakan pada masa mendatang).
ROLE_MEMBER

Anggota ruang. Di UI Chat, peran ini disebut Anggota.

Pengguna memiliki izin dasar, seperti mengirim pesan ke ruang. Pengelola dan pemilik dapat memberikan izin tambahan kepada anggota di ruang, termasuk:

  • Menambahkan atau menghapus anggota.
  • Mengubah detail ruang.
  • Mengaktifkan atau menonaktifkan histori.
  • Menyebut semua orang dalam ruang dengan @all.
  • Mengelola aplikasi dan webhook Chat yang diinstal di ruang.

Dalam pesan langsung dan percakapan grup tanpa nama, semua orang memiliki peran ini.
ROLE_MANAGER

Pemilik ruang. Di UI Chat, peran ini disebut Pemilik.

Pengguna memiliki kumpulan lengkap izin ruang untuk mengelola ruang, termasuk:

  • Ubah peran anggota lain di ruang menjadi anggota, pengelola, atau pemilik.
  • Menghapus ruang.

Hanya didukung di SpaceType.SPACE (ruang bernama).

Untuk mempelajari lebih lanjut, lihat Mempelajari lebih lanjut peran Anda sebagai pemilik atau pengelola ruang.
ROLE_ASSISTANT_MANAGER

Pengelola ruang. Di UI Chat, peran ini disebut Pengelola.

Pengguna memiliki semua izin dasar ROLE_MEMBER, dan dapat diberi subset izin administratif oleh pemilik. Secara default, pengelola memiliki semua izin pemilik, kecuali kemampuan untuk:

  • Menghapus ruang.
  • Menjadikan anggota ruang lain sebagai pemilik.
  • Mengubah peran pemilik.

Secara default, izin pengelola mencakup, tetapi tidak terbatas pada:

  • Menjadikan anggota lain sebagai pengelola.
  • Menghapus pesan dalam ruang.
  • Mengelola izin ruang.
  • Menerima notifikasi untuk permintaan bergabung ke ruang jika pengelola memiliki izin "mengelola anggota" di setelan ruang.
  • Membuat ruang dapat ditemukan.

Hanya didukung di SpaceType.SPACE (ruang bernama).

Untuk mempelajari lebih lanjut, lihat Mengelola setelan ruang.

Grup

Grup Google di Google Chat.

Representasi JSON 
{
  "name": string
}
Kolom
name

string

Nama resource untuk Grup Google.

Mewakili grup di Cloud Identity Groups API.

Format: groups/{group}

Afiliasi

Mewakili afiliasi pengguna ke organisasi Google Workspace yang memiliki ruang. Enum ini mungkin memiliki lebih banyak nilai yang ditambahkan pada masa mendatang.

Enum
AFFILIATION_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
INTERNAL Akun yang dikelola oleh organisasi Google Workspace yang sama yang memiliki ruang.
EXTERNAL Akun di luar organisasi Google Workspace yang memiliki ruang (misalnya, akun konsumen, atau akun yang dikelola oleh organisasi Workspace lain).
MANAGED_EXTERNAL Akun yang dikelola oleh organisasi Workspace yang memiliki ruang, tetapi disediakan untuk pengguna yang berada di luar organisasi (misalnya, pengguna Tamu). Untuk mempelajari tamu lebih lanjut, lihat https://support.google.com/chat/answer/16997417.

Metode

create

 Membuat keanggotaan untuk aplikasi Chat yang memanggil, pengguna, atau Grup Google.

delete

 Menghapus keanggotaan.

get

 Menampilkan detail tentang langganan.

list

 Mencantumkan keanggotaan dalam ruang.

patch

 Memperbarui langganan.