Mendapatkan detail tentang status pembacaan rangkaian pesan pengguna

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

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

Prasyarat

Node.js

Mendapatkan status sudah dibaca dari thread pengguna yang memanggil

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

Contoh berikut mendapatkan status sudah dibaca 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 berikut ini:

  • 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 dapat memperoleh 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 sudah dibaca dari rangkaian pesan yang ditentukan dan menampilkan instance ThreadReadState.