Membuat langganan Google Workspace

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

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

  1. Menyiapkan lingkungan Anda.
  2. Membuat dan berlangganan topik Google Cloud Pub/Sub. Anda menggunakan topik ini sebagai endpoint untuk menerima peristiwa Google Workspace.
  3. Panggil create() Google Workspace Events API metode tersebut pada Subscription resource Anda
  4. Menguji langganan Google Workspace Anda untuk memastikan bahwa Pub/Sub Anda topic menerima peristiwa yang Anda ikuti.
  5. Anda juga dapat mengonfigurasi cara mengirim peristiwa ke endpoint untuk aplikasi Anda, sehingga aplikasi Anda dapat memproses peristiwa tersebut dan, jika perlu, mengambil tindakan.

Prasyarat

Apps Script

  • Project Google Cloud dengan penagihan diaktifkan. Untuk berlangganan Chat, Anda harus aktifkan Chat API di project Cloud Anda dan mengonfigurasi App name, Avatar URL, dan Description kolom. Untuk mengetahui detailnya, lihat Buat 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 izin dan mengidentifikasi cakupan yang diperlukan, melihat Pilih cakupan.
  • Project Apps Script:
    • Gunakan project Google Cloud Anda, bukan project default yang dibuat otomatis oleh Apps Script.
    • Untuk cakupan apa pun yang ditambahkan untuk mengonfigurasi layar izin OAuth, Anda juga harus menambahkan ke file appsscript.json di project Apps Script Anda. Contoh:
    • "oauthScopes": [
        "https://www.googleapis.com/auth/chat.messages.readonly"
      ]
          
    • Aktifkan layanan lanjutan Google Workspace Events.

Python

  • Python 3.6 atau yang lebih baru
  • Alat pengelolaan paket pip
  • Library klien Google terbaru untuk Python. Untuk menginstal atau mengupdatenya, jalankan perintah berikut di antarmuka command line Anda:
      pip3 install --upgrade google-api-python-client google-auth-oauthlib
      
  • Project Google Cloud dengan penagihan diaktifkan. Untuk berlangganan Chat, Anda harus aktifkan Chat API di project Cloud Anda dan mengonfigurasi App name, Avatar URL, dan Description kolom. Untuk mengetahui detailnya, lihat Buat 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 izin dan mengidentifikasi cakupan yang diperlukan, melihat Pilih cakupan.

Menyiapkan lingkungan Anda

Bagian berikut menjelaskan cara menyiapkan lingkungan Anda 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, 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 bagi aplikasi Anda.

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

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

Membuat kredensial client ID OAuth

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

Aplikasi web

  1. Di konsol Google Cloud, buka Menu > APIs & Layanan > Kredensial.

    Buka Kredensial

  2. Klik Create Credentials > OAuth client ID.
  3. Klik Jenis aplikasi > Aplikasi web.
  4. Di kolom Name, ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di Konsol Google Cloud.
  5. Tambahkan URI yang diberi otorisasi yang terkait dengan aplikasi Anda:
    • Aplikasi sisi klien (JavaScript)–Di bagian Asal JavaScript yang diotorisasi, klik Tambahkan URI. Kemudian, masukkan URI yang akan digunakan untuk permintaan browser. Atribut ini mengidentifikasi domain tempat aplikasi Anda dapat mengirim permintaan API ke server OAuth 2.0.
    • Aplikasi sisi server (Java, Python, dan lainnya)–Di bagian Authorized redirect URI, klik Add URI. Kemudian, masukkan URI endpoint yang dapat menerima respons dari server OAuth 2.0.
  6. Klik Buat. Layar yang dibuat klien OAuth akan muncul, yang menunjukkan Client ID dan Rahasia klien baru Anda.

    Catat Client-ID-nya. 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 & Layanan > Kredensial.

    Buka Kredensial

  2. Klik Create Credentials > OAuth client ID.
  3. Klik Jenis aplikasi > Android.
  4. Di bagian "Nama" , ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di Konsol Google Cloud.
  5. Di bagian "Package name" , masukkan nama paket dari file AndroidManifest.xml Anda.
  6. Di "Sidik jari sertifikat SHA-1" masukkan sidik jari sertifikat SHA-1 yang dihasilkan.
  7. Klik Buat. Layar yang dibuat klien OAuth 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 & Layanan > Kredensial.

    Buka Kredensial

  2. Klik Create Credentials > OAuth client ID.
  3. Klik Jenis aplikasi > iOS.
  4. Di bagian "Nama" , ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di Konsol Google Cloud.
  5. Di "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 bagian "Team ID" , masukkan string unik 10 karakter, yang dibuat oleh Apple dan ditetapkan ke tim Anda.
  8. Klik Buat. Layar yang dibuat klien OAuth akan muncul, yang menunjukkan 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 & Layanan > Kredensial.

    Buka Kredensial

  2. Klik Create Credentials > OAuth client ID.
  3. Klik Jenis aplikasi > Aplikasi Chrome.
  4. Di bagian "Nama" , ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di Konsol Google Cloud.
  5. Di "Application ID" , masukkan string ID 32 karakter unik untuk aplikasi Anda. Anda dapat menemukan nilai ID ini di URL Chrome Web Store aplikasi dan di Dasbor Developer Chrome Web Store.
  6. Klik Buat. Layar yang dibuat klien OAuth akan muncul, yang menunjukkan 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 & Layanan > Kredensial.

    Buka Kredensial

  2. Klik Create Credentials > OAuth client ID.
  3. Klik Jenis aplikasi > Aplikasi desktop.
  4. Di kolom Name, ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di Konsol Google Cloud.
  5. Klik Buat. Layar yang dibuat klien OAuth akan muncul, yang menunjukkan 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 & Layanan > Kredensial.

    Buka Kredensial

  2. Klik Create Credentials > OAuth client ID.
  3. Klik Jenis aplikasi > TV & Perangkat Input terbatas.
  4. Di bagian "Nama" , ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di Konsol Google Cloud.
  5. Klik Buat. Layar yang dibuat klien OAuth akan muncul, yang menunjukkan 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 & Layanan > Kredensial.

    Buka Kredensial

  2. Klik Create Credentials > OAuth client ID.
  3. Klik Jenis aplikasi > Universal Windows Platform (UWP).
  4. Di bagian "Nama" , ketik nama untuk kredensial tersebut. Nama ini hanya ditampilkan di Konsol Google Cloud.
  5. Di "ID Toko" masukkan nilai ID Microsoft Store 12 karakter unik untuk aplikasi Anda. Anda dapat menemukan ID ini di URL Microsoft Store aplikasi Anda dan di Pusat Partner.
  6. Klik Buat. Layar yang dibuat klien OAuth akan muncul, yang menunjukkan 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 rahasia klien

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

  1. Di konsol Google Cloud, buka Menu > API & Layanan > Kredensial.

    Buka Kredensial

  2. Pada 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. 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 Pub/Sub dokumentasi kami.

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 sudah dipilih.

  2. Klik Buat topik, lalu lakukan hal berikut:

    1. Masukkan nama untuk topik Anda, seperti workspace-events-topic.
    2. Biarkan Add a default subscription tetap dipilih. Pub/Sub menamai ini langganan default yang mirip dengan nama topik Anda, misalnya workspace-events-topic-sub.
    3. Opsional: Perbarui atau konfigurasi properti tambahan untuk topik Anda.
  3. Klik Buat. 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:
      1. Untuk peristiwa Chat, chat-api-push@system.gserviceaccount.com.
      2. Untuk acara Meet, meet-api-event-push@system.gserviceaccount.com.
    4. Di menu Tetapkan peran, pilih Pub/Sub Publisher.
    5. Klik Simpan. Perlu waktu beberapa menit untuk memperbarui izin untuk topik Anda.

gcloud

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

    gcloud pubsub topics create TOPIC_ID
    

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

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

  2. Memberikan 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. Diformat sebagai 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 chat-api-push@system.gserviceaccount.com.
      • Untuk menerima acara dari Meet, gunakan meet-api-event-push@system.gserviceaccount.com.

    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 referensi Google Workspace

Di bagian ini, Anda akan berlangganan referensi Google Workspace yang yang ingin Anda pantau peristiwanya.

Memilih dan mengidentifikasi resource target

Dalam langganan Google Workspace, resource target adalah Resource Google Workspace yang Anda pantau untuk peristiwa. Target resource diwakili dalam kolom targetResource langganan, yang diformat menggunakan nama lengkap resource. 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 sumber daya target.

Mengidentifikasi resource target untuk Chat

Resource target Format Batasan
Spasi

//chat.googleapis.com/spaces/SPACE

dengan SPACE adalah ID di nama resource resource space Chat API. Anda bisa mendapatkan ID dari URL ruang atau menggunakan spaces.list().

Pengguna Chat yang memberi otorisasi langganan harus menjadi anggota ruang melalui fitur Google Workspace atau menggunakan Akun Layanan Anda.
Semua ruang untuk pengguna

//chat.googleapis.com/spaces/-

Langganan hanya menerima peristiwa untuk ruang tempat pengguna berada anggota melalui Google Workspace atau Akun Google mereka.
Pengguna

//cloudidentity.googleapis.com/users/USER

dengan USER adalah ID di nama resource resource user Chat API. Untuk mengetahui detailnya, lihat Identifikasi dan tentukan Pengguna Google Chat.

Langganan hanya menerima peristiwa tentang pengguna yang mengesahkan langganan. Pengguna tidak dapat mengizinkan langganan di nama pengguna lain.

Mengidentifikasi resource target untuk Meet

Resource target Format Batasan (jika ada)
Ruang pertemuan //meet.googleapis.com/spaces/SPACE

dengan SPACE adalah ID di nama resource resource space Meet REST API. Untuk mengetahui detailnya, lihat Bagaimana 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 Bekerja sama dengan peserta.

Langganan menerima peristiwa tentang ruang rapat tempat adalah salah satu dari berikut ini:

  • Pemilik ruang rapat.
  • Penyelenggara acara Google Kalender yang terkait dengan ruang rapat.

Buat langganan Google Workspace

Untuk membuat langganan, gunakan Metode subscriptions.create() untuk membuat Subscription resource Anda Anda menentukan kolom berikut:

  • targetResource: Google Workspace yang Anda identifikasi di bagian sebelumnya, yang diformat menggunakan nama resource lengkap.
  • eventTypes: Array dari satu atau beberapa jenis peristiwa yang ingin Anda terima resource Anda. Misalnya, jika aplikasi Anda hanya perlu mengetahui pesan baru yang diposting ke ruang Chat, aplikasi Anda dapat langsung berlangganan acara tentang pesan yang dibuat.
  • notificationEndpoint: Endpoint notifikasi tempat Langganan Google Workspace menayangkan peristiwa. Anda menggunakan Topik Pub/Sub yang Anda buat di bagian sebelumnya.
  • payloadOptions: Opsi untuk menentukan banyaknya data resource yang akan disertakan payload peristiwa. Konfigurasi ini memengaruhi waktu habis masa berlaku untuk langganan Anda. Untuk mempelajari lebih lanjut, lihat Peristiwa data Anda.

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: Referensi Google Workspace langganan Anda, yang diformat sebagai nama resource lengkap. Sebagai misalnya, berlangganan ruang Google Chat dengan ID ruang AAAABBBB, gunakan //chat.googleapis.com/spaces/AAAABBBB.
    • EVENT_TYPES: Satu atau beberapa jenis peristiwa yang ingin Anda ikuti di resource target. Format sebagai array string, seperti 'google.workspace.chat.message.v1.created'.
    • TOPIC_NAME: Nama lengkap topik Pub/Sub yang yang Anda buat di project Cloud. Diformat sebagai projects/PROJECT_ID/topics/TOPIC_ID.
    • RESOURCE_DATA: Boolean yang menentukan apakah nilai langganan menyertakan data resource dalam payload:

      • True: Menyertakan semua data resource. Untuk membatasi {i>field<i} mana yang disertakan, tambahkan fieldMask dan menentukan setidaknya satu bidang untuk sumber daya yang diubah. Hanya langganan ke dukungan resource Chat, 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, 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: Referensi Google Workspace langganan Anda, yang diformat sebagai nama resource lengkap. Sebagai misalnya, berlangganan ruang Google Chat dengan ID ruang AAAABBBB, gunakan //chat.googleapis.com/spaces/AAAABBBB.
    • EVENT_TYPES: Satu atau beberapa jenis peristiwa yang ingin Anda ikuti di resource target. Format sebagai array string, seperti 'google.workspace.chat.message.v1.created'.
    • TOPIC_NAME: Nama lengkap topik Pub/Sub yang yang Anda buat di project Cloud. Diformat sebagai projects/PROJECT_ID/topics/TOPIC_ID.
    • RESOURCE_DATA: Boolean yang menentukan apakah nilai langganan menyertakan data resource dalam payload:

      • True: Menyertakan semua data resource. Untuk membatasi {i>field<i} mana yang disertakan, tambahkan fieldMask dan menentukan setidaknya satu bidang untuk sumber daya yang diubah. Hanya langganan ke dukungan resource Chat, 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 aktivitas berjalan lama operasi yang berisi metode dari resource Subscription yang telah Anda buat.

Menguji langganan Google Workspace Anda

Untuk menguji apakah Anda menerima peristiwa Google Workspace, Anda dapat memicu 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 Google Workspace Anda. Misalnya, jika Anda sudah berlangganan pesan di ruang Chat, memposting pesan ke ruang.

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

    Buka Pub/Sub

    Pastikan project Cloud untuk aplikasi Anda sudah dipilih.

  3. Di menu Pub/Sub, klik Langganan.

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

  5. Klik tab Pesan.

  6. Klik Pull. Diperlukan waktu hingga beberapa menit untuk membuat sebuah peristiwa pesan Pub/Sub.

gcloud

  1. Memicu satu atau beberapa jenis peristiwa di resource target Google Workspace Anda. Misalnya, jika Anda sudah berlangganan dalam ruang Chat, memposting pesan dalam ruang.

  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, yang diformat sebagai projects/SUBSCRIPTION_ID/subscriptions/SUBSCRIPTION_ID.
    • MESSAGE_COUNT: Jumlah maksimum pesan Pub/Sub yang ingin Anda tarik.

    Diperlukan waktu hingga beberapa menit bagi peristiwa untuk membuat Pub/Sub untuk membuat pesan email baru.

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

Mengonfigurasi cara aplikasi menerima peristiwa

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

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