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 sudah dibaca pengguna dalam ruang. Untuk mendapatkan status baca pesan dalam rangkaian pesan, lihat Mendapatkan detail tentang status baca rangkaian pesan pengguna.

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

Prasyarat

Mendapatkan status baca ruang pengguna yang memanggil

Untuk mendapatkan detail 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 status baca ruang yang mencakup ID atau alias pengguna dan ID ruang. Mendapatkan status baca ruang hanya mendukung mendapatkan status baca pengguna yang memanggil, yang dapat ditentukan dengan menetapkan salah satu dari berikut:
  • Alias me. Misalnya, users/me/spaces/SPACE/spaceReadState.
  • Alamat email Workspace pengguna yang memanggil. Misalnya, users/user@example.com/spaces/SPACE/spaceReadState.
  • ID pengguna pemanggil. Misalnya, users/USER/spaces/SPACE/spaceReadState.

Contoh berikut mendapatkan status baca ruang pengguna yang memanggil:

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 sudah dibaca ruang yang ditentukan dan menampilkan instance SpaceReadState.

Topik terkait

• Memperbarui status baca ruang pengguna yang memanggil.
• Mendapatkan status baca thread pengguna yang memanggil.