با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این راهنما نحوه استفاده از متد update() را در منبع SpaceReadState در Google Chat API برای علامت گذاری فضاها به عنوان خوانده شده یا خوانده نشده توضیح می دهد.
منبع SpaceReadState یک منبع تکی است که جزئیات مربوط به آخرین پیام خوانده شده کاربر مشخص شده را در فضای چت Google نشان می دهد.
spaceReadState به عنوان نمونه ای از SpaceReadState با موارد زیر ارسال کنید:
فیلد name روی وضعیت خواندن فاصله برای به‌روزرسانی تنظیم شده است که شامل شناسه کاربری یا نام مستعار و شناسه فاصله است. به‌روزرسانی وضعیت خواندن فضا فقط از به‌روزرسانی وضعیت خواندن کاربر تماس‌گیرنده پشتیبانی می‌کند که با تنظیم یکی از موارد زیر می‌توان آن را تعیین کرد:
me مستعار من برای مثال، users/me/spaces/ SPACE /spaceReadState .
آدرس ایمیل کاربر تماس گیرنده Workspace. به عنوان مثال، users/user@example.com/spaces/ SPACE /spaceReadState .
شناسه کاربری کاربر تماس گیرنده. به عنوان مثال، users/ USER /spaces/ SPACE /spaceReadState .
فیلد lastReadTime روی مقدار به روز شده زمانی تنظیم شده است که وضعیت خواندن فضای کاربر به روز شده است. معمولاً این با مهر زمانی آخرین پیام خوانده شده یا مهر زمانی مشخص شده توسط کاربر برای علامت گذاری آخرین موقعیت خوانده شده در یک فاصله مطابقت دارد. وقتی lastReadTime قبل از زمان ایجاد آخرین پیام باشد، فضا به صورت خوانده نشده در UI ظاهر می شود. برای علامت‌گذاری فضا به‌عنوان خوانده‌شده، lastReadTime روی هر مقدار دیرتر (بزرگ‌تر) از زمان ایجاد آخرین پیام تنظیم کنید. lastReadTime مجبور می شود با آخرین زمان ایجاد پیام مطابقت داشته باشد. توجه داشته باشید که وضعیت خواندن فاصله فقط بر وضعیت خواندن پیام‌هایی که در مکالمه سطح بالای فضا قابل مشاهده هستند تأثیر می‌گذارد. پاسخ‌های موجود در رشته‌ها تحت تأثیر این مُهر زمانی قرار نمی‌گیرند، و در عوض به وضعیت خواندن رشته متکی هستند.
مثال زیر وضعیت خواندن فضای کاربر تماس گیرنده را به روز می کند:
import{createClientWithUserCredentials}from'./authentication-utils.js';constUSER_AUTH_OAUTH_SCOPES=['https://www.googleapis.com/auth/chat.users.readstate'];// This sample shows how to update a space read state for the calling userasyncfunctionmain(){// Create a clientconstchatClient=awaitcreateClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);// Initialize request argument(s)consttimestamp=newDate('2000-01-01').getTime();constrequest={spaceReadState:{// Replace SPACE_NAME herename:'users/me/spaces/SPACE_NAME/spaceReadState',lastReadTime:{seconds:Math.floor(timestamp/1000),nanos:(timestamp%1000)*1000000}},updateMask:{// The field paths to update.paths:['last_read_time']}};// Make the requestconstresponse=awaitchatClient.updateSpaceReadState(request);// Handle the responseconsole.log(response);}main().catch(console.error);
برای اجرای این نمونه، SPACE_NAME با شناسه name فضا جایگزین کنید. شما می توانید شناسه را با فراخوانی متد ListSpaces() یا از URL فضا بدست آورید.
Google Chat API وضعیت خواندن فضای مشخص شده را به روز می کند و نمونه ای از SpaceReadState را برمی گرداند.
تاریخ آخرین به‌روزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis guide explains how to use the \u003ccode\u003eupdate()\u003c/code\u003e method to mark Google Chat spaces as read or unread.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eSpaceReadState\u003c/code\u003e resource stores a user's last read message details in a space.\u003c/p\u003e\n"],["\u003cp\u003eTo update read state, use the \u003ccode\u003eUpdateSpaceReadState()\u003c/code\u003e method with the \u003ccode\u003elastReadTime\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eYou need a Google Workspace account and a configured Google Chat API to use this functionality.\u003c/p\u003e\n"],["\u003cp\u003eNode.js code samples and related topics are provided for practical implementation.\u003c/p\u003e\n"]]],["To update a user's read state in a Google Chat space, use the `UpdateSpaceReadState()` method with the `chat.users.readstate` authorization scope. Set the `name` field in `SpaceReadState` to the user's ID or alias and the space ID. Adjust the `lastReadTime` to reflect when the user last read messages; setting it before the latest message time marks the space as unread. Use `updateMask` with `lastReadTime`. The API returns the updated `SpaceReadState`.\n"],null,["# Update a user's space read state\n\nThis guide explains how to use the\n[`update()`](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.ChatService.UpdateSpaceReadState)\nmethod on the `SpaceReadState` resource of the Google Chat API to mark spaces as\nread or unread.\n\nThe\n[`SpaceReadState` resource](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.SpaceReadState)\nis a singleton resource that represents details about a\nspecified user's last read message in a Google Chat space.\n\nPrerequisites\n-------------\n\n\n### Node.js\n\n- A Business or Enterprise [Google Workspace](https://support.google.com/a/answer/6043576) account with access to [Google Chat](https://workspace.google.com/products/chat/).\n\n\u003c!-- --\u003e\n\n- Set up your environment:\n - [Create a Google Cloud project](/workspace/guides/create-project).\n - [Configure the OAuth consent screen](/workspace/guides/configure-oauth-consent).\n - [Enable and configure the Google Chat API](/workspace/chat/configure-chat-api) with a name, icon, and description for your Chat app.\n - Install the Node.js [Cloud Client Library](/workspace/chat/libraries?tab=nodejs#cloud-client-libraries).\n - [Create OAuth client ID credentials](/workspace/chat/authenticate-authorize-chat-user#step-2:) for a desktop application. To run the sample in this guide, save the credentials as a JSON file named `credentials.json` to your local directory.\n\n For guidance, complete the steps for setting up your environment in this [quickstart](/workspace/chat/api/guides/quickstart/nodejs\n #set-up-environment).\n- [Choose an authorization scope](/workspace/chat/authenticate-authorize#asynchronous-chat-calls) that supports user authentication.\n\n\n| The code samples in this page use the gRPC API interface with the Google Cloud client libraries. Alternatively, you can use the REST API interface. For more information about the gRPC and REST interfaces, see [Google Chat API overview](/workspace/chat/api/reference).\n\n\u003cbr /\u003e\n\nUpdate the calling user's space read state\n------------------------------------------\n\nTo update a user's read state within a space, include the following in\nyour request:\n\n- Specify the `chat.users.readstate` authorization scope.\n- Call the [`UpdateSpaceReadState()`](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.ChatService.UpdateSpaceReadState) method.\n- Pass `updateMask` with the value `lastReadTime`.\n- Pass `spaceReadState` as an instance of [`SpaceReadState`](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.SpaceReadState) with the following:\n - The `name` field set to the space read state to update, which includes a user ID or alias and a space ID. Updating space read state only supports updating the read state of the calling user, which can be specified by setting one of the following:\n - The `me` alias. For example, `users/me/spaces/`\u003cvar translate=\"no\"\u003eSPACE\u003c/var\u003e`/spaceReadState`.\n - The calling user's Workspace email address. For example, `users/user@example.com/spaces/`\u003cvar translate=\"no\"\u003eSPACE\u003c/var\u003e`/spaceReadState`.\n - The calling user's user ID. For example, `users/`\u003cvar translate=\"no\"\u003eUSER\u003c/var\u003e`/spaces/`\u003cvar translate=\"no\"\u003eSPACE\u003c/var\u003e`/spaceReadState`.\n - The `lastReadTime` field set to the updated value of the time when the user's space read state was updated. Usually this corresponds with either the timestamp of the last read message, or a timestamp specified by the user to mark the last read position in a space. When the `lastReadTime` is before the latest message create time, the space appears as unread in the UI. To mark the space as read, set `lastReadTime` to any value later (larger) than the latest message create time. The `lastReadTime` is coerced to match the latest message create time. Note that the space read state only affects the read state of messages that are visible in the space's top-level conversation. Replies in threads are unaffected by this timestamp, and instead rely on the thread read state.\n\nThe following example updates the calling user's space read state: \n\n### Node.js\n\nchat/client-libraries/cloud/update-space-read-state-user-cred.js \n[View on GitHub](https://github.com/googleworkspace/node-samples/blob/main/chat/client-libraries/cloud/update-space-read-state-user-cred.js) \n\n```javascript\nimport {createClientWithUserCredentials} from './authentication-utils.js';\n\nconst USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.users.readstate'];\n\n// This sample shows how to update a space read state for the calling user\nasync function main() {\n // Create a client\n const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);\n\n // Initialize request argument(s)\n const timestamp = new Date('2000-01-01').getTime();\n const request = {\n spaceReadState: {\n // Replace SPACE_NAME here\n name: 'users/me/spaces/SPACE_NAME/spaceReadState',\n lastReadTime: {\n seconds: Math.floor(timestamp / 1000),\n nanos: (timestamp % 1000) * 1000000\n }\n },\n updateMask: {\n // The field paths to update.\n paths: ['last_read_time']\n }\n };\n\n // Make the request\n const response = await chatClient.updateSpaceReadState(request);\n\n // Handle the response\n console.log(response);\n}\n\nmain().catch(console.error);\n```\n\nTo run this sample, replace \u003cvar translate=\"no\"\u003eSPACE_NAME\u003c/var\u003e with the ID from\nthe space's\n[`name`](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.Space.FIELDS.string.google.chat.v1.Space.name).\nYou can obtain the ID by calling the\n[`ListSpaces()`](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.ChatService.ListSpaces)\nmethod or from the space's URL.\n\nThe Google Chat API updates the specified space read state and returns\nan instance of\n[`SpaceReadState`](/workspace/chat/api/reference/rpc/google.chat.v1#google.chat.v1.SpaceReadState).\n\nRelated topics\n--------------\n\n- [Get the calling user's space read state](/workspace/chat/get-space-read-state).\n- [Get the calling user's thread read state](/workspace/chat/get-thread-read-state)."]]
