جزئیات مربوط به وضعیت خواندن فضای کاربر را دریافت کنید

این راهنما نحوه استفاده از متد get() در منبع SpaceReadState از API چت گوگل را برای دریافت جزئیات مربوط به وضعیت خواندن کاربر در داخل یک فاصله توضیح می‌دهد. برای دریافت وضعیت خواندن یک پیام در یک رشته پیام، به بخش Get details about a user's thread read state مراجعه کنید.

منبع SpaceReadState یک منبع تک‌لایه است که جزئیاتی درباره آخرین پیام خوانده شده یک کاربر مشخص در فضای چت گوگل را نشان می‌دهد.

پیش‌نیازها

وضعیت خواندن فضای کاربر فراخوانی‌کننده را دریافت کنید.

برای دریافت جزئیات مربوط به وضعیت خواندن کاربر در داخل یک فاصله، موارد زیر را در درخواست خود وارد کنید:

• دامنه مجوز chat.users.readstate یا chat.users.readstate.readonly را مشخص کنید.
• متد GetSpaceReadState() را فراخوانی کنید و name وضعیت خواندن فضای خالی را که شامل شناسه کاربری یا نام مستعار و شناسه فضا است، به آن ارسال کنید. دریافت وضعیت خواندن فضای خالی فقط از دریافت وضعیت خواندن کاربر فراخواننده پشتیبانی می‌کند که می‌تواند با تنظیم یکی از موارد زیر مشخص شود:
  • نام مستعار me . برای مثال، users/me/spaces/ SPACE /spaceReadState .
  • آدرس ایمیل فضای کاری کاربر فراخوانی‌کننده. برای مثال، users/user@example.com/spaces/ SPACE /spaceReadState .
  • شناسه کاربری کاربر فراخواننده. برای مثال، users/ USER /spaces/ SPACE /spaceReadState .

مثال زیر وضعیت خواندن فضا توسط کاربر فراخواننده را دریافت می‌کند:

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 space read state for the 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 here
    name: 'users/me/spaces/SPACE_NAME/spaceReadState',
  };

  // Make the request
  const response = await chatClient.getSpaceReadState(request);

  // Handle the response
  console.log(response);
}

await main();

برای اجرای این نمونه، به جای SPACE_NAME ، شناسه‌ی name فضا را وارد کنید. می‌توانید شناسه را با فراخوانی متد ListSpaces() یا از طریق URL فضا به دست آورید.

API چت گوگل، حالت خواندن فضای مشخص شده را دریافت کرده و نمونه‌ای از SpaceReadState را برمی‌گرداند.

مباحث مرتبط

• وضعیت خواندن فضای کاربر فراخواننده را به‌روزرسانی کن .
• وضعیت خواندن نخ کاربر فراخواننده را دریافت کن .