Membuat langganan Google Workspace

Halaman ini menjelaskan cara menggunakan Google Workspace Events API untuk membuat langganan ke resource Google Workspace. Langganan Google Workspace memungkinkan aplikasi Anda menerima informasi tentang peristiwa Google Workspace, yang mewakili perubahan pada resource Google Workspace. Untuk mempelajari resource dan jenis peristiwa yang didukung Google Workspace Events API, lihat ringkasan Google Workspace Events API.

Halaman ini mencakup langkah-langkah berikut untuk membuat langganan Google Workspace:

1. Siapkan lingkungan Anda.
2. Membuat dan berlangganan topik Google Cloud Pub/Sub. Anda menggunakan topik ini sebagai endpoint untuk menerima peristiwa Google Workspace.
3. Panggil metode create() Google Workspace Events API pada resource Subscription.
4. Uji langganan Google Workspace Anda untuk memastikan bahwa topik Pub/Sub Anda menerima peristiwa yang telah Anda langgani.
5. Secara opsional, konfigurasikan cara mengirim peristiwa ke endpoint untuk aplikasi Anda, sehingga aplikasi dapat memproses peristiwa dan, jika perlu, mengambil tindakan.

Prasyarat

Apps Script

• Untuk menggunakan perintah Google Cloud CLI dalam panduan ini:
  1. Instal Google Cloud CLI.
  2. Untuk melakukan inisialisasi CLI gcloud, jalankan kode berikut:

    gcloud init
    

• Project Google Cloud dengan penagihan diaktifkan. Untuk langganan ke Chat, Anda juga harus mengaktifkan Chat API di project Cloud dan mengonfigurasi kolom App name, Avatar URL, dan Description. Untuk mengetahui detailnya, lihat Mem-build aplikasi Google Chat.
• Memerlukan autentikasi pengguna dengan layar izin OAuth yang dikonfigurasi untuk aplikasi. Saat mengonfigurasi layar izin, Anda harus menentukan cakupan untuk mendukung setiap jenis peristiwa untuk langganan. Untuk mengonfigurasi layar izin dan mengidentifikasi cakupan yang diperlukan, lihat Memilih cakupan.

• Project Apps Script:
  • Gunakan project Google Cloud Anda, bukan project default yang dibuat secara otomatis oleh Apps Script.
  • Untuk cakupan yang Anda tambahkan guna mengonfigurasi layar izin OAuth, Anda juga harus menambahkan cakupan ke file appsscript.json di project Apps Script. Contoh:

  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.messages.readonly"
  ]
      

  • Aktifkan layanan lanjutan Google Workspace Events.

Python

• Python 3.6 atau yang lebih tinggi
• Alat pengelolaan paket pip
• Library klien Google terbaru untuk Python. Untuk menginstal atau mengupdatenya, jalankan perintah berikut di antarmuka command line:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    

• Untuk menggunakan perintah Google Cloud CLI dalam panduan ini:
  1. Instal Google Cloud CLI.
  2. Untuk melakukan inisialisasi CLI gcloud, jalankan kode berikut:

    gcloud init
    

• Project Google Cloud dengan penagihan diaktifkan. Untuk langganan ke Chat, Anda juga harus mengaktifkan Chat API di project Cloud dan mengonfigurasi kolom App name, Avatar URL, dan Description. Untuk mengetahui detailnya, lihat Mem-build aplikasi Google Chat.
• Memerlukan autentikasi pengguna dengan layar izin OAuth yang dikonfigurasi untuk aplikasi. Saat mengonfigurasi layar izin, Anda harus menentukan cakupan untuk mendukung setiap jenis peristiwa untuk langganan. Untuk mengonfigurasi layar izin dan mengidentifikasi cakupan yang diperlukan, lihat Memilih cakupan.

Menyiapkan lingkungan Anda

Bagian berikut menjelaskan cara menyiapkan lingkungan sebelum membuat langganan Google Workspace.

Mengaktifkan Google Workspace Events API dan Google Cloud Pub/Sub API

Sebelum menggunakan Google API, Anda harus mengaktifkannya di project Google Cloud. Anda dapat mengaktifkan satu atau beberapa API dalam satu project Google Cloud.

Konsol Google Cloud

Di konsol Google Cloud, buka project Google Cloud untuk aplikasi Anda dan aktifkan Google Workspace Events API dan Pub/Sub API:

Aktifkan API

gcloud

1. Di direktori kerja Anda, login ke Akun Google Anda:

   gcloud auth login

2. Tetapkan project Anda ke project Cloud untuk aplikasi Anda:

   gcloud config set project PROJECT_ID

   Ganti PROJECT_ID dengan project ID untuk project Cloud untuk aplikasi Anda.

3. Aktifkan Google Workspace Events API dan Google Cloud Pub/Sub API:

   gcloud services enable pubsub.googleapis.com workspaceevents.googleapis.com

Membuat kredensial client ID OAuth

Catatan: Anda dapat melewati langkah ini jika menggunakan Apps Script.

Pilih jenis aplikasi untuk mendapatkan petunjuk spesifik tentang cara membuat client ID OAuth:

Catatan: Untuk menjalankan contoh kode dalam panduan ini, pilih Aplikasi desktop dan ikuti petunjuknya.

Aplikasi web

1. Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.

   Buka Kredensial

2. Klik Create Credentials > OAuth client ID.
3. Klik Application type > Web application.
4. Di kolom Name, ketik nama untuk kredensial. Nama ini hanya ditampilkan di konsol Google Cloud.
5. Tambahkan URI resmi yang terkait dengan aplikasi Anda:
   • Aplikasi sisi klien (JavaScript)–Di bagian Asal JavaScript resmi, klik Tambahkan URI. Kemudian, masukkan URI yang akan digunakan untuk permintaan browser. Ini mengidentifikasi domain tempat aplikasi Anda dapat mengirim permintaan API ke server OAuth 2.0.
   • Aplikasi sisi server (Java, Python, dan lainnya)–Di bagian URI pengalihan yang diberi otorisasi, klik Tambahkan URI. Kemudian, masukkan URI endpoint tempat server OAuth 2.0 dapat mengirim respons.
6. Klik Create. Layar yang dibuat klien OAuth akan muncul, yang menampilkan Client ID dan Rahasia klien baru Anda.

   Catat Client ID. Rahasia klien tidak digunakan untuk aplikasi Web.

7. Klik Oke. Kredensial yang baru dibuat akan muncul di bagian Client ID OAuth 2.0.

Android

1. Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.

   Buka Kredensial

2. Klik Create Credentials > OAuth client ID.
3. Klik Application type > Android.
4. Di kolom "Nama", ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di konsol Google Cloud.
5. Di kolom "Package name", masukkan nama paket dari file AndroidManifest.xml Anda.
6. Di kolom "SHA-1 certificate fingerprint", masukkan sidik jari sertifikat SHA-1 yang dihasilkan.
7. Klik Create. Layar klien OAuth yang dibuat akan muncul, yang menampilkan Client ID baru Anda.
8. Klik Oke. Kredensial yang baru dibuat akan muncul di bagian "Client ID OAuth 2.0".

iOS

1. Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.

   Buka Kredensial

2. Klik Create Credentials > OAuth client ID.
3. Klik Jenis aplikasi > iOS.
4. Di kolom "Nama", ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di konsol Google Cloud.
5. Di kolom "ID Paket", masukkan ID paket seperti yang tercantum dalam file Info.plist aplikasi.
6. Opsional: Jika aplikasi Anda muncul di Apple App Store, masukkan ID App Store.
7. Opsional: Di kolom "ID Tim", masukkan string unik 10 karakter yang dibuat oleh Apple dan ditetapkan untuk tim Anda.
8. Klik Create. Layar yang dibuat klien OAuth akan muncul, yang menampilkan Client ID dan Rahasia klien baru Anda.
9. Klik Oke. Kredensial yang baru dibuat akan muncul di bagian "Client ID OAuth 2.0".

Aplikasi Chrome

1. Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.

   Buka Kredensial

2. Klik Create Credentials > OAuth client ID.
3. Klik Jenis aplikasi > Aplikasi Chrome.
4. Di kolom "Nama", ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di konsol Google Cloud.
5. Di kolom "ID Aplikasi", masukkan string ID unik 32 karakter aplikasi Anda. Anda dapat menemukan nilai ID ini di URL Chrome Web Store aplikasi dan di Dasbor Developer Chrome Web Store.
6. Klik Create. Layar yang dibuat klien OAuth akan muncul, yang menampilkan Client ID dan Rahasia klien baru Anda.
7. Klik Oke. Kredensial yang baru dibuat akan muncul di bagian "Client ID OAuth 2.0".

Aplikasi desktop

1. Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.

   Buka Kredensial

2. Klik Create Credentials > OAuth client ID.
3. Klik Jenis aplikasi > Aplikasi desktop.
4. Di kolom Name, ketik nama untuk kredensial. Nama ini hanya ditampilkan di konsol Google Cloud.
5. Klik Create. Layar yang dibuat klien OAuth akan muncul, yang menampilkan Client ID dan Rahasia klien baru Anda.
6. Klik Oke. Kredensial yang baru dibuat akan muncul di bagian Client ID OAuth 2.0.

TV & Perangkat Input Terbatas

1. Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.

   Buka Kredensial

2. Klik Create Credentials > OAuth client ID.
3. Klik Jenis aplikasi > TV & Perangkat Input Terbatas.
4. Di kolom "Nama", ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di konsol Google Cloud.
5. Klik Create. Layar yang dibuat klien OAuth akan muncul, yang menampilkan Client ID dan Rahasia klien baru Anda.
6. Klik Oke. Kredensial yang baru dibuat akan muncul di bagian "Client ID OAuth 2.0".

Universal Windows Platform (UWP)

1. Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.

   Buka Kredensial

2. Klik Create Credentials > OAuth client ID.
3. Klik Jenis aplikasi > Universal Windows Platform (UWP).
4. Di kolom "Nama", ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di konsol Google Cloud.
5. Di kolom "ID Toko", masukkan nilai ID Microsoft Store unik 12 karakter aplikasi Anda. Anda dapat menemukan ID ini di URL Microsoft Store aplikasi Anda dan di Partner Center.
6. Klik Create. Layar yang dibuat klien OAuth akan muncul, yang menampilkan Client ID dan Rahasia klien baru Anda.
7. Klik Oke. Kredensial yang baru dibuat akan muncul di bagian "Client ID OAuth 2.0".

Mendownload file JSON secret klien

Catatan: Anda dapat melewati langkah ini jika menggunakan Apps Script.

File rahasia klien adalah representasi JSON kredensial client ID OAuth yang dapat dirujuk aplikasi Anda saat memberikan kredensial.

1. Di konsol Google Cloud, buka Menu > APIs & Services > Credentials.

   Buka Kredensial

2. Di bagian Client ID OAuth 2.0, klik client ID yang Anda buat.

3. Klik Download JSON.

4. Simpan file sebagai client_secrets.json.

Membuat dan berlangganan topik Pub/Sub

Di bagian ini, Anda akan membuat topik dan langganan Pub/Sub ke topik tersebut. Topik Pub/Sub Anda berfungsi sebagai endpoint notifikasi tempat langganan Google Workspace Anda menerima peristiwa.

Untuk mempelajari lebih lanjut cara membuat dan mengelola topik Pub/Sub, lihat dokumentasi Pub/Sub .

Untuk membuat dan berlangganan topik Pub/Sub:

Konsol Google Cloud

1. Di konsol Google Cloud, buka halaman Pub/Sub:

   Buka Google Cloud Pub/Sub

   Pastikan project Cloud untuk aplikasi Anda dipilih.

2. Klik Create topic dan lakukan tindakan berikut:

   1. Masukkan nama untuk topik Anda, seperti workspace-events-topic.
   2. Biarkan Tambahkan langganan default dipilih. Pub/Sub memberi nama langganan default ini mirip dengan nama topik Anda, seperti workspace-events-topic-sub.
   3. Opsional: Perbarui atau konfigurasikan properti tambahan untuk topik Anda.

3. Klik Create. Nama topik lengkap Anda diformat sebagai projects/PROJECT_ID/topics/TOPIC_ID. Anda akan menggunakan nama lengkap ini di langkah berikutnya.

4. Berikan akses untuk memublikasikan pesan Pub/Sub ke topik Anda:

   1. Di halaman topik, buka panel samping dan buka tab Izin.
   2. Klik Add Principal.
   3. Di kolom Add principals, tambahkan akun layanan untuk aplikasi Google Workspace yang mengirimkan peristiwa ke langganan Anda:
      1. Untuk peristiwa Chat, [e-mail].
      2. Untuk acara Meet, [e-mail].
   4. Di menu Tetapkan peran, pilih Pub/Sub Publisher.
   5. Klik Simpan. Mungkin perlu waktu beberapa menit untuk memperbarui izin untuk topik Anda.

gcloud

1. Di project Cloud Anda, buat topik dengan menjalankan perintah berikut:

   gcloud pubsub topics create TOPIC_ID

   Ganti TOPIC_ID dengan ID unik untuk topik Anda, seperti workspace-events-topic.

   Output menampilkan nama topik lengkap, yang diformat sebagai projects/PROJECT_ID/topics/TOPIC_ID. Catat nama, dan pastikan nilai untuk PROJECT_ID adalah project ID Cloud untuk aplikasi Anda. Anda akan menggunakan nama topik pada langkah berikut, dan untuk membuat langganan Google Workspace nanti.

2. Berikan akses untuk memublikasikan pesan ke topik Anda:

   gcloud pubsub topics add-iam-policy-binding TOPIC_NAME --member='serviceAccount:GOOGLE_WORKSPACE_APPLICATION' --role='roles/pubsub.publisher'

   Ganti kode berikut:

   • TOPIC_NAME: Nama topik lengkap, yang merupakan output dari langkah sebelumnya. Formatnya adalah projects/PROJECT_ID/topics/TOPIC_ID.

   • GOOGLE_WORKSPACE_APPLICATION: Aplikasi Google Workspace yang harus mengirimkan peristiwa ke langganan Anda:

     • Untuk menerima peristiwa dari Chat, gunakan [e-mail].
     • Untuk menerima peristiwa dari Meet, gunakan [e-mail].

   Diperlukan waktu beberapa menit untuk memperbarui izin topik Anda.

3. Buat langganan Pub/Sub untuk topik:

    gcloud pubsub subscriptions create SUBSCRIPTION_NAME --topic=TOPIC_NAME

   Ganti kode berikut:

   • SUBSCRIPTION_NAME: Nama untuk langganan Anda, seperti workspace-events-subscription.
   • TOPIC_NAME: Nama topik yang Anda buat di langkah sebelumnya.

Berlangganan resource Google Workspace

Di bagian ini, Anda akan berlangganan resource Google Workspace yang ingin dipantau peristiwanya.

Memilih dan mengidentifikasi resource target

Dalam langganan Google Workspace, resource target adalah resource Google Workspace yang Anda pantau untuk peristiwa. Resource target direpresentasikan di kolom targetResource langganan, yang diformat menggunakan nama resource lengkap. Misalnya, untuk langganan yang memantau ruang Google Chat (spaces/AAAABBBBBBB), nilai targetResource adalah //chat.googleapis.com/spaces/AAAABBBBBBB.

Sebelum membuat langganan, gunakan bagian berikut untuk mempelajari cara mengidentifikasi dan memformat resource target.

Mengidentifikasi resource target untuk Chat

Resource target	Format	Batasan
Spasi	//chat.googleapis.com/spaces/SPACE dengan SPACE adalah ID dalam nama resource resource space Chat API. Anda bisa mendapatkan ID dari URL ruang atau menggunakan metode spaces.list().	Pengguna Chat yang memberikan otorisasi langganan harus menjadi anggota ruang melalui Akun Google atau Google Workspace mereka.
Semua ruang untuk pengguna	//chat.googleapis.com/spaces/-	Langganan hanya menerima peristiwa untuk ruang tempat pengguna menjadi anggota melalui Google Workspace atau Akun Google mereka.
Pengguna	//cloudidentity.googleapis.com/users/USER dengan USER adalah ID dalam nama resource resource user Chat API. Untuk mengetahui detailnya, lihat Mengidentifikasi dan menentukan pengguna Google Chat.	Langganan hanya menerima peristiwa tentang pengguna yang memberikan otorisasi langganan. Pengguna tidak dapat memberikan otorisasi langganan atas nama pengguna lain.

Mengidentifikasi resource target untuk Meet

Resource target	Format	Batasan (jika ada)
Ruang rapat	//meet.googleapis.com/spaces/SPACE dengan SPACE adalah ID dalam nama resource resource space Meet REST API. Untuk mengetahui detailnya, lihat Cara Meet mengidentifikasi ruang rapat.
Pengguna	//cloudidentity.googleapis.com/users/USER dengan USER adalah ID di kolom signedinUser.user dari resource participant Meet REST API. Untuk mengetahui detailnya, lihat Menangani peserta.	Langganan menerima peristiwa tentang ruang rapat tempat pengguna adalah salah satu dari berikut: Pemilik ruang rapat. Penyelenggara acara Google Kalender yang terkait dengan ruang rapat.

Membuat langganan Google Workspace

Untuk membuat langganan, Anda menggunakan metode subscriptions.create() Google Workspace Events API untuk membuat resource Subscription. Anda menentukan kolom berikut:

• targetResource: Google Workspace yang Anda identifikasi di bagian sebelumnya, yang diformat menggunakan nama resource lengkapnya.
• eventTypes: Array satu atau beberapa jenis peristiwa yang ingin Anda terima tentang resource. Misalnya, jika aplikasi Anda hanya perlu mengetahui pesan baru yang diposting ke ruang Chat, aplikasi Anda cukup berlangganan peristiwa tentang pesan yang dibuat.
• notificationEndpoint: Endpoint notifikasi tempat langganan Google Workspace Anda mengirimkan peristiwa. Anda menggunakan topik Pub/Sub yang telah dibuat di bagian sebelumnya.
• payloadOptions: Opsi untuk menentukan jumlah data resource yang akan disertakan dalam payload peristiwa. Konfigurasi ini memengaruhi waktu habis masa berlaku untuk langganan Anda. Untuk mempelajari lebih lanjut, lihat Data peristiwa.

Untuk membuat langganan Google Workspace:

Apps Script

1. Di project Apps Script, buat file skrip baru bernama createSubscription dan tambahkan kode berikut:

   function createSubscription() {
     // The Google Workspace resource to monitor for events.
     const targetResource = 'TARGET_RESOURCE';
   
     // The types of events to receive.
     const eventTypes = [EVENT_TYPES];
   
     // The endpoint to deliver events to, such as a Google Cloud Pub/Sub topic.
     const pubsubTopic = 'TOPIC_NAME';
   
     // Whether to include resource data or not.
     const resourceData = RESOURCE_DATA;
   
     // Call the Workspace Events API using the advanced service.
     const response = WorkspaceEvents.Subscriptions.create({
       targetResource: targetResource,
       eventTypes: eventTypes,
       notificationEndpoint: {
         pubsubTopic: pubsubTopic,
       },
       payloadOptions: {
         includeResource: resourceData
       }
     });
     console.log(response);
   }
   

   Ganti kode berikut:

   • TARGET_RESOURCE: Resource Google Workspace yang Anda langgani, yang diformat sebagai nama resource lengkapnya. Misalnya, untuk berlangganan ruang Google Chat dengan ID ruang AAAABBBB, gunakan //chat.googleapis.com/spaces/AAAABBBB.
   • EVENT_TYPES: Satu atau beberapa jenis peristiwa yang ingin Anda jadikan langganan di resource target. Format sebagai array string seperti 'google.workspace.chat.message.v1.created'.
   • TOPIC_NAME: Nama lengkap topik Pub/Sub yang Anda buat di project Cloud. Formatnya adalah projects/PROJECT_ID/topics/TOPIC_ID.

   • RESOURCE_DATA: Boolean yang menentukan apakah langganan menyertakan data resource dalam payload:

     • True: Menyertakan semua data resource. Untuk membatasi kolom yang disertakan, tambahkan kolom fieldMask dan tentukan setidaknya satu kolom untuk resource yang diubah. Hanya langganan ke resource Chat yang mendukung, termasuk data resource.
     • False: Mengecualikan data resource.

2. Untuk membuat langganan Google Workspace, jalankan fungsi createSubscription di project Apps Script Anda.

Python

1. Di direktori kerja Anda, buat file bernama create_subscription.py dan tambahkan kode berikut:

   """Create subscription."""
   
   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Specify required scopes.
   SCOPES = [SCOPES]
   
   # Authenticate with Google Workspace and get user authentication.
   flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
   CREDENTIALS = flow.run_local_server()
   
   # The Google Workspace resource to monitor for events.
   TARGET_RESOURCE = 'TARGET_RESOURCE'
   
   # The types of events to receive.
   EVENT_TYPES = [EVENT_TYPES]
   
   # The endpoint to deliver events to, such as a Google Cloud Pub/Sub topic.
   TOPIC = 'TOPIC_NAME'
   
   # Call the Workspace Events API using the service endpoint.
   service = build(
       'workspaceevents',
       'v1',
       credentials=CREDENTIALS,
   )
   
   BODY = {
       'target_resource': TARGET_RESOURCE,
       'event_types': EVENT_TYPES,
       'notification_endpoint': {'pubsub_topic': TOPIC},
       'payload_options': {'include_resource': RESOURCE_DATA},
   }
   response = service.subscriptions().create(body=BODY).execute()
   print(response)
   

   Ganti kode berikut:

   • SCOPES: Satu atau beberapa cakupan OAuth yang mendukung setiap jenis peristiwa untuk langganan. Diformat sebagai array string. Untuk mencantumkan beberapa cakupan, pisahkan dengan koma. Misalnya, 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'.
   • TARGET_RESOURCE: Resource Google Workspace yang Anda langgani, yang diformat sebagai nama resource lengkapnya. Misalnya, untuk berlangganan ruang Google Chat dengan ID ruang AAAABBBB, gunakan //chat.googleapis.com/spaces/AAAABBBB.
   • EVENT_TYPES: Satu atau beberapa jenis peristiwa yang ingin Anda jadikan langganan di resource target. Format sebagai array string seperti 'google.workspace.chat.message.v1.created'.
   • TOPIC_NAME: Nama lengkap topik Pub/Sub yang Anda buat di project Cloud. Formatnya adalah projects/PROJECT_ID/topics/TOPIC_ID.

   • RESOURCE_DATA: Boolean yang menentukan apakah langganan menyertakan data resource dalam payload:

     • True: Menyertakan semua data resource. Untuk membatasi kolom yang disertakan, tambahkan kolom fieldMask dan tentukan setidaknya satu kolom untuk resource yang diubah. Hanya langganan ke resource Chat yang mendukung, termasuk data resource.
     • False: Mengecualikan data resource.

2. Untuk membuat langganan Google Workspace, jalankan perintah berikut di terminal Anda:

   python3 create_subscription.py

Google Workspace Events API menampilkan operasi yang berjalan lama yang telah selesai dan berisi instance resource Subscription yang Anda buat.

Menguji langganan Google Workspace

Untuk menguji bahwa Anda menerima peristiwa Google Workspace, Anda dapat memicu peristiwa dan menarik pesan ke langganan Pub/Sub.

Untuk menguji langganan Google Workspace Anda:

Konsol Google Cloud

1. Memicu satu atau beberapa jenis peristiwa di resource target langganan Google Workspace Anda. Misalnya, jika Anda telah berlangganan pesan baru di ruang Chat, posting pesan ke ruang tersebut.

2. Di konsol Google Cloud, buka halaman Pub/Sub:

   Buka Pub/Sub

   Pastikan project Cloud untuk aplikasi Anda dipilih.

3. Di menu Pub/Sub, klik Subscriptions.

4. Dalam tabel, temukan langganan Pub/Sub untuk topik Anda, lalu klik nama langganan.

5. Klik tab Pesan.

6. Klik Pull. Mungkin perlu waktu beberapa menit hingga peristiwa menghasilkan pesan Pub/Sub.

gcloud

1. Memicu satu atau beberapa jenis peristiwa di resource target langganan Google Workspace Anda. Misalnya, jika Anda telah berlangganan pesan baru di ruang Chat, posting pesan di ruang tersebut.

2. Jalankan perintah berikut:

   gcloud pubsub subscriptions pull PUBSUB_SUBSCRIPTION_NAME --format=json --limit=MESSAGE_COUNT --auto-ack

   Ganti kode berikut:

   • PUBSUB_SUBSCRIPTION_NAME: Nama lengkap langganan Pub/Sub Anda, yang diformat sebagai projects/SUBSCRIPTION_ID/subscriptions/SUBSCRIPTION_ID.
   • MESSAGE_COUNT: Jumlah maksimum pesan Pub/Sub yang ingin Anda ambil.

   Mungkin perlu waktu hingga beberapa menit bagi peristiwa untuk membuat pesan Pub/Sub.

Untuk setiap peristiwa Google Workspace yang Anda picu, pesan akan dikirim ke langganan Pub/Sub yang berisi peristiwa tersebut. Untuk mengetahui detailnya, lihat Menerima peristiwa sebagai pesan Google Cloud Pub/Sub.

Mengonfigurasi cara aplikasi Anda menerima peristiwa

Langganan Pub/Sub yang Anda buat berbasis pull. Setelah menguji langganan Pub/Sub, Anda dapat memperbarui jenis pengiriman untuk mengubah cara aplikasi menerima peristiwa. Misalnya, Anda dapat mengonfigurasi langganan Pub/Sub ke jenis pengiriman push, sehingga aplikasi Anda dapat menerima peristiwa langsung ke endpoint aplikasi.

Untuk mempelajari cara mengonfigurasi langganan Pub/Sub, lihat dokumentasi Pub/Sub.

Catatan: Anda tidak dapat menetapkan project Apps Script sebagai endpoint pengiriman push di Pub/Sub. Untuk mengirim pesan Pub/Sub ke project Apps Script, Anda harus memublikasikan skrip sebagai aplikasi web.

Topik terkait

• Tutorial: Mengamati peristiwa rapat dengan Python dan Google Meet REST API
• Mendapatkan langganan
• Mencantumkan langganan
• Memperbarui atau memperpanjang langganan
• Menyelesaikan error dan mengaktifkan kembali langganan
• Menghapus langganan