این راهنما نحوه استفاده از متد setUp()
را در منبع Space
در Google Chat API برای راهاندازی فضای Google Chat توضیح میدهد. راه اندازی یک فضا یک فضا ایجاد می کند و کاربران مشخصی را به آن اضافه می کند.
منبع Space
مکانی را نشان میدهد که در آن افراد و برنامههای چت میتوانند پیام ارسال کنند، فایلها را به اشتراک بگذارند و با هم همکاری کنند. چند نوع فضا وجود دارد:
- پیامهای مستقیم (DM) مکالمات بین دو کاربر یا یک کاربر و یک برنامه چت هستند.
- چت گروهی مکالمه بین سه یا چند کاربر و برنامه های چت است.
- فضاهای نامگذاری شده مکانهایی هستند که افراد در آن پیام میفرستند، فایلها را به اشتراک میگذارند و همکاری میکنند.
هنگام تنظیم یک فضا، موارد زیر را در نظر بگیرید:
- کاربر تماس گیرنده (تایید شده) به طور خودکار به فضا اضافه می شود، بنابراین نیازی نیست عضویت کاربر را در درخواست مشخص کنید.
- هنگام ایجاد یک پیام مستقیم (DM)، اگر یک DM بین دو کاربر وجود داشته باشد، آن DM برگردانده می شود. در غیر این صورت یک DM ایجاد می شود.
- هنگام ایجاد یک چت گروهی، اگر هیچ یک از عضویت های ارائه شده در درخواست با موفقیت به گپ گروهی اضافه نشود (به عنوان مثال، مشکل مجوز)، ممکن است یک چت گروهی خالی (شامل تنها کاربر تماس گیرنده) ایجاد شود.
- نمیتوانید فضاهایی را با پاسخهای رشتهای تنظیم کنید یا افرادی را خارج از Google Workspace خود اضافه کنید.
- عضویت های تکراری (از جمله کاربر تماس گیرنده) ارائه شده در درخواست به جای اینکه منجر به خطای درخواست شود، فیلتر می شوند.
پیش نیازها
Node.js
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
- Node.js Cloud Client Library را نصب کنید.
- شناسه مشتری OAuth را برای یک برنامه دسکتاپ ایجاد کنید . برای اجرای نمونه در این راهنما، اعتبارنامه ها را به عنوان یک فایل JSON با نام
client_secrets.json
در فهرست محلی خود ذخیره کنید.
- محدوده مجوزی را انتخاب کنید که از احراز هویت کاربر پشتیبانی می کند.
پایتون
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
- کتابخانه Client Python Cloud را نصب کنید.
- شناسه مشتری OAuth را برای یک برنامه دسکتاپ ایجاد کنید . برای اجرای نمونه در این راهنما، اعتبارنامه ها را به عنوان یک فایل JSON با نام
client_secrets.json
در فهرست محلی خود ذخیره کنید.
- محدوده مجوزی را انتخاب کنید که از احراز هویت کاربر پشتیبانی می کند.
جاوا
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
- کتابخانه Java Cloud Client را نصب کنید.
- شناسه مشتری OAuth را برای یک برنامه دسکتاپ ایجاد کنید . برای اجرای نمونه در این راهنما، اعتبارنامه ها را به عنوان یک فایل JSON با نام
client_secrets.json
در فهرست محلی خود ذخیره کنید.
- محدوده مجوزی را انتخاب کنید که از احراز هویت کاربر پشتیبانی می کند.
اسکریپت برنامه ها
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
- یک پروژه Apps Script مستقل ایجاد کنید و سرویس گفتگوی پیشرفته را روشن کنید.
- محدوده مجوزی را انتخاب کنید که از احراز هویت کاربر پشتیبانی می کند.
فضایی را تنظیم کنید
برای تنظیم فضا، موارد زیر را در درخواست خود بنویسید:
- محدوده مجوز
chat.spaces.create
یاchat.spaces
را مشخص کنید. - متد
SetUpSpace()
را فراخوانی کنید. -
space
به عنوان نمونه ای ازSpace
با تمام فیلدهای لازم مانندdisplayName
یاspaceType
ارسال کنید. -
memberships
به عنوان آرایه ای از نمونه هایMembership
پاس کنید. برای هر نمونه:-
users/{user}
برای افزودن یک کاربر انسانی به عنوان عضو فضایی مشخص کنید، جایی که{user}
یا{person_id}
برایperson
از People API یا شناسه یکuser
در Directory API است. برای مثال، اگر People API personresourceName
people/123456789
باشد، میتوانید کاربر را با عضویت باusers/123456789
بهعنوانmember.name
.name به فضا اضافه کنید. - برای افزودن یک گروه به عنوان عضو فضایی،
groups/{group}
مشخص کنید، جایی که{group}
شناسه گروهی است که میخواهید برای آن عضویت ایجاد کنید. شناسه گروه را می توان با استفاده از Cloud Identity API بازیابی کرد. به عنوان مثال، اگر Cloud Identity API گروهی را با نامgroups/123456789
برمی گرداند، سپسmembership.groupMember.name
را رویgroups/123456789
تنظیم کنید. Google Groups را نمی توان به یک چت گروهی یا DM اضافه کرد، بلکه فقط به یک فضای نامگذاری شده اضافه می شود.
-
برای ایجاد DM بین کاربر تماس گیرنده و کاربر انسانی دیگر، عضویت کاربر انسانی را در درخواست خود مشخص کنید.
برای ایجاد DM بین کاربر تماس گیرنده و برنامه تماس گیرنده، space.singleUserBotDm
را روی true
تنظیم کنید و هیچ عضویتی را مشخص نکنید. شما فقط می توانید از این روش برای تنظیم DM با برنامه تماس استفاده کنید. برای افزودن برنامه تماس به عنوان عضوی از یک فضا یا یک DM موجود بین دو کاربر انسانی، به ایجاد عضویت مراجعه کنید.
مثال زیر یک فضای نامگذاری شده ایجاد می کند و یک عضویت در فضا برای دو کاربر انسانی (کاربر تایید شده و یک کاربر دیگر) ایجاد می کند.
Node.js
پایتون
جاوا
اسکریپت برنامه ها
برای اجرای نمونه، موارد زیر را جایگزین کنید:
-
DISPLAY_NAME
: نام نمایشی فضای جدید. -
USER_NAME
: شناسه کاربر دیگر که باید عضویت در آن لحاظ شود.
برای رفتن به فضا، از شناسه منبع فضا برای ساخت URL فضا استفاده کنید. میتوانید شناسه منبع را از name
فضا در بدنه پاسخ Google Chat دریافت کنید. برای مثال، اگر name
فضای شما spaces/1234567
است، میتوانید با استفاده از URL زیر به فضا بروید: https://mail.google.com/chat/u/0/#chat/space/1234567
.
موضوعات مرتبط
- یک فضا ایجاد کنید .
- جزئیات مربوط به یک فضا را دریافت کنید .
- لیست فضاها
- یک فضا را به روز کنید .
- یک فاصله را حذف کنید .
- یک فضای پیام مستقیم پیدا کنید .
- یک فضای قابل کشف برای کاربران خاص ایجاد کنید .