Membuat ruang Google Chat dapat ditemukan oleh pengguna tertentu di organisasi Google Workspace

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

Mendapatkan ID target audiens

Untuk mendapatkan ID target audiens, lakukan hal berikut:

  1. Di konsol Google Admin, buka Menu > Direktori > Target audiens.

    Buka Target audiens

  2. Di tabel Target audiences, klik kolom Name untuk target audiens.

  3. Temukan ID audiens target di URL untuk halaman tersebut. Format URL-nya adalah https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, dengan TARGET_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: