Membuat ruang Google Chat dan menambahkan anggota (original) (raw)

Panduan ini menjelaskan cara menggunakan metodesetUp()pada resource Space Google Chat API untuk membuat ruang Chat, dan menambahkan anggota ke dalamnya.

ResourceSpacemerepresentasikan tempat orang dan aplikasi Chat dapat mengirim pesan, berbagi file, dan berkolaborasi. Ada beberapa jenis ruang:

• Pesan langsung (DM) adalah percakapan antara dua pengguna atau pengguna dan aplikasi Chat.
• Chat grup adalah percakapan antara tiga pengguna atau lebih dan aplikasi Chat.
• Ruang bernama adalah tempat yang persisten tempat orang mengirim pesan, berbagi file, dan berkolaborasi.

Anda dapat menggunakan metode setUp() untuk melakukan salah satu hal berikut:

• Buat ruang bernama dengan anggota awal.
• Membuat pesan langsung (DM) antara dua orang.
• Menyiapkan pesan grup di antara beberapa orang.

Saat menyiapkan ruang, pertimbangkan hal berikut:

• Pengguna yang melakukan panggilan (terautentikasi) akan otomatis ditambahkan ke ruang, sehingga Anda tidak perlu menentukan keanggotaan pengguna dalam permintaan.
• Saat membuat pesan langsung (DM), jika ada DM antara dua pengguna, maka DM tersebut akan ditampilkan. Jika tidak, DM akan dibuat.
• Saat membuat percakapan grup, jika tidak ada keanggotaan yang diberikan dalam permintaan yang berhasil ditambahkan ke percakapan grup (misalnya, masalah izin), maka percapan grup kosong (termasuk hanya pengguna yang memanggil) dapat dibuat.
• Anda tidak dapat menyiapkan ruang dengan balasan berangkai atau menambahkan orang di luar organisasi Google Workspace Anda.
• Keanggotaan duplikat (termasuk pengguna yang memanggil) yang diberikan dalam permintaan akan difilter, bukan menyebabkan error permintaan.
• Saat administrator Google Workspacemenginstal aplikasi Chat untuk seluruh organisasi Google Workspace, Google Chat membuat DM antara aplikasi Chat yang diinstal dan setiap pengguna di organisasi, sehingga tidak perlu menyiapkan DM secara terprogram. Sebagai gantinya,cantumkan ruang untuk menampilkan semua DM atautemukan pesan langsunguntuk mendapatkan detail tentang DM tertentu.

Prasyarat

Node.js

• Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.
• Siapkan lingkungan Anda:
  • Buat project Google Cloud.
  • Konfigurasi layar izin OAuth.
  • Aktifkan dan konfigurasi Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
  • Instal Library Klien Cloud Node.js.
  • Buat kredensial client ID OAuth untuk aplikasi desktop. Untuk menjalankan contoh dalam panduan ini, simpan kredensial sebagai file JSON bernama credentials.json ke direktori lokal Anda.
    Untuk mendapatkan panduan, selesaikan langkah-langkah penyiapan lingkungan Anda dalampanduan memulai cepat ini.
• Pilih cakupan otorisasi yang mendukung autentikasi pengguna.

Python

• Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.
• Siapkan lingkungan Anda:
  • Buat project Google Cloud.
  • Konfigurasi layar izin OAuth.
  • Aktifkan dan konfigurasi Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
  • Instal Python Cloud Client Library.
  • Buat kredensial client ID OAuth untuk aplikasi desktop. Untuk menjalankan contoh dalam panduan ini, simpan kredensial sebagai file JSON bernama credentials.json ke direktori lokal Anda.
    Untuk mendapatkan panduan, selesaikan langkah-langkah penyiapan lingkungan Anda dalampanduan memulai cepat ini.
• Pilih cakupan otorisasi yang mendukung autentikasi pengguna.

Java

• Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.
• Siapkan lingkungan Anda:
  • Buat project Google Cloud.
  • Konfigurasi layar izin OAuth.
  • Aktifkan dan konfigurasi Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
  • Instal Java Cloud Client Library.
  • Buat kredensial client ID OAuth untuk aplikasi desktop. Untuk menjalankan contoh dalam panduan ini, simpan kredensial sebagai file JSON bernama credentials.json ke direktori lokal Anda.
    Untuk mendapatkan panduan, selesaikan langkah-langkah penyiapan lingkungan Anda dalampanduan memulai cepat ini.
• Pilih cakupan otorisasi yang mendukung autentikasi pengguna.

Apps Script

• Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.
• Siapkan lingkungan Anda:
  • Buat project Google Cloud.
  • Konfigurasi layar izin OAuth.
  • Aktifkan dan konfigurasi Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
  • Buat project Apps Script mandiri, lalu aktifkan Advanced Chat Service.
    Untuk mengetahui langkah-langkah penyiapan lingkungan, selesaikanpanduan memulai ini.
• Pilih cakupan otorisasi yang mendukung autentikasi pengguna.

Menyiapkan ruang

Untuk menyiapkan ruang, teruskan hal berikut dalam permintaan Anda:

• Tentukan cakupan otorisasi chat.spaces.create atau chat.spaces.
• Panggil metodeSetUpSpace().
• Teruskan space sebagai instanceSpacedengan semua kolom yang diperlukan seperti displayName atau spaceType.
• Teruskan memberships sebagai array instanceMembership. Untuk setiap instance:
  • Tentukan users/{user} untuk menambahkan pengguna manusia sebagai anggota ruang, dengan {user}adalah {person_id} untuk persondari People API, atau IDuserdi Directory API. Misalnya, jika orang People APIresourceName adalah people/123456789, Anda dapat menambahkan pengguna ke ruang dengan menyertakan keanggotaan dengan users/123456789 sebagai member.name.
  • Tentukan groups/{group} untuk menambahkan grup sebagai anggota ruang, dengan {group}adalah ID grup yang ingin Anda buat keanggotaannya. ID grup dapat diambil menggunakan Cloud Identity API. Misalnya, jikaCloud Identity APImenampilkan grup dengan nama groups/123456789, tetapkanmembership.groupMember.name ke groups/123456789. Google Grup tidak dapat ditambahkan ke chat grup atau DM, tetapi hanya ke ruang bernama.

Untuk membuat DM antara pengguna yang memanggil dan pengguna manusia lain, tentukan keanggotaan pengguna manusia dalam permintaan Anda.

Untuk membuat DM antara pengguna yang memanggil dan aplikasi yang memanggil, tetapkanspace.singleUserBotDm ke true dan jangan tentukan keanggotaan apa pun. Anda hanya dapat menggunakan metode ini untuk menyiapkan DM dengan aplikasi yang melakukan panggilan. Untuk menambahkan aplikasi yang melakukan panggilan sebagai anggota ruang atau DM yang sudah ada antara dua pengguna manusia, lihat membuat keanggotaan.

Contoh berikut membuat ruang bernama dan membuat satu keanggotaan ke ruang untuk dua pengguna manusia (pengguna terautentikasi dan satu pengguna lainnya).

Node.js

Python

Java

Apps Script

Untuk menjalankan contoh, ganti bagian berikut:

• DISPLAY_NAME: nama tampilan ruang baru.
• USER_NAME: ID pengguna lain yang akan disertakan keanggotaannya.

Untuk membuka ruang, gunakan ID resource ruang untuk membuat URL ruang. Anda bisa mendapatkan ID resource dari ruang name di isi respons Google Chat. Misalnya, jika name ruang Anda adalah spaces/1234567, Anda dapat membuka ruang menggunakan URL berikut:https://mail.google.com/chat/u/0/#chat/space/1234567.

• Buat ruang.
• Mendapatkan detail tentang ruang.
• Mencantumkan ruang.
• Memperbarui ruang.
• Menghapus ruang.
• Temukan ruang pesan langsung.
• Membuat ruang dapat ditemukan oleh pengguna tertentu.