Mendapatkan detail tentang status pembacaan ruang pengguna

Panduan ini menjelaskan cara menggunakan metode get() pada resource SpaceReadState Google Chat API untuk mendapatkan detail tentang status baca pengguna dalam ruang. Untuk mendapatkan status telah dibaca dari pesan dalam rangkaian pesan, lihat Mendapatkan detail tentang status telah dibaca rangkaian pesan pengguna.

Resource SpaceReadState adalah resource singleton yang mewakili detail tentang pesan terakhir yang dibaca pengguna tertentu di ruang Google Chat.

Prasyarat

Node.js

Mendapatkan status baca ruang pengguna yang menelepon

Untuk mendapatkan detail tentang status baca pengguna dalam ruang, sertakan hal berikut dalam permintaan Anda:

  • Tentukan cakupan otorisasi chat.users.readstate atau chat.users.readstate.readonly.
  • Panggil metode GetSpaceReadState(), dengan meneruskan name status baca ruang untuk mendapatkan yang mencakup ID pengguna atau alias dan ID ruang. Mendapatkan status baca ruang hanya mendukung mendapatkan status baca pengguna yang memanggil, yang dapat ditentukan dengan menyetel salah satu opsi berikut:
    • Alias me. Misalnya, users/me/spaces/SPACE/spaceReadState.
    • Alamat email Workspace pengguna yang menelepon. Misalnya, users/[email protected]/spaces/SPACE/spaceReadState.
    • ID pengguna pengguna yang menelepon. Misalnya, users/USER/spaces/SPACE/spaceReadState.

Contoh berikut mendapatkan status baca ruang pengguna yang menelepon:

Node.js

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

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.users.readstate.readonly'];

// This sample shows how to get the space read state for the calling user
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    name: 'users/me/spaces/SPACE_NAME/spaceReadState'
  };

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

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

main().catch(console.error);

Untuk menjalankan contoh ini, ganti SPACE_NAME dengan ID dari name ruang. Anda bisa mendapatkan ID dengan memanggil metode ListSpaces() atau dari URL ruang.

Google Chat API mendapatkan status pembacaan ruang yang ditentukan dan menampilkan instance SpaceReadState.