REST Resource: spaces.members

Resource: Membership

Mewakili hubungan keanggotaan di Google Chat, seperti apakah pengguna atau aplikasi Chat diundang ke, merupakan 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

Pengenal. 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 output, kecuali jika 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 output, kecuali jika 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.
Kolom union memberType. Anggota yang terkait dengan keanggotaan ini. Jenis anggota lainnya mungkin akan didukung di masa mendatang. memberType hanya dapat berupa salah satu dari berikut:
member

object (User)

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

object (Group)

Opsional. Grup Google yang sesuai dengan keanggotaan.

Membaca atau mengubah keanggotaan untuk Grup Google memerlukan autentikasi pengguna.

MembershipState

Menentukan hubungan anggota dengan ruang. Status keanggotaan lainnya mungkin akan didukung di 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 tertunda untuk bergabung ke ruang.

MembershipRole

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

Enum
MEMBERSHIP_ROLE_UNSPECIFIED Nilai default. Untuk users: mereka bukan anggota ruang, tetapi dapat diundang. Untuk Google Groups: mereka selalu diberi peran ini (nilai enum lainnya mungkin akan digunakan di 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 di ruang dengan @all.
  • Mengelola aplikasi Chat dan webhook 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 izin ruang lengkap untuk mengelola ruang, termasuk:

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

Hanya didukung di SpaceType.SPACE (ruang yang diberi nama).

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 diberikan 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 di 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 yang diberi nama).

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 akan ditambahkan lebih banyak nilai di masa mendatang.

Enum
AFFILIATION_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
INTERNAL Akun yang dikelola oleh organisasi Google Workspace yang sama dengan 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 keanggotaan.

list

 Mencantumkan keanggotaan di ruang.

patch

 Memperbarui keanggotaan.