این راهنما نحوه استفاده از متد create در منبع Section از API گوگل چت برای ایجاد یک بخش سفارشی جدید در گوگل چت را توضیح میدهد.
بخشها به کاربران کمک میکنند تا مکالمات خود را گروهبندی کرده و فهرست فضاهای نمایش داده شده در پنل ناوبری گوگل چت را سفارشی کنند. برای اطلاعات بیشتر، به ایجاد و سازماندهی بخشها در گوگل چت مراجعه کنید.
پیشنیازها
پایتون
- یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه گوگل کلود ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- API چت گوگل را با نام، آیکون و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
- کتابخانه کلاینت ابری پایتون را نصب کنید.
- ایجاد اعتبارنامههای OAuth client ID برای یک برنامه دسکتاپ. برای اجرای نمونه در این راهنما، اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonدر دایرکتوری محلی خود ذخیره کنید.
- یک محدوده مجوز انتخاب کنید که از احراز هویت کاربر پشتیبانی کند.
ایجاد یک بخش
برای ایجاد یک بخش با احراز هویت کاربر ، موارد زیر را در درخواست خود وارد کنید:
- دامنه مجوز
chat.users.sectionsرا مشخص کنید. - متد
CreateSectionرا فراخوانی کنید. - در بدنه درخواست، یک منبع
Sectionارائه دهید:-
displayNameبرای نام بخش (تا سقف ۸۰ کاراکتر) تنظیم کنید. -
typeرویCUSTOM_SECTIONتنظیم کنید.
-
مثال زیر یک بخش ایجاد میکند:
پایتون
from google.cloud import chat_v1
def create_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.CreateSectionRequest(
parent="users/me",
section=chat_v1.Section(
display_name="SECTION_DISPLAY_NAME",
type=chat_v1.Section.SectionType.CUSTOM_SECTION
)
)
# Make the request
response = client.create_section(request=request)
print(response)
برای اجرای این نمونه، موارد زیر را جایگزین کنید:
-
SECTION_DISPLAY_NAME: نام بخش جدید.
API چت نمونهای از Section را برمیگرداند که جزئیات بخش ایجاد شده را شرح میدهد.
مباحث مرتبط
- بهروزرسانی یک بخش
- حذف یک بخش
- تغییر موقعیت یک بخش
- بخشهای فهرست
- لیست کردن فضاها در یک بخش
- انتقال یک فاصله به بخش دیگر