Halaman ini menjelaskan cara menggunakan Google Chat API untuk membagikan ruang Google Chat kepada 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 kemampuan berbagi ruang. Target audiens juga memungkinkan Anda mengelola dan menyesuaikan langganan ruang, tanpa perlu mengundang setiap pengguna ke ruang. Untuk mengetahui informasi selengkapnya, lihat Tentang audiens target.
Anda hanya dapat membuat ruang bernama yang dapat ditemukan oleh audiens target. Anda tidak dapat membagikan jenis ruang lain, seperti pesan langsung atau percakapan grup, kepada audiens target.
Prasyarat
- Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat. Akun Anda harus memiliki peran admin super untuk organisasi Google Workspace Anda.
- Target audiens yang tersedia untuk diakses di Chat. Untuk membuat audiens target, lihat Membuat audiens target. Agar audiens target yang ada tersedia untuk ruang Chat, lihat Menyiapkan akses ruang untuk Chat.
- Anda harus memanggil Google Chat API, dengan autentikasi pengguna.
Mendapatkan ID target audiens
Untuk mendapatkan ID audiens target, lakukan hal berikut:
Di konsol Google Admin, buka Menu > Direktori > Target audiens.
Di tabel Target audiences, klik kolom Name di target audiens.
Temukan ID target audiens di URL untuk halaman. Format URL-nya adalah
https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, denganTARGET_AUDIENCE_IDsebagai 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 audiens target tertentu, gunakan metode create() atau
setup() di resource Space. Agar ruang yang ada dapat ditemukan, gunakan metode update() pada resource Space. Karena hanya
ruang bernama yang dapat dibagikan kepada audiens target, jenis ruang
(diwakili di kolom spaceType) harus SPACE.
Agar ruang dapat ditemukan oleh audiens target, sertakan objek AccessSettings di resource Space sebagai bagian dari permintaan Chat API Anda. Dalam
objek, tentukan kolom audience:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
Ganti TARGET_AUDIENCE_ID dengan ID audiens target
yang Anda dapatkan 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: