এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে মেসেজ থ্রেড 'পড়া হয়েছে' বা 'পড়া হয়নি' হিসেবে চিহ্নিত করতে, Google Chat API-এর ThreadReadState রিসোর্সে কীভাবে
update
পদ্ধতি ব্যবহার করতে হয়।
ThreadReadState রিসোর্স
হল একটি সিঙ্গলটন রিসোর্স যা Google Chat মেসেজ থ্রেডে নির্দিষ্ট ব্যবহারকারীর শেষবার পড়া মেসেজ সম্পর্কে
বিবরণ দেখায়।
পূর্বশর্ত
Node.js
- Google Chat-এ অ্যাক্সেস সহ Business বা Enterprise Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট-আপ করুন:
- Google Cloud প্রোজেক্ট তৈরি করুন।
- OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন কনফিগার করুন।
- আপনার Chat অ্যাপের নাম, আইকন ও বিবরণ সহ Google Chat API চালু ও কনফিগার করুন।
- Node.js Cloud Client Library ইনস্টল করুন।
-
ডেস্কটপ অ্যাপ্লিকেশনের জন্য OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন। এই গাইডে স্যাম্পেল রান করতে, আপনার লোকাল ডিরেক্টরিতে
credentials.jsonনামের JSON ফাইল হিসেবে ক্রেডেনশিয়াল সেভ করুন।
- এমন একটি অনুমোদনের স্কোপ বেছে নিন যা ব্যবহারকারীর যাচাইকরণকে সমর্থন করে।
Python
- Google Chat-এ অ্যাক্সেস সহ Business বা Enterprise Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট-আপ করুন:
- Google Cloud প্রোজেক্ট তৈরি করুন।
- OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন কনফিগার করুন।
- আপনার Chat অ্যাপের নাম, আইকন ও বিবরণ সহ Google Chat API চালু ও কনফিগার করুন।
- Python Cloud Client Library ইনস্টল করুন।
-
ডেস্কটপ অ্যাপ্লিকেশনের জন্য OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন। এই গাইডে স্যাম্পেল রান করতে, আপনার লোকাল ডিরেক্টরিতে
credentials.jsonনামের JSON ফাইল হিসেবে ক্রেডেনশিয়াল সেভ করুন।
- এমন একটি অনুমোদনের স্কোপ বেছে নিন যা ব্যবহারকারীর যাচাইকরণকে সমর্থন করে।
কল করা ব্যবহারকারীর থ্রেড পড়ার স্ট্যাটাস আপডেট করুন
মেসেজ থ্রেডের মধ্যে কোনও ব্যবহারকারীর পড়ার স্ট্যাটাস আপডেট করতে, আপনার অনুরোধে নিম্নলিখিত তথ্য অন্তর্ভুক্ত করুন:
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-এর ইনস্ট্যান্স
ফেরত পাঠায়।