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 di organisasi Google Workspace, sehingga mereka dapat menemukan, bergabung, dan melihat anggota ruang.

Untuk menentukan pengguna di organisasi Anda yang dapat menemukan, bergabung, dan melihat anggota ruang, Anda membuat audiens target. Target audiens adalah kelompok orang—seperti departemen tertentu atau seluruh organisasi—yang dapat Anda ajak berbagi ruang Chat, untuk memberikan kontrol yang lebih terperinci atas siapa yang dapat mengakses ruang dan informasinya. Target audiens juga memungkinkan Anda mengelola dan menyesuaikan keanggotaan ruang, bukan mengundang pengguna satu per satu ke ruang. Untuk mengetahui informasi selengkapnya, lihat Tentang target audiens.

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

Prasyarat

Mendapatkan ID audiens target

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

Di bagian berikutnya, Anda menggunakan ID audiens target untuk membuat ruang yang dapat ditemukan atau memperbarui ruang yang ada agar dapat ditemukan oleh audiens target.

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, bergabung, atau melihat anggota 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 audiens target untuk izin ini.
  • Lihat keanggotaan: Gunakan viewSpaceMembershipSetting untuk menentukan siapa yang dapat melihat daftar anggota dalam ruang. Saat memperbarui siapa yang dapat melihat keanggotaan ruang, accessSettings.accessPermissionSettings.viewSpaceMembershipSetting harus ditentukan bersama dengan permissionSettings.viewSpaceMembership di updateMask dan isi permintaan. Jika audiens target dikonfigurasi di viewSpaceMembershipSetting, viewSpaceMembership harus diberikan kepada semua anggota (managersAllowed, assistantManagersAllowed, dan membersAllowed ditetapkan ke true).

Contoh berikut menunjukkan cara membuat ruang dapat ditemukan oleh dua target audiens, dapat diikuti oleh salah satunya, dan memastikan semua anggota dan target audiens yang ditentukan dapat melihat daftar anggota:

{
  "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" } }
        ]
      },
      "viewSpaceMembershipSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      }
    }
  },
  "permissionSettings": {
    "viewSpaceMembership": {
      "managersAllowed": true,
      "assistantManagersAllowed": true,
      "membersAllowed": true
    }
  }
}

Ganti TARGET_AUDIENCE_ID_1 dan TARGET_AUDIENCE_ID_2 dengan ID audiens target yang Anda peroleh di Mendapatkan ID audiens target. 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 audiens target di joinSpaceSetting:

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

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

Memahami setelan akses dalam respons API

Saat Anda mendapatkan atau mencantumkan 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, berarti 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 audiens target, lihat panduan berikut:

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