این راهنما نحوه استفاده از متد position در منبع Section از API گوگل چت را برای تغییر ترتیب مرتبسازی یک بخش در گوگل چت توضیح میدهد.
برای اطلاعات بیشتر، به ایجاد و سازماندهی بخشها در Google Chat مراجعه کنید.
پیشنیازها
پایتون
- یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه گوگل کلود ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- API چت گوگل را با نام، آیکون و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
- کتابخانه کلاینت ابری پایتون را نصب کنید.
- ایجاد اعتبارنامههای OAuth client ID برای یک برنامه دسکتاپ. برای اجرای نمونه در این راهنما، اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonدر دایرکتوری محلی خود ذخیره کنید.
- یک محدوده مجوز انتخاب کنید که از احراز هویت کاربر پشتیبانی کند.
تغییر موقعیت یک بخش
برای تغییر موقعیت یک بخش با احراز هویت کاربر ، موارد زیر را در درخواست خود ارسال کنید:
- دامنه مجوز
chat.users.sectionsرا مشخص کنید. - متد
PositionSectionرا فراخوانی کنید. - در بدنه درخواست،
nameبخش مورد نظر برای قرارگیری و موقعیت جدید را مشخص کنید:-
sortOrderروی یک موقعیت مطلق (بزرگتر از 0) تنظیم کنید. - یا
relativePositionرویSTARTیاENDتنظیم کنید.
-
مثال زیر یک بخش را به ابتدای لیست منتقل میکند:
پایتون
from google.cloud import chat_v1
def position_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.PositionSectionRequest(
name="SECTION_NAME",
relative_position=chat_v1.PositionSectionRequest.Position.START
)
# Make the request
response = client.position_section(request=request)
print(response)
برای اجرای این نمونه، موارد زیر را جایگزین کنید:
-
SECTION_NAME: نام منبع بخش. میتوانید نام منبع را با فراخوانی متدListSectionsبه دست آورید.
API چت، نمونهی بهروزرسانیشدهی Section را برمیگرداند.
مباحث مرتبط
- ایجاد یک بخش
- بهروزرسانی یک بخش
- حذف یک بخش
- فهرست بخشها
- لیست کردن فضاها در یک بخش
- انتقال یک فاصله به بخش دیگر