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.

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

Prasyarat

Node.js

Mendapatkan status baca rangkaian pesan pengguna yang menelepon

Untuk mendapatkan detail tentang status dibaca pengguna dalam rangkaian pesan, sertakan atribut berikut dalam permintaan Anda:

  • Tentukan chat.users.readstate atau chat.users.readstate.readonly cakupan otorisasi.
  • Panggil metode GetThreadReadState(), dengan meneruskan name status baca rangkaian pesan untuk mendapatkan yang mencakup ID pengguna atau alias dan ID ruang. Mendapatkan status baca thread hanya mendukung mendapatkan status baca 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 pengguna yang menelepon. Misalnya, users/USER/spaces/SPACE/threads/THREAD/threadReadState.

Contoh berikut mendapatkan status pembacaan thread pengguna yang pemanggil:

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 kode berikut:

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

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