Mendapatkan detail tentang acara ruang Google Chat

Panduan ini menjelaskan cara menggunakan metode get() pada resource SpaceEvent Google Chat API untuk mendapatkan detail tentang peristiwa dari ruang Google Chat.

Resource SpaceEvent mewakili perubahan pada ruang atau resource turunannya, seperti pesan, reaksi, dan keanggotaan. Untuk mempelajari jenis peristiwa yang didukung, lihat dokumentasi referensi kolom eventType dari resource SpaceEvent.

Anda dapat meminta acara hingga 28 hari sebelum waktu permintaan. Peristiwa berisi versi terbaru dari resource yang berubah. Misalnya, jika Anda meminta peristiwa tentang pesan baru, tetapi pesan tersebut kemudian diperbarui, server akan menampilkan resource Message yang diperbarui dalam payload peristiwa.

Untuk memanggil metode ini, Anda harus menggunakan autentikasi pengguna. Untuk mendapatkan acara, pengguna yang diautentikasi harus menjadi anggota ruang tempat acara terjadi.

Prasyarat

Node.js

Mendapatkan detail tentang acara ruang

Untuk mendapatkan detail tentang acara ruang di Google Chat, teruskan hal berikut dalam permintaan Anda:

  • Tentukan cakupan otorisasi yang mendukung jenis peristiwa dalam permintaan Anda. Sebagai praktik terbaik, pilih cakupan paling ketat yang tetap memungkinkan aplikasi Anda berfungsi.
  • Panggil metode GetSpaceEvent(), dengan meneruskan name peristiwa ruang yang akan didapatkan.

Contoh berikut mendapatkan peristiwa ruang:

Node.js

chat/client-libraries/cloud/get-space-event-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

// Replace SCOPE_NAME here with an authorization scope based on the event type
const USER_AUTH_OAUTH_SCOPES = ['SCOPE_NAME'];

// This sample shows how to get space event with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(
      USER_AUTH_OAUTH_SCOPES,
  );

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME and SPACE_EVENT_NAME here
    name: 'spaces/SPACE_NAME/spaceEvents/SPACE_EVENT_NAME',
  };

  // Make the request
  const response = await chatClient.getSpaceEvent(request);

  // Handle the response
  console.log(response);
}

await main();

Untuk menjalankan contoh ini, ganti berikut ini:

  • SCOPE_NAME: cakupan otorisasi berdasarkan jenis peristiwa. Misalnya, jika Anda mendapatkan peristiwa ruang tentang langganan baru, gunakan cakupan chat.memberships.readonly, yang diformat sebagai https://www.googleapis.com/auth/chat.memberships.readonly. Anda bisa mendapatkan jenis peristiwa dari metode ListSpaceEvents(). Untuk mempelajari cara menggunakan metode ini, lihat Mencantumkan peristiwa dari ruang.
  • SPACE_NAME: ID dari name ruang. Anda bisa mendapatkan ID dengan memanggil metode ListSpaces() atau dari URL ruang.
  • SPACE_EVENT_NAME: ID dari name peristiwa ruang. Anda bisa mendapatkan ID dari metode ListSpaceEvents(). Untuk mempelajari cara menggunakan metode ini, lihat Mencantumkan peristiwa dari ruang.

Chat API menampilkan instance SpaceEvent dengan detail tentang peristiwa.