Panduan ini menjelaskan cara menggunakan metode
delete()
di resource Message
Google Chat API untuk menghapus pesan teks atau kartu.
Di Chat API, pesan Chat diwakili 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 yang statis atau interaktif, mengumpulkan informasi dari
pengguna, dan mengirim
pesan secara pribadi. Untuk mempelajari fitur pesan lebih lanjut
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 dapat menggunakan metode ini untuk menghapus pesan yang dikirim pengguna yang 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 melakukan autentikasi sebagai pengguna atau Aplikasi Chat.
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 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 melakukan autentikasi sebagai pengguna Chat,
buat client ID OAuth
kredensial, lalu simpan kredensial sebagai file JSON yang 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 melakukan autentikasi sebagai pengguna Chat,
buat client ID OAuth
kredensial, lalu simpan kredensial sebagai file JSON yang bernama
- Pilih cakupan otorisasi berdasarkan apakah Anda ingin melakukan autentikasi sebagai pengguna atau Aplikasi Chat.
Java
- Sebuah Business atau Enterprise Akun Google Workspace yang memiliki akses ke Google Chat.
- Siapkan lingkungan Anda:
- Buat project Google Cloud.
- Konfigurasi layar izin OAuth.
- Aktifkan dan konfigurasikan Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
- Instal Java Library Klien Cloud.
- Buat kredensial akses berdasarkan cara Anda ingin melakukan autentikasi di Google Chat API
permintaan:
- 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 melakukan autentikasi sebagai pengguna atau Aplikasi Chat.
Apps Script
- Sebuah Business atau Enterprise Akun Google Workspace yang memiliki akses ke Google Chat.
- Menyiapkan 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 Autentikasi dan otorisasi sebagai Aplikasi Google Chat.
- Pilih cakupan otorisasi berdasarkan apakah Anda ingin melakukan autentikasi 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
. 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 berikut dalam permintaan Anda:
- Tentukan cakupan otorisasi
chat.bot
. - Panggil
metode
DeleteMessage()
. - Setel
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 kode berikut:
SPACE_NAME
: ID dariname
ruang. Anda bisa mendapatkan ID dengan memanggilListSpaces()
atau dari URL ruang.MESSAGE_NAME
: ID dariname
. Anda bisa mendapatkan ID dari isi respons yang ditampilkan setelah membuat secara asinkron dengan Chat API, atau dengan nama kustom ditetapkan ke pesan pada 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.