Panduan ini menjelaskan cara menggunakan metode
delete()
di resource Message
Google Chat API untuk menghapus pesan teks atau kartu.
Di Chat API, pesan Chat direpresentasikan oleh
resource Message
.
Meskipun pengguna Chat hanya dapat mengirim pesan yang berisi teks,
aplikasi Chat dapat menggunakan banyak fitur pesan lainnya, termasuk
menampilkan antarmuka pengguna statis atau interaktif, mengumpulkan informasi dari
pengguna, dan mengirimkan pesan secara pribadi. Untuk mempelajari lebih lanjut fitur pesan
yang tersedia untuk Chat API, lihat
ringkasan pesan Google Chat.
Dengan autentikasi aplikasi, Anda dapat menggunakan metode ini untuk menghapus pesan yang dikirim aplikasi Chat. Dengan autentikasi pengguna, Anda dapat menggunakan metode ini untuk menghapus pesan yang dikirim pengguna terautentikasi. Jika pengguna adalah pengelola ruang untuk ruang tersebut, Anda mungkin juga dapat menghapus pesan yang dikirim anggota ruang lainnya. Untuk informasi selengkapnya, lihat Mempelajari peran Anda sebagai Pengelola Ruang.
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.
Python
- 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 Python.
- 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.
Java
- 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 Java.
- 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.
Apps Script
- 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.
- Buat project Apps Script mandiri, dan aktifkan Layanan Chat Lanjutan.
- Dalam panduan ini, Anda harus menggunakan autentikasi pengguna atau aplikasi. Untuk mengautentikasi sebagai aplikasi Chat, buat kredensial akun layanan. Untuk mengetahui langkah-langkahnya, lihat Mengautentikasi dan memberikan otorisasi sebagai aplikasi Google Chat.
- Pilih cakupan otorisasi berdasarkan apakah Anda ingin mengautentikasi sebagai pengguna atau aplikasi Chat.
Menghapus pesan dengan autentikasi pengguna
Untuk menghapus pesan dengan autentikasi pengguna, teruskan hal berikut dalam permintaan Anda:
- Tentukan cakupan otorisasi
chat.messages
. - Panggil
metode
DeleteMessage()
. - Tetapkan
name
ke nama resource pesan yang akan dihapus.
Contoh berikut menghapus pesan dengan autentikasi pengguna:
Node.js
Python
Java
Apps Script
Untuk menjalankan contoh ini, ganti hal berikut:
SPACE_NAME
: ID dariname
ruang. Anda bisa mendapatkan ID dengan memanggil metodeListSpaces()
atau dari URL ruang.MESSAGE_NAME
: ID dariname
pesan. Anda bisa mendapatkan ID dari isi respons yang ditampilkan setelah membuat pesan secara asinkron dengan Chat API, atau dengan nama kustom yang ditetapkan ke pesan saat pembuatan.
Jika berhasil, isi respons akan kosong, yang menunjukkan bahwa pesan telah dihapus.
Menghapus pesan dengan autentikasi aplikasi
Untuk menghapus pesan dengan autentikasi aplikasi, teruskan hal berikut dalam permintaan Anda:
- Tentukan cakupan otorisasi
chat.bot
. - Panggil
metode
DeleteMessage()
. - Tetapkan
name
ke nama resource pesan yang akan dihapus.
Contoh berikut menghapus pesan dengan autentikasi aplikasi:
Node.js
Python
Java
Apps Script
Untuk menjalankan contoh ini, ganti hal berikut:
SPACE_NAME
: ID dariname
ruang. Anda bisa mendapatkan ID dengan memanggil metodeListSpaces()
atau dari URL ruang.MESSAGE_NAME
: ID dariname
pesan. Anda bisa mendapatkan ID dari isi respons yang ditampilkan setelah membuat pesan secara asinkron dengan Chat API, atau dengan nama kustom yang ditetapkan ke pesan saat pembuatan.
Jika berhasil, isi respons akan kosong, yang menunjukkan bahwa pesan telah dihapus.
Topik terkait
- Memformat pesan.
- Mendapatkan detail tentang pesan.
- Membuat daftar pesan dalam ruang.
- Memperbarui pesan.
- Mengirim pesan.