این راهنما نحوه استفاده از روش create
در منبع Space
API Google Chat برای ایجاد یک فضای نامگذاری شده توضیح می دهد.
منبع Space
مکانی را نشان میدهد که در آن افراد و برنامههای چت میتوانند پیام ارسال کنند، فایلها را به اشتراک بگذارند و با هم همکاری کنند. چند نوع فضا وجود دارد:
- پیامهای مستقیم (DM) مکالمات بین دو کاربر یا یک کاربر و یک برنامه چت هستند.
- چت گروهی مکالمه بین سه یا چند کاربر و برنامه های چت است.
- فضاهای نامگذاری شده مکانهایی هستند که افراد در آن پیام میفرستند، فایلها را به اشتراک میگذارند و همکاری میکنند.
فضای نامگذاری شده مکانی است که در آن افراد پیام می فرستند، فایل ها را به اشتراک می گذارند و با هم همکاری می کنند. فضاهای نامگذاری شده می توانند شامل برنامه های چت باشند. فضاهای نامگذاری شده شامل ویژگیهای اضافی هستند که مکالمات گروهی و پیامهای مستقیم بدون نام از آنها برخوردار نیستند، مانند مدیران فضا که میتوانند تنظیمات اداری، توضیحات، و اضافه یا حذف افراد و برنامهها را اعمال کنند. پس از ایجاد یک فضای نامگذاری شده، تنها عضو فضا، کاربر تایید شده است. فضا شامل افراد یا برنامههای دیگر نمیشود. نه حتی برنامه چت که آن را ایجاد می کند. برای افزودن افراد، با فراخوانی متد create
در منبع Member
، عضویت در فضا ایجاد کنید. برای آشنایی با نحوه، به ایجاد عضویت مراجعه کنید.
برای ایجاد فضایی با نام با چند عضو - یک گپ گروهی بدون نام بین سه یا چند نفر، یا یک مکالمه پیام مستقیم بین دو نفر، یا یک شخص و برنامه Chat که Chat API را فرا میخواند - به جای آن یک فاصله تنظیم کنید .
پیش نیازها
پایتون
- پایتون 3.6 یا بالاتر
- ابزار مدیریت بسته پیپ
جدیدترین کتابخانه های مشتری گوگل برای پایتون. برای نصب یا به روز رسانی آنها، دستور زیر را در رابط خط فرمان خود اجرا کنید:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- یک پروژه Google Cloud با Google Chat API فعال و پیکربندی شده است. برای مراحل، به ساخت برنامه گپ Google مراجعه کنید.
مجوز برای برنامه چت پیکربندی شد. ایجاد یک فضا نیاز به احراز هویت کاربر با محدوده مجوز
chat.spaces.create
یاchat.spaces
دارد.
Node.js
- Node.js و npm
جدیدترین کتابخانه های سرویس گیرنده Google برای Node.js. برای نصب آنها، دستور زیر را در رابط خط فرمان خود اجرا کنید:
npm install @google-cloud/local-auth @googleapis/chat
- یک پروژه Google Cloud با Google Chat API فعال و پیکربندی شده است. برای مراحل، به ساخت برنامه گپ Google مراجعه کنید.
مجوز برای برنامه چت پیکربندی شد. ایجاد یک فضا نیاز به احراز هویت کاربر با محدوده مجوز
chat.spaces.create
یاchat.spaces
دارد.
فضایی با نام ایجاد کنید
برای ایجاد فضایی با نام، موارد زیر را در درخواست خود وارد کنید:
- محدوده مجوز
chat.spaces.create
یاchat.spaces
را مشخص کنید. - متد
create
را در منبعSpace
فراخوانی کنید. -
spaceType
را رویSPACE
تنظیم کنید. -
displayName
را روی نام فضای قابل مشاهده توسط کاربر تنظیم کنید. در مثال زیر،displayName
رویAPI-made
تنظیم شده است. - به صورت اختیاری، سایر ویژگیهای فضا، مانند
spaceDetails
(توضیحات قابل مشاهده توسط کاربر و مجموعهای از دستورالعملها برای فضا) را تنظیم کنید.
در اینجا نحوه ایجاد یک فضای نامگذاری شده آمده است:
پایتون
- در پوشه کاری خود، یک فایل با نام
chat_space_create_named.py
ایجاد کنید. کد زیر را در
chat_space_create_named.py
قرار دهید:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.spaces.create"] def main(): ''' Authenticates with Chat API via user credentials, then creates a Chat space. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().create( # Details about the space to create. body = { # To create a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space. 'displayName': 'API-made' } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()
در پوشه کاری خود، نمونه را بسازید و اجرا کنید:
python3 chat_space_create_named.py
Node.js
- در پوشه کاری خود، یک فایل با نام
create-space.js
ایجاد کنید. کد زیر را در
create-space.js
قرار دهید:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Creates a new chat space. * @return {!Promise<!Object>} */ async function createSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.spaces.create', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.create( {requestBody: {spaceType: 'SPACE', displayName: 'API-made'}}); } createSpace().then(console.log);
در پوشه کاری خود، نمونه را اجرا کنید:
node create-space.js
فضایی با نام ایجاد می شود. برای پیمایش به فضا، از شناسه منبع فضا برای ساخت URL فضا استفاده کنید. میتوانید شناسه منبع را از name
فضا در بدنه پاسخ Google Chat پیدا کنید. برای مثال، اگر name
فضای شما spaces/1234567
است، میتوانید با استفاده از نشانی اینترنتی زیر به فضا پیمایش کنید: https://mail.google.com/chat/u/0/#chat/space/1234567
.
مطالب مرتبط
- با ایجاد اعضا، افراد و برنامهها را به فضا اضافه کنید.
- با ایجاد یک پیام، پیامی را در فضا ارسال کنید.
- جزئیات مربوط به یک فضا را دریافت کنید .
- لیست فضاها
- یک فضا را به روز کنید .
- یک فاصله را حذف کنید .
- یک فضا تنظیم کنید .
- یک فضای پیام مستقیم پیدا کنید .
- یک فضای قابل کشف برای کاربران خاص ایجاد کنید .