Layanan Peristiwa Google Workspace Lanjutan memungkinkan Anda menggunakan Google Workspace Events API di Apps Script. API ini memungkinkan Anda berlangganan referensi Google Workspace agar akan menerima acara relevan yang Anda minati. Peristiwa merepresentasikan perubahan pada resource, seperti saat resource dibuat, diperbarui, atau dihapus.
Prasyarat
- Project Apps Script menggunakan project Google Cloud standar, bukan project default yang dibuat otomatis oleh Apps Script.
- Topik Pub/Sub yang dibuat dalam project Google Cloud yang sama untuk menerima peristiwa langganan. Untuk membuat topik Pub/Sub, lihat Membuat dan berlangganan topik Pub/Sub.
- Untuk berlangganan peristiwa Chat, Anda harus mengonfigurasi aplikasi Google Chat di halaman konfigurasi Chat API di Konsol Google Cloud. Untuk membuat aplikasi Google Chat, lihat Membuat aplikasi Google Chat dengan Apps Script.
Cakupan otorisasi yang diperlukan ditambahkan ke file
appsscript.json
project Apps Script. Cakupan yang diperlukan bergantung pada jenis resource dan peristiwa target langganan. Untuk mengetahui detailnya, lihat Memilih cakupan Google Workspace Events API. Contoh:"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.readonly" ]
Referensi
Untuk mengetahui informasi selengkapnya tentang layanan ini, lihat dokumentasi referensi Google Workspace Events API. Seperti semua layanan lanjutan di Apps Script, layanan Peristiwa Google Workspace menggunakan objek, metode, dan parameter yang sama dengan API publik.
Kode contoh
Contoh ini menunjukkan cara melakukan tindakan Google Workspace Events API umum menggunakan layanan lanjutan.
Membuat langganan
Untuk membuat langganan ke resource Google Workspace, tambahkan fungsi berikut ke kode project Apps Script:
Mencantumkan langganan
Untuk mencantumkan langganan yang difilter menurut jenis peristiwa dan resource target, tambahkan fungsi berikut ke kode project Apps Script:
Mendapatkan langganan
Untuk mendapatkan informasi tentang langganan, tambahkan fungsi berikut ke kode project Apps Script:
Memperbarui langganan
Untuk mengupdate atau memperpanjang langganan, tambahkan fungsi berikut ke kode project Apps Script:
Aktifkan kembali langganan
Untuk mengaktifkan kembali langganan, tambahkan fungsi berikut ke kode project Apps Script:
Menghapus langganan
Untuk menghapus langganan, tambahkan fungsi berikut ke kode project Apps Script:
Mendapatkan operasi
Sebagian besar metode Google Workspace Events API menampilkan
operasi yang berjalan lama.
Untuk menentukan status operasi, Anda dapat menggunakan
metode
operations.get()
.
Untuk mendapatkan informasi tentang operasi, tambahkan fungsi berikut ke kode project Apps Script:
Untuk mendapatkan nama operasi, gunakan nilai dari kolom name
yang ditampilkan
dari salah satu metode Google Workspace Events API, seperti
subscriptions.create()
atau
subscriptions.patch()
.