این راهنما نحوه استفاده از روش list
را در منبع Message
Google Chat API برای دیدن فهرست صفحهبندیشده و قابل فیلتر پیامها در یک فضا توضیح میدهد.
منبع Message
یک پیام متنی یا کارتی را در Google Chat نشان می دهد. میتوانید با فراخوانی روشهای مربوطه، پیامی را در Google Chat API create
، get
، update
یا delete
. برای کسب اطلاعات بیشتر درباره پیامهای نوشتاری و کارتی، به نمای کلی پیامهای گپ Google مراجعه کنید.
پیش نیازها
پایتون
- پایتون 3.6 یا بالاتر
- ابزار مدیریت بسته پیپ
جدیدترین کتابخانه های مشتری گوگل برای پایتون. برای نصب یا به روز رسانی آنها، دستور زیر را در رابط خط فرمان خود اجرا کنید:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- یک پروژه Google Cloud با Google Chat API فعال و پیکربندی شده است. برای مراحل، به ساخت برنامه گپ Google مراجعه کنید.
مجوز برای برنامه چت پیکربندی شد. فهرست کردن پیامها به تأیید اعتبار کاربر با محدوده مجوز
chat.messages.readonly
یاchat.messages
نیاز دارد.
لیست پیام ها
برای فهرست کردن پیامها با احراز هویت کاربر ، موارد زیر را در درخواست خود ارسال کنید:
- محدوده مجوز
chat.messages.readonly
یاchat.messages
مشخص کنید. - روش
list
در منبعMessage
را فراخوانی کنید.
مثال زیر پیامهایی را در فضای گپ ارسال شده پس از ۱۶ مارس ۲۰۲۳ فهرست میکند:
پایتون
- در پوشه کاری خود، یک فایل با نام
chat_messages_list.py
ایجاد کنید. کد زیر را در
chat_messages_list.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.messages.readonly"] def main(): ''' Authenticates with Chat API via user credentials, then lists messages in a space sent after March 16, 2023. ''' # 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().messages().list( # The space for which to list messages. parent = 'spaces/SPACE', # An optional filter that returns messages # created after March 16, 2023. filter = 'createTime > "2023-03-16T00:00:00-00:00"' ).execute() # Prints the list of messages. print(result) if __name__ == '__main__': main()
در کد،
SPACE
با یک نام فاصله جایگزین کنید، که می توانید آن را از روشspaces.list
در Chat API یا از URL یک فضا دریافت کنید.در پوشه کاری خود، نمونه را بسازید و اجرا کنید:
python3 chat_messages_list.py
Google Chat API فهرستی از پیامهای ارسال شده در فضای مشخص شده را پس از ۱۶ مارس ۲۰۲۳ برمیگرداند.
مطالب مرتبط
- یک پیام را قالب بندی کنید .
- یک پیام را حذف کنید .
- دریافت جزئیات در مورد یک پیام
- یک پیام را به روز کنید .
- ارسال یک پیام .