این راهنما نحوه استفاده از روش create
در منبع Space
API Google Chat برای ایجاد یک فضای نامگذاری شده توضیح می دهد.
منبع Space
مکانی را نشان میدهد که در آن افراد و برنامههای چت میتوانند پیام ارسال کنند، فایلها را به اشتراک بگذارند و با هم همکاری کنند. چند نوع فضا وجود دارد:
- پیامهای مستقیم (DM) مکالمات بین دو کاربر یا یک کاربر و یک برنامه چت هستند.
- چت گروهی مکالمه بین سه یا چند کاربر و برنامه های چت است.
- فضاهای نامگذاری شده مکانهایی هستند که افراد در آن پیام میفرستند، فایلها را به اشتراک میگذارند و همکاری میکنند.
فضای نامگذاری شده مکانی است که در آن افراد پیام می فرستند، فایل ها را به اشتراک می گذارند و با هم همکاری می کنند. فضاهای نامگذاری شده می توانند شامل برنامه های چت باشند. فضاهای نامگذاری شده شامل ویژگیهای اضافی هستند که مکالمات گروهی و پیامهای مستقیم بدون نام از آنها برخوردار نیستند، مانند مدیران فضا که میتوانند تنظیمات اداری، توضیحات، و اضافه یا حذف افراد و برنامهها را اعمال کنند. پس از ایجاد یک فضای نامگذاری شده، تنها عضو فضا، کاربر تایید شده است. فضا شامل افراد یا برنامههای دیگر نمیشود. نه حتی برنامه چت که آن را ایجاد می کند. برای افزودن افراد، با فراخوانی متد create
در منبع Member
، عضویت در فضا ایجاد کنید. برای آشنایی با نحوه، به ایجاد عضویت مراجعه کنید.
برای ایجاد فضایی با نام با چند عضو - یک گپ گروهی بدون نام بین سه یا چند نفر، یا یک مکالمه پیام مستقیم بین دو نفر، یا یک شخص و برنامه Chat که Chat API را فرا میخواند - به جای آن یک فاصله تنظیم کنید .
پیش نیازها
پایتون
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
- کتابخانه Google API Client Python را نصب کنید.
- شناسه مشتری OAuth را برای یک برنامه دسکتاپ ایجاد کنید . برای اجرای نمونه در این راهنما، اعتبارنامه ها را به عنوان یک فایل JSON با نام
client_secrets.json
در فهرست محلی خود ذخیره کنید.
- محدوده مجوزی را انتخاب کنید که از احراز هویت کاربر پشتیبانی می کند.
Node.js
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
- Node.js Google API Client Library را نصب کنید.
- اعتبار شناسه مشتری OAuth را برای یک برنامه دسکتاپ ایجاد کنید . برای اجرای نمونه در این راهنما، اعتبارنامه ها را به عنوان یک فایل JSON با نام
client_secrets.json
در فهرست محلی خود ذخیره کنید.
- محدوده مجوزی را انتخاب کنید که از احراز هویت کاربر پشتیبانی می کند.
فضایی با نام ایجاد کنید
برای ایجاد یک فضای نامگذاری شده، موارد زیر را در درخواست خود وارد کنید:
- محدوده مجوز
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
.
موضوعات مرتبط
- با ایجاد اعضا، افراد و برنامهها را به فضا اضافه کنید.
- با ایجاد یک پیام، پیامی را در فضا ارسال کنید.
- جزئیات مربوط به یک فضا را دریافت کنید .
- لیست فضاها
- یک فضا را به روز کنید .
- یک فاصله را حذف کنید .
- یک فضا تنظیم کنید .
- یک فضای پیام مستقیم پیدا کنید .
- یک فضای قابل کشف برای کاربران خاص ایجاد کنید .