Layanan Advanced Chat memungkinkan Anda menggunakan Google Chat API di Apps Script. API ini memungkinkan skrip untuk menemukan, membuat, dan mengubah ruang Chat, menambahkan atau menghapus anggota ke ruang, serta membaca atau memposting pesan dengan teks, kartu, lampiran, dan reaksi.
Prasyarat
- Aplikasi Google Chat Apps Script yang dikonfigurasi pada halaman konfigurasi Chat API di Konsol Google Cloud. Project Apps Script aplikasi harus menggunakan project Google Cloud standar, bukan project default yang dibuat otomatis untuk project Apps Script. Untuk membuat aplikasi Google Chat yang kompatibel, lihat Membuat aplikasi Google Chat dengan Apps Script.
- Autentikasi yang dikonfigurasi untuk aplikasi Chat. Melakukan tindakan atas nama pengguna memerlukan autentikasi pengguna. Melakukan tindakan karena aplikasi Chat memerlukan autentikasi aplikasi dengan akun layanan. Untuk memeriksa bentuk autentikasi yang didukung metode Chat API, lihat Jenis autentikasi yang diperlukan untuk panggilan Google Chat API.
Referensi
Untuk mengetahui informasi selengkapnya tentang layanan ini, lihat Dokumentasi referensi Chat API. Seperti semua layanan lanjutan di Apps Script, layanan Chat menggunakan objek, metode, dan parameter yang sama dengan API publik.
Kode contoh
Contoh ini menunjukkan cara melakukan tindakan Google Chat API umum menggunakan layanan lanjutan.
Memposting pesan dengan kredensial pengguna
Contoh berikut menunjukkan cara memposting pesan ke ruang Chat atas nama pengguna.
Tambahkan cakupan otorisasi
chat.messages.create
ke fileappsscript.json
project Apps Script:"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.create" ]
Tambahkan fungsi seperti ini ke kode project Apps Script:
Memposting pesan dengan kredensial aplikasi
Contoh berikut menunjukkan cara memposting pesan ke
ruang Chat atas nama aplikasi. Penggunaan layanan
Chat lanjutan dengan akun layanan tidak mengharuskan Anda
menentukan cakupan otorisasi di appsscript.json
. Untuk mengetahui detail tentang
autentikasi dengan akun layanan, lihat
Mengautentikasi sebagai aplikasi Google Chat.
Dapatkan ruang
Contoh berikut menunjukkan cara mendapatkan informasi tentang ruang Chat.
Tambahkan cakupan otorisasi
chat.spaces.readonly
ke fileappsscript.json
project Apps Script:"oauthScopes": [ "https://www.googleapis.com/auth/chat.spaces.readonly" ]
Tambahkan fungsi seperti ini ke kode project Apps Script:
Membuat ruang
Contoh berikut menunjukkan cara membuat ruang Chat.
Tambahkan cakupan otorisasi
chat.spaces.create
ke fileappsscript.json
project Apps Script:"oauthScopes": [ "https://www.googleapis.com/auth/chat.spaces.create" ]
Tambahkan fungsi seperti ini ke kode project Apps Script:
Mencantumkan keanggotaan
Contoh berikut menunjukkan cara menampilkan daftar semua anggota ruang Chat.
Tambahkan cakupan otorisasi
chat.memberships.readonly
ke fileappsscript.json
project Apps Script:"oauthScopes": [ "https://www.googleapis.com/auth/chat.memberships.readonly" ]
Tambahkan fungsi seperti ini ke kode project Apps Script:
Memecahkan masalah
Jika Anda menemukan Error 400: invalid_scope
dengan pesan error
Some requested scopes cannot be shown
,
artinya Anda belum menentukan cakupan otorisasi apa pun dalam file appsscript.json
project Apps Script. Pada umumnya, Apps Script secara otomatis menentukan cakupan yang diperlukan skrip, tetapi saat menggunakan layanan lanjutan Chat, Anda harus secara manual menambahkan cakupan otorisasi yang digunakan skrip ke file manifes project Apps Script. Lihat Menetapkan cakupan eksplisit.
Untuk mengatasi error ini, tambahkan cakupan otorisasi yang sesuai ke file appsscript.json
project Apps Script sebagai bagian dari array oauthScopes
. Misalnya, untuk memanggil metode spaces.messages.create
, tambahkan kode berikut:
"oauthScopes": [
"https://www.googleapis.com/auth/chat.messages.create"
]
Batasan dan pertimbangan
Layanan Chat Lanjutan tidak mendukung:
- Metode Chat API
media.download
. - Metode Chat API yang tersedia di Pratinjau Developer
Untuk mendownload lampiran pesan atau memanggil metode pratinjau developer, gunakan
UrlFetchApp
.