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 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

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 audiens, klik kolom Nama target audiens Anda.

  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 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: