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

Halaman ini menjelaskan cara menggunakan Google Chat API untuk membagikan ruang Google Chat kepada pengguna tertentu dalam 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 audiens target. 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 keanggotaan ruang, sehingga Anda tidak perlu mengundang setiap pengguna ke ruang. Untuk mengetahui informasi selengkapnya, lihat Tentang audiens target.

Anda hanya dapat membuat ruang bernama dapat ditemukan oleh target audiens. Anda tidak dapat membagikan jenis ruang lain, seperti pesan langsung atau percakapan grup, kepada audiens target.

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.

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

Menentukan target audiens dan izin terperinci

Untuk membuat ruang dengan izin akses tertentu, gunakan metode create atau setup pada resource Space. Untuk memperbarui izin ruang yang ada, gunakan metode update. Karena hanya ruang bernama yang dapat dibagikan kepada target audiens, jenis ruang (yang ditampilkan di kolom spaceType) harus SPACE.

Untuk menentukan siapa yang dapat menemukan atau bergabung ke ruang, sertakan objek AccessSettings dalam resource Space. Dalam objek, gunakan kolom accessPermissionSettings untuk menentukan satu atau beberapa izin berikut:

  • Dapat ditemukan: Gunakan discoverSpaceSetting untuk menentukan siapa yang dapat menemukan nama dan deskripsi ruang serta menjelajahinya di Google Chat. Anda dapat menentukan beberapa target audiens untuk penemuan.
  • Dapat bergabung: Gunakan joinSpaceSetting untuk menentukan siapa yang dapat bergabung ke ruang tanpa undangan eksplisit dan melihat pratinjau pesan ruang. Pengguna yang dapat bergabung ke ruang juga harus dapat menemukannya. Google Chat mendukung satu target audiens untuk izin ini.

Contoh berikut menunjukkan cara membuat ruang dapat ditemukan oleh dua target audiens dan dapat diikuti oleh salah satunya:

  "accessSettings": {
    "accessPermissionSettings": {
      "discoverSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      },
      "joinSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
        ]
      }
    }
  }

Ganti TARGET_AUDIENCE_ID_1 dan TARGET_AUDIENCE_ID_2 dengan ID target audiens yang Anda peroleh di Mendapatkan ID target audiens. Untuk menggunakan setelan berbagi ruang Chat default untuk organisasi Google Workspace Anda, ganti dengan default.

Untuk kompatibilitas mundur, gunakan kolom audience

Untuk kompatibilitas mundur, Anda dapat terus menggunakan kolom audience untuk menentukan satu audiens target yang dapat bergabung ke ruang, tetapi sebaiknya Tentukan audiens target dan izin terperinci.

Menyetel kolom audience sama dengan menentukan target audiens di joinSpaceSetting dan discoverSpaceSetting:

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

Ganti TARGET_AUDIENCE_ID dengan ID target audiens yang Anda peroleh di Mendapatkan ID target audiens. Untuk menggunakan setelan berbagi ruang Chat default untuk organisasi Google Workspace Anda, ganti dengan default.

Memahami setelan akses dalam respons API

Saat Anda mendapatkan ruang, objek AccessSettings dalam respons mencerminkan setelan izin terperinci untuk ruang.

Kolom berikut di AccessSettings menunjukkan kemampuan penelusuran dan izin bergabung ke ruang:

  • accessState: Diperoleh dari izin penemuan (discoverSpaceSetting). Jika penemuan diberikan kepada satu atau beberapa target audiens, kolom ini adalah DISCOVERABLE. Jika tidak, PRIVATE.
  • audience: Dipetakan secara khusus untuk menggabungkan izin (joinSpaceSetting). Jika satu target audiens diberi izin bergabung, kolom ini berisi nama resource target audiens tersebut.

Ruang yang dapat ditemukan tanpa audiens untuk bergabung

Ruang mungkin dapat ditemukan oleh target audiens, tetapi tidak dapat diikuti secara langsung (misalnya, jika pengguna harus diundang secara eksplisit untuk bergabung).

Dalam hal ini, objek AccessSettings memiliki nilai berikut:

  • accessState: DISCOVERABLE
  • audience: Dihilangkan atau null

Jika Anda melihat accessState disetel ke DISCOVERABLE, tetapi audience tidak ada, artinya ruang dapat ditemukan oleh target audiens yang ditentukan dalam discoverSpaceSetting, tetapi hanya dapat diikuti dengan undangan. Untuk melihat audiens target mana yang dapat menemukan ruang, periksa kolom accessPermissionSettings.discoverSpaceSetting.

Untuk mengetahui detail tentang target audiens, lihat panduan berikut:

Untuk mengetahui detail tentang cara membuat atau mengupdate ruang menggunakan Chat API, lihat panduan berikut: