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 Ruang Chat dengan, untuk meningkatkan awareness dan awareness terkait ruang kemudahan berbagi. Target audiens juga memungkinkan Anda mengelola dan menyesuaikan ruang keanggotaan daripada harus mengundang pengguna satu per satu ke ruang. Untuk selengkapnya informasi, lihat Tentang target audiens.
Anda hanya dapat membuat ruang yang diberi nama dapat ditemukan oleh target audiens. Anda tidak bisa berbagi jenis ruang lainnya, seperti pesan langsung atau percakapan grup, dengan target audiens secara lebih strategis.
Prasyarat
- Business atau Enterprise Akun Google Workspace yang memiliki akses ke Google Chat. Nama akun harus memiliki administrator super peran untuk organisasi Google Workspace Anda.
- Target audiens yang tersedia untuk diakses di Chat. Kepada membuat target audiens, lihat Membuat target audiens. Untuk membuat target audiens yang 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 > > Target audiens.
DirektoriDi tabel Target audiens, klik kolom Nama target audiens Anda.
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 audiens target Anda.
Di bagian berikutnya, Anda akan menggunakan ID audiens target untuk membuat ruang yang dapat ditemukan atau memperbarui ruang yang ada agar dapat ditemukan oleh audiens target Anda.
Menentukan target audiens dalam permintaan Chat API
Untuk membuat ruang bagi target audiens tertentu, gunakan create()
atau
Metode setup()
pada resource Space
. Untuk membuat ruang yang ada
dapat ditemukan, gunakan metode update()
pada resource Space
. Karena hanya
ruang bernama dapat dibagikan kepada target audiens, jenis ruang
(diwakili di kolom spaceType
) harus SPACE
.
Agar ruang dapat ditemukan oleh target audiens Anda, sertakan
AccessSettings
di resource Space
sebagai bagian dari permintaan Chat API Anda. Di beberapa
objek, tentukan kolom audience
:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
Ganti TARGET_AUDIENCE_ID
dengan ID target
audiens yang Anda peroleh di bagian sebelumnya. Untuk menggunakan default
Setelan berbagi ruang Chat untuk Google Workspace
organisasi, ganti dengan default
.
Untuk mengetahui detail tentang cara membuat atau memperbarui ruang menggunakan Chat API, lihat panduan berikut: