Halaman ini menjelaskan cara menggunakan Google Chat API untuk berbagi ruang Google Chat dengan pengguna tertentu di organisasi Google Workspace, sehingga mereka dapat menemukan dan bergabung ke ruang tersebut.
Untuk menentukan pengguna di organisasi Anda yang dapat menemukan dan bergabung ke ruang, Anda membuat target audiens. Target audiens adalah sekelompok orang—seperti departemen tertentu atau seluruh organisasi—yang dapat Anda ajak berbagi ruang Chat, untuk meningkatkan awareness dan kemudahan berbagi ruang. Target audiens juga memungkinkan Anda mengelola dan menyesuaikan keanggotaan ruang, sehingga Anda tidak perlu mengundang masing-masing pengguna ke ruang. Untuk mengetahui informasi selengkapnya, lihat Tentang target audiens.
Anda hanya dapat membuat ruang yang diberi nama dapat ditemukan oleh target audiens. Anda tidak dapat membagikan jenis ruang lainnya, seperti pesan langsung atau percakapan grup, kepada target audiens.
Prasyarat
- Akun Google Workspace dengan akses ke Google Chat. Akun Anda harus memiliki peran administrator super untuk organisasi Google Workspace Anda.
- Target audiens yang tersedia untuk diakses di Chat. Untuk membuat target audiens, lihat Membuat target audiens. Agar target audiens yang sudah ada tersedia untuk ruang Chat, lihat Menyiapkan akses ruang untuk Chat.
Mendapatkan ID target audiens
Untuk mendapatkan ID target audiens, lakukan hal berikut:
Di konsol Google Admin, buka Menu > Direktori > Target audiens.
Di tabel Target audiences, klik kolom Name untuk target audiens.
Temukan ID audiens target di URL untuk halaman tersebut. Format URL-nya adalah
https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID
, denganTARGET_AUDIENCE_ID
sebagai ID alfanumerik untuk target audiens Anda.
Di bagian berikutnya, Anda akan menggunakan ID target audiens untuk membuat ruang yang dapat ditemukan atau memperbarui ruang yang ada agar dapat ditemukan oleh audiens target.
Menentukan target audiens dalam permintaan Chat API
Untuk membuat ruang bagi target audiens tertentu, gunakan metode create()
atau
setup()
pada resource Space
. Agar ruang yang ada
dapat ditemukan, gunakan metode update()
di resource Space
. Karena hanya
ruang bernama yang dapat dibagikan dengan target audiens, jenis ruang
(diwakili di kolom spaceType
) harus SPACE
.
Agar ruang dapat ditemukan oleh target audiens Anda, sertakan objek
AccessSettings
di resource Space
sebagai bagian dari permintaan Chat API. Di objek, tentukan kolom audience
:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
Ganti TARGET_AUDIENCE_ID
dengan ID audiens target
yang Anda peroleh di bagian sebelumnya. Agar dapat menggunakan setelan berbagi ruang Chat default untuk organisasi Google Workspace Anda, ganti dengan default
.
Untuk mengetahui detail tentang cara membuat atau memperbarui ruang menggunakan Chat API, lihat panduan berikut: