ব্যবহারকারীর থ্রেড পড়ার স্ট্যাটাস আপডেট করুন

এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে মেসেজ থ্রেড 'পড়া হয়েছে' বা 'পড়া হয়নি' হিসেবে চিহ্নিত করতে, Google Chat API-এর ThreadReadState রিসোর্সে কীভাবে update পদ্ধতি ব্যবহার করতে হয়।

ThreadReadState রিসোর্স হল একটি সিঙ্গলটন রিসোর্স যা Google Chat মেসেজ থ্রেডে নির্দিষ্ট ব্যবহারকারীর শেষবার পড়া মেসেজ সম্পর্কে বিবরণ দেখায়।

পূর্বশর্ত

Node.js

Python

কল করা ব্যবহারকারীর থ্রেড পড়ার স্ট্যাটাস আপডেট করুন

মেসেজ থ্রেডের মধ্যে কোনও ব্যবহারকারীর পড়ার স্ট্যাটাস আপডেট করতে, আপনার অনুরোধে নিম্নলিখিত তথ্য অন্তর্ভুক্ত করুন:

  • chat.users.readstate অনুমোদনের স্কোপ উল্লেখ করুন।
  • UpdateThreadReadState মেথড কল করুন।
  • lastReadTime ভ্যালু সহ updateMask পাস করুন।
  • threadReadState-কে ThreadReadState-এর ইনস্ট্যান্স হিসেবে পাস করুন নিম্নলিখিত সহ:
    • name ফিল্ডটি আপডেট করার জন্য থ্রেড রিড স্টেটে সেট করা হয়েছে, যার মধ্যে একটি ব্যবহারকারীর আইডি বা উপনাম, একটি স্পেস আইডি এবং একটি থ্রেড আইডি অন্তর্ভুক্ত রয়েছে। থ্রেড পড়ার স্ট্যাটাস আপডেট করা শুধুমাত্র কলিং ব্যবহারকারীর পড়ার স্ট্যাটাস আপডেট করাকে সমর্থন করে, যা নিম্নলিখিতগুলির মধ্যে একটি সেট করে নির্দিষ্ট করা যেতে পারে:
      • me অ্যালিয়াস। যেমন, users/me/spaces/SPACE/threads/THREAD/threadReadState।
      • কল করা ব্যবহারকারীর Workspace ইমেল আইডি। যেমন, users/user@example.com/spaces/SPACE/threads/THREAD/threadReadState।
      • কল করা ব্যবহারকারীর ইউজার আইডি। যেমন, users/USER/spaces/SPACE/threads/THREAD/threadReadState।
    • lastReadTime ফিল্ডটি টাইমস্ট্যাম্পে সেট করা আছে যা থ্রেডে কলিং ব্যবহারকারীর শেষ পঠিত অবস্থান চিহ্নিত করে, যেমন শেষ পঠিত মেসেজের টাইমস্ট্যাম্প বা বর্তমান সময়:
      • পড়া হয়নি হিসেবে চিহ্নিত করুন: থ্রেডের লেটেস্ট মেসেজ তৈরি হওয়ার সময়ের আগের টাইমস্ট্যাম্পে lastReadTime সেট করুন। Chat-এ, থ্রেডটি সেই টাইমস্ট্যাম্প থেকে 'পড়া হয়নি' হিসেবে দেখানো হয়, 'পড়া হয়নি' ব্যাজ আপডেট করা হয়, থ্রেডটি বোল্ড করা হয় এবং হোম-এ দেখানো হয়।
      • পড়া হয়েছে হিসেবে চিহ্নিত করুন: থ্রেডের লেটেস্ট মেসেজ তৈরি করার সময়ের সমান বা তার পরের টাইমস্ট্যাম্পে lastReadTime সেট করুন। আপনি যদি ভবিষ্যতের কোনও টাইমস্ট্যাম্প উল্লেখ করেন, তাহলে API বর্তমান অনুরোধের সময় অনুযায়ী lastReadTime বাধ্যতামূলকভাবে সেট করে।
      • ন্যূনতম টাইমস্ট্যাম্প: lastReadTime ফিল্ডটি অবশ্যই Unix epoch (1970-01-01T00:00:00Z)-এর সময়ে বা পরে হতে হবে। নেগেটিভ টাইমস্ট্যাম্প (1970-01-01T00:00:00Z-এর আগে) সেট করলে INVALID_ARGUMENT (400) সমস্যা দেখায়।

নিম্নলিখিত উদাহরণটি কলিং ব্যবহারকারীর থ্রেড পড়ার স্ট্যাটাস আপডেট করে:

Node.js

/**
 * This sample shows how to update the calling user's thread read state.
 *
 * It relies on the @google-apps/chat npm package.
 */
// Read the documentation for more details:
// https://developers.google.com/workspace/chat/api/reference/rest/v1/users.spaces.threads/updateThreadReadState

const {ChatServiceClient} = require('@google-apps/chat');
const {auth} = require('google-auth-library');

async function main() {
  // Create a client
  const chatClient = new ChatServiceClient({
    authClient: await auth.getClient({
      scopes: ['https://www.googleapis.com/auth/chat.users.readstate']
    })
  });

  // Initialize request arguments.
  const request = {
    threadReadState: {
      name: 'users/me/spaces/SPACE_NAME/threads/THREAD_NAME/threadReadState',
      lastReadTime: {
        seconds: Math.floor(Date.now() / 1000),
        nanos: 0
      }
    },
    updateMask: {
      paths: ['last_read_time']
    }
  };

  // Make the request
  const response = await chatClient.updateThreadReadState(request);
  console.log(response);
}

main().catch(console.error);

Python

"""
This sample shows how to update the calling user's thread read state.
"""
from google.apps import chat_v1
import google.auth
from google.protobuf import timestamp_pb2

# Read the documentation for more details:
# https://developers.google.com/workspace/chat/api/reference/rest/v1/users.spaces.threads/updateThreadReadState

def update_thread_read_state():
    # Authenticate with Chat API using user credentials.
    credentials, _ = google.auth.default(
        scopes=["https://www.googleapis.com/auth/chat.users.readstate"]
    )
    client = chat_v1.ChatServiceClient(credentials=credentials)

    # Set timestamp for last read time.
    now = timestamp_pb2.Timestamp()
    now.GetCurrentTime()

    thread_read_state = chat_v1.ThreadReadState(
        name="users/me/spaces/SPACE_NAME/threads/THREAD_NAME/threadReadState",
        last_read_time=now,
    )

    request = chat_v1.UpdateThreadReadStateRequest(
        thread_read_state=thread_read_state,
        update_mask={"paths": ["last_read_time"]},
    )

    response = client.update_thread_read_state(request=request)
    print(response)

if __name__ == "__main__":
    update_thread_read_state()

এই স্যাম্পেল রান করতে, নিম্নলিখিতগুলি পরিবর্তন করুন:

  • SPACE_NAME: স্পেসের name থেকে আইডি। আপনি ListSpaces মেথড কল করে বা স্পেসের URL থেকে ID পেতে পারেন।
  • THREAD_NAME: থ্রেডের আইডি name. Chat API-এর মাধ্যমে অ্যাসিঙ্ক্রোনাসভাবে মেসেজ তৈরি করার পরে, আপনি রেসপন্স বডি থেকে আইডি পেতে পারেন অথবা মেসেজ তৈরি করার সময় সেটিতে অ্যাসাইন করা কাস্টম নাম থেকেও আইডি পেতে পারেন।

Chat API নির্দিষ্ট থ্রেড পড়ার স্ট্যাটাস আপডেট করে এবং ThreadReadState-এর ইনস্ট্যান্স ফেরত পাঠায়।