Mendapatkan detail tentang status pembacaan rangkaian pesan pengguna

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

Resource ThreadReadState adalah resource singleton yang mewakili detail tentang pesan terakhir yang dibaca pengguna tertentu dalam rangkaian pesan Google Chat.

Prasyarat

Node.js

Mendapatkan status baca rangkaian pesan pengguna yang menelepon

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

  • Tentukan cakupan otorisasi chat.users.readstate atau chat.users.readstate.readonly.
  • Panggil metode GetThreadReadState(), dengan meneruskan name status baca rangkaian pesan untuk mendapatkan yang mencakup ID pengguna atau alias dan ID ruang. Mendapatkan status pembacaan thread hanya mendukung mendapatkan status pembacaan pengguna pemanggil, yang dapat ditentukan dengan menetapkan salah satu dari berikut:
    • Alias me. Misalnya, users/me/spaces/SPACE/threads/THREAD/threadReadState.
    • Alamat email Workspace pengguna yang menelepon. Misalnya, users/user@example.com/spaces/SPACE/threads/THREAD/threadReadState.
    • ID pengguna yang melakukan panggilan. Misalnya, users/USER/spaces/SPACE/threads/THREAD/threadReadState.

Contoh berikut mendapatkan status pembacaan thread pengguna yang memanggil:

Node.js

chat/client-libraries/cloud/get-thread-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 thread read state for a space and 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 and THREAD_NAME here
    name: 'users/me/spaces/SPACE_NAME/threads/THREAD_NAME/threadReadState'
  };

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

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

main().catch(console.error);

Untuk menjalankan contoh ini, ganti hal berikut:

  • SPACE_NAME: ID dari name ruang. Anda bisa mendapatkan ID dengan memanggil metode ListSpaces() atau dari URL ruang.
  • THREAD_NAME: ID dari name thread. Anda bisa mendapatkan ID dari isi respons yang ditampilkan setelah membuat pesan secara asinkron dengan Chat API, atau dengan nama kustom yang ditetapkan ke pesan saat pembuatan.

Google Chat API mendapatkan status baca rangkaian pesan yang ditentukan dan menampilkan instance ThreadReadState.