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 telah dibaca pesan dalam ruang, lihat Mendapatkan detail tentang status baca 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

• Akun Google Workspace Business atau Enterprise dengan akses ke Google Chat.

• Siapkan lingkungan Anda:
  • Buat project Google Cloud.
  • Konfigurasikan layar izin OAuth.
  • Aktifkan dan konfigurasikan Google Chat API dengan nama, ikon, dan deskripsi untuk aplikasi Chat Anda.
  • Instal Library Klien Cloud Node.js.
  • Buat kredensial client ID OAuth untuk aplikasi desktop. Untuk menjalankan contoh dalam panduan ini, simpan kredensial sebagai file JSON bernama client_secrets.json ke direktori lokal Anda.
  Sebagai panduan, selesaikan langkah-langkah untuk menyiapkan lingkungan Anda di panduan memulai ini.
• Pilih cakupan otorisasi yang mendukung autentikasi pengguna.

Contoh kode di halaman ini menggunakan antarmuka gRPC API dengan library klien Google Cloud. Atau, Anda dapat menggunakan antarmuka REST API. Untuk informasi selengkapnya tentang antarmuka gRPC dan REST, lihat Ringkasan Google Chat API.

Mendapatkan status baca rangkaian pesan pengguna yang menelepon

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

• Tentukan cakupan otorisasi chat.users.readstate atau chat.users.readstate.readonly.
• Panggil metode GetThreadReadState(), yang meneruskan name status pembacaan thread untuk mendapatkan ID pengguna atau alias dan ID ruang. Mendapatkan status thread read hanya mendukung mendapatkan status baca pengguna yang memanggil, yang dapat ditentukan dengan menyetel salah satu opsi berikut:
  • Alias me. Misalnya, users/me/spaces/SPACE/threads/THREAD/threadReadState.
  • Alamat email Workspace pengguna yang menelepon. Misalnya, users/[e-mail]/spaces/SPACE/threads/THREAD/threadReadState.
  • ID pengguna pengguna yang menelepon. Misalnya, users/USER/spaces/SPACE/threads/THREAD/threadReadState.

Contoh berikut mendapatkan status baca thread pengguna yang memanggil:

Node.js

chat/client-libraries/cloud/get-thread-read-state-user-cred.js

Lihat di GitHub

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.

Topik terkait

• Perbarui status baca ruang pengguna yang menelepon.
• Mendapatkan status baca ruang pengguna yang menelepon.