string شناسه. نام منبع فضا. قالب: spaces/{space} که در آن {space} نشان دهنده شناسه اختصاص داده شده توسط سیستم برای فضا است. میتوانید شناسه فضا را با فراخوانی متد spaces.list() یا از آدرس اینترنتی فضا به دست آورید. برای مثال، اگر آدرس اینترنتی فضا https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA باشد، شناسه فضا AAAAAAAAA است.
type (deprecated)
enum ( Type ) فقط خروجی. منسوخ شده: به جای آن spaceType استفاده کنید. نوع فاصله.
spaceType
enum ( SpaceType ) اختیاری. نوع فضا. هنگام ایجاد یک فضا یا بهروزرسانی نوع فضای یک فضا الزامی است. فقط برای استفادههای دیگر خروجی میدهد.
singleUserBotDm
boolean اختیاری. اینکه آیا این فضا، یک پیام مستقیم بین یک برنامه چت و یک انسان است یا خیر.
threaded (deprecated)
boolean فقط خروجی. منسوخ شده: به جای آن spaceThreadingState استفاده کنید. آیا پیامها در این فضا رشتهبندی میشوند یا خیر.
displayName
string اختیاری. نام نمایشی فضا. هنگام ایجاد فضایی با spaceType برابر با SPACE الزامی است. اگر هنگام ایجاد فضا یا بهروزرسانی displayName پیام خطای ALREADY_EXISTS را دریافت کردید، یک displayName دیگر را امتحان کنید. ممکن است یک فضای موجود در سازمان Google Workspace از قبل از این نام نمایشی استفاده کند. برای پیامهای مستقیم، این فیلد ممکن است خالی باشد. تا ۱۲۸ کاراکتر را پشتیبانی میکند.
externalUserAllowed
boolean اختیاری. تغییرناپذیر. اینکه آیا این فضا به هر کاربر Google Chat به عنوان عضو اجازه عضویت میدهد یا خیر. هنگام ایجاد فضا در یک سازمان Google Workspace این فیلد را وارد کنید. هنگام ایجاد فضا در شرایط زیر، این فیلد را حذف کنید: کاربر احراز هویت شده از یک حساب کاربری (حساب کاربری مدیریت نشده) استفاده میکند. به طور پیشفرض، فضای ایجاد شده توسط یک حساب کاربری، هر کاربر گوگل چت را مجاز میکند. برای فضاهای موجود، این فیلد فقط خروجی است.
object ( SpaceDetails ) اختیاری. جزئیات مربوط به فضا شامل توضیحات و قوانین.
spaceHistoryState
enum ( HistoryState ) اختیاری. وضعیت تاریخچه پیامها برای پیامها و رشتههای موجود در این فضا.
importMode
boolean اختیاری. اینکه آیا این فضا در Import Mode به عنوان بخشی از انتقال دادهها به Google Workspace ایجاد میشود یا خیر. در حین وارد کردن فضاها، تا زمانی که وارد کردن کامل نشود، برای کاربران قابل مشاهده نیستند. ایجاد فضا در Import Mode نیاز به احراز هویت کاربر دارد.
createTime
string ( Timestamp format) اختیاری. تغییرناپذیر. برای فضاهای ایجاد شده در چت، زمان ایجاد فضا. این فیلد فقط در خروجی نمایش داده میشود، مگر در مواردی که در فضاهای حالت واردات استفاده شود. برای فضاهای حالت واردات، این فیلد را روی مهر زمانی تاریخی که فضا در منبع ایجاد شده است تنظیم کنید تا زمان ایجاد اصلی حفظ شود. فقط زمانی در خروجی نمایش داده میشود که spaceType GROUP_CHAT یا SPACE باشد.
lastActiveTime
string ( Timestamp format) فقط خروجی. مهر زمانی آخرین پیام در فضای خالی.
adminInstalled
boolean فقط خروجی. برای فضاهای پیام مستقیم (DM) با برنامه چت، اینکه آیا فضا توسط مدیر Google Workspace ایجاد شده است یا خیر. مدیران میتوانند از طرف کاربران سازمان خود، یک پیام مستقیم با برنامه چت نصب و تنظیم کنند. برای پشتیبانی از نصب ادمین، برنامه چت شما باید قابلیت پیامرسانی مستقیم داشته باشد.
membershipCount
object ( MembershipCount ) فقط خروجی. تعداد عضویتهای عضو شده که بر اساس نوع عضو گروهبندی شدهاند. وقتی spaceType برابر با SPACE ، DIRECT_MESSAGE یا GROUP_CHAT باشد، مقداردهی میشود.
accessSettings
object ( AccessSettings ) اختیاری. تنظیمات دسترسی به فضا را مشخص میکند. فقط زمانی که spaceType SPACE باشد، مقداردهی میشود.
spaceUri
string فقط خروجی. آدرس اینترنتی (URI) برای دسترسی کاربر به فضا.
importModeExpireTime
string ( Timestamp format) فقط خروجی. زمانی که اگر فضا در حالت وارد کردن باقی بماند، سیستم به طور خودکار آن را حذف میکند. هر فضای ایجاد شده در حالت import باید قبل از انقضای این زمان با استفاده از spaces.completeImport از این حالت خارج شود. این فیلد فقط برای فضاهایی که با حالت واردات ایجاد شدهاند، پر میشود.
customer
string اختیاری. تغییرناپذیر. شناسه مشتری دامنه فضا. فقط هنگام ایجاد فضایی با احراز هویت برنامه مورد نیاز است و SpaceType SPACE است، در غیر این صورت نباید تنظیم شود. در قالب customers/{customer} ، که در آن customer id منبع مشتری Admin SDK است. برنامههای خصوصی همچنین میتوانند از نام مستعار customers/my_customer برای ایجاد فضا در همان سازمان Google Workspace به عنوان برنامه استفاده کنند. این فیلد برای پیامهای مستقیم (DM) یا زمانی که فضا توسط کاربران غیر Google Workspace ایجاد میشود، پر نمیشود.
فیلد اتحادیه space_permission_settings . تنظیمات مجوز یک فضا را نشان میدهد. فقط زمانی پر میشود که space_type SPACE باشد. space_permission_settings فقط میتواند یکی از موارد زیر باشد:
predefinedPermissionSettings
enum ( PredefinedPermissionSettings ) اختیاری. فقط ورودی. تنظیمات مجوز فضا از پیش تعریف شده، فقط هنگام ایجاد فضا ورودی. اگر فیلد تنظیم نشده باشد، یک فضای همکاری ایجاد میشود. پس از ایجاد فضا، تنظیمات در فیلد PermissionSettings وارد میشوند. تنظیم تنظیمات مجوز از پیش تعریف شده پشتیبانی میکند: احراز هویت برنامه با تأیید مدیر با استفاده از scopeهای chat.app.spaces یا chat.app.spaces.create . احراز هویت کاربر
permissionSettings
object ( PermissionSettings ) اختیاری. تنظیمات مجوز فضا برای فضاهای موجود. ورودی برای بهروزرسانی تنظیمات دقیق مجوز فضا، که در آن تنظیمات مجوز موجود جایگزین میشوند. خروجی، تنظیمات مجوز فعلی را فهرست میکند. تنظیمات مجوز خواندن و بهروزرسانی از موارد زیر پشتیبانی میکند: احراز هویت برنامه با تأیید مدیر با دامنه chat.app.spaces . فقط زمانی که برنامه چت فضا را ایجاد کند، پر و قابل تنظیم است. احراز هویت کاربر
نوع
منسوخ شده: به جای آن SpaceType استفاده کنید.
انومها
TYPE_UNSPECIFIED
رزرو شده.
ROOM
گفتگو بین دو یا چند انسان.
DM
پیام مستقیم ۱:۱ بین یک انسان و یک برنامه چت، که در آن همه پیامها مسطح هستند. توجه داشته باشید که این شامل پیامهای مستقیم بین دو انسان نمیشود.
نوع فضا
نوع فضا. هنگام ایجاد یا بهروزرسانی یک فضا الزامی است. فقط برای استفادههای دیگر خروجی میدهد.
انومها
SPACE_TYPE_UNSPECIFIED
رزرو شده.
SPACE
مکانی که افراد در آن پیام ارسال میکنند، فایلها را به اشتراک میگذارند و با یکدیگر همکاری میکنند. یک SPACE میتواند شامل برنامههای چت باشد.
GROUP_CHAT
مکالمات گروهی بین ۳ نفر یا بیشتر. یک GROUP_CHAT میتواند شامل برنامههای چت باشد.
DIRECT_MESSAGE
پیامهای ۱:۱ بین دو انسان یا یک انسان و یک برنامه چت.
حالت ریسمانی فضا
نوع حالت threading را در فضای Chat مشخص میکند.
انومها
SPACE_THREADING_STATE_UNSPECIFIED
رزرو شده.
THREADED_MESSAGES
فضاهای نامگذاری شده که از رشتههای پیام پشتیبانی میکنند. وقتی کاربران به یک پیام پاسخ میدهند، میتوانند به صورت درون رشتهای پاسخ دهند که این امر پاسخ آنها را در چارچوب پیام اصلی نگه میدارد.
GROUPED_MESSAGES
فضاهای نامگذاری شده که در آنها گفتگو بر اساس موضوع سازماندهی میشود. موضوعات و پاسخهای آنها با هم گروهبندی میشوند.
UNTHREADED_MESSAGES
پیامهای مستقیم (DM) بین دو نفر و مکالمات گروهی بین ۳ نفر یا بیشتر.
جزئیات فضا
جزئیات مربوط به فضا شامل توضیحات و قوانین.
نمایش JSON
{ "description": string, "guidelines": string }
فیلدها
description
string اختیاری. شرح فضا. به عنوان مثال، موضوع بحث فضا، هدف کاربردی یا شرکتکنندگان را شرح دهید. تا ۱۵۰ کاراکتر را پشتیبانی میکند.
guidelines
string اختیاری. قوانین، انتظارات و آداب معاشرت آن فضا. پشتیبانی از حداکثر ۵۰۰۰ کاراکتر.
تاریخچه ایالت
وضعیت تاریخچه برای پیامها و فاصلهها. مشخص میکند که پیامها و رشتههای مکالمه پس از ایجاد، تا چه مدت نگهداری شوند.
enum ( AccessState ) فقط خروجی. وضعیت دسترسی به فضا را نشان میدهد.
audience
string اختیاری. نام منبع مخاطب هدف که میتواند فضا را کشف کند، به فضا بپیوندد و پیامهای موجود در فضا را پیشنمایش کند. در صورت تنظیم نشدن، فقط کاربران یا گروههای گوگل که به صورت جداگانه دعوت یا به فضا اضافه شدهاند میتوانند به آن دسترسی داشته باشند. برای جزئیات بیشتر، به «قابل کشف کردن یک فضا برای مخاطب هدف» مراجعه کنید. قالب: audiences/{audience} برای استفاده از مخاطب هدف پیشفرض برای سازماندهی Google Workspace، گزینه audiences/default را تنظیم کنید. خواندن مخاطب هدف از موارد زیر پشتیبانی میکند: احراز هویت کاربراحراز هویت برنامه با تأیید مدیر با دامنه chat.app.spaces . این فیلد هنگام استفاده از دامنه chat.bot با احراز هویت برنامه، پر نمیشود. تعیین مخاطب هدف نیاز به احراز هویت کاربر دارد.
وضعیت دسترسی
وضعیت دسترسی به فضا را نشان میدهد.
انومها
ACCESS_STATE_UNSPECIFIED
وضعیت دسترسی ناشناخته است یا در این API پشتیبانی نمیشود.
PRIVATE
فقط کاربران یا گروههای گوگل که بهصورت جداگانه توسط سایر کاربران یا مدیران Google Workspace اضافه یا دعوت شدهاند، میتوانند این فضا را کشف و به آن دسترسی داشته باشند.
DISCOVERABLE
مدیر فضا به مخاطبان هدف خود اجازه دسترسی به فضا را داده است. کاربران یا گروههای گوگل که به صورت جداگانه به فضا اضافه یا دعوت شدهاند نیز میتوانند آن فضا را کشف کرده و به آن دسترسی داشته باشند. برای کسب اطلاعات بیشتر، به بخش «قابل کشف کردن یک فضا برای کاربران خاص» مراجعه کنید. ایجاد فضاهای قابل کشف نیاز به احراز هویت کاربر دارد.
تنظیمات دسترسی از پیش تعریف شده
تنظیمات مجوز از پیش تعریفشده که فقط میتوانید هنگام ایجاد یک فضای نامگذاریشده مشخص کنید. ممکن است تنظیمات بیشتری در آینده اضافه شود. برای جزئیات بیشتر در مورد تنظیمات مجوز برای فضاهای نامگذاریشده، به «درباره فضاها بیشتر بدانید» مراجعه کنید.
انومها
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED
نامشخص. استفاده نکنید.
COLLABORATION_SPACE
تنظیم برای تبدیل فضا به یک فضای همکاری که در آن همه اعضا بتوانند پیام ارسال کنند.
ANNOUNCEMENT_SPACE
تنظیم برای تبدیل این فضا به یک فضای اعلانات که فقط مدیران فضا بتوانند در آن پیام ارسال کنند.
تنظیمات مجوز
تنظیمات مجوزی که میتوانید هنگام بهروزرسانی یک فضای نامگذاریشدهی موجود مشخص کنید.
برای تنظیم تنظیمات مجوز هنگام ایجاد یک فضا، فیلد PredefinedPermissionSettings را در درخواست خود مشخص کنید.
تمام فاصلههای دارای spaceType == GROUP_CHAT را برمیگرداند، که عضویتهای انسانی آنها دقیقاً شامل کاربر فراخواننده و کاربران مشخص شده در FindGroupChatsRequest.users است.