Panduan ini menjelaskan cara menggunakan metode findDirectMessage()
pada resource Space
Google Chat API untuk mendapatkan detail tentang ruang pesan langsung (DM).
Resource Space
mewakili 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 permanen tempat orang mengirim pesan, berbagi file, dan berkolaborasi.
Dengan melakukan autentikasi menggunakan autentikasi aplikasi, aplikasi Chat dapat mendapatkan DM yang diakses oleh aplikasi Chat di Google Chat (misalnya, DM yang menjadi anggotanya). Mengautentikasi dengan autentikasi pengguna akan menampilkan DM yang dapat diakses oleh pengguna yang diautentikasi.
Prasyarat
Node.js
- Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.
- Siapkan lingkungan Anda:
- Buat project Google Cloud.
- Konfigurasikan layar izin OAuth.
- Aktifkan dan konfigurasikan Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
- Instal Library Klien Cloud Node.js.
- Buat kredensial akses berdasarkan cara Anda ingin melakukan autentikasi dalam permintaan Google Chat API:
- Untuk mengautentikasi sebagai pengguna Chat,
buat kredensial client ID
OAuth dan simpan kredensial sebagai file JSON bernama
client_secrets.json
ke direktori lokal Anda. - Untuk mengautentikasi sebagai aplikasi Chat,
buat kredensial akun layanan dan simpan kredensial sebagai file JSON bernama
credentials.json
.
- Untuk mengautentikasi sebagai pengguna Chat,
buat kredensial client ID
OAuth dan simpan kredensial sebagai file JSON bernama
- Pilih cakupan otorisasi berdasarkan apakah Anda ingin mengautentikasi sebagai pengguna atau aplikasi Chat.
Menemukan pesan langsung
Untuk menemukan pesan langsung di Google Chat, teruskan hal berikut dalam permintaan Anda:
- Dengan autentikasi aplikasi,
tentukan cakupan otorisasi
chat.bot
. Pada bagian autentikasi pengguna, tentukan cakupan otorisasichat.spaces.readonly
atauchat.spaces
. - Panggil metode
FindDirectMessage()
, yang meneruskanname
pengguna lain di DM untuk ditampilkan. Dengan autentikasi pengguna, metode ini menampilkan DM antara pengguna yang melakukan panggilan dan pengguna yang ditentukan. Dengan autentikasi aplikasi, metode ini akan menampilkan DM antara aplikasi panggilan dan pengguna yang ditentukan. - Untuk menambahkan pengguna manusia sebagai anggota ruang, tentukan
users/{user}
, dengan{user}
adalah{person_id}
untukperson
dari People API, atau IDuser
di Directory API. Misalnya, jika orang People APIresourceName
adalahpeople/123456789
, Anda dapat menambahkan pengguna ke ruang dengan menyertakan keanggotaan denganusers/123456789
sebagaimember.name
.
Menemukan pesan langsung dengan autentikasi pengguna
Berikut cara menemukan pesan langsung dengan autentikasi pengguna:
Node.js
Untuk menjalankan contoh ini, ganti USER_NAME
dengan ID dari
kolom
name
pengguna.
Chat API menampilkan instance
Space
yang menjelaskan DM yang ditentukan.
Menemukan pesan langsung dengan autentikasi aplikasi
Berikut cara menemukan pesan langsung dengan autentikasi aplikasi:
Node.js
Untuk menjalankan contoh ini, ganti USER_NAME
dengan ID dari kolom name
pengguna.
Chat API menampilkan instance
Space
yang menjelaskan DM yang ditentukan.
Topik terkait
- Membuat ruang.
- Menyiapkan ruang.
- Mendapatkan detail tentang ruang.
- Daftar ruang.
- Memperbarui ruang.
- Menghapus ruang.