پین کردن یا برداشتن پین پیام‌ها در فضاهای چت گوگل

نود جی اس

• یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat .

• محیط خود را تنظیم کنید:
  • یک پروژه گوگل کلود ایجاد کنید .
  • صفحه رضایت OAuth را پیکربندی کنید .
  • API چت گوگل را با نام، آیکون و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
  • کتابخانه کلاینت ابری Node.js را نصب کنید.
  • ایجاد اعتبارنامه‌های OAuth client ID برای یک برنامه دسکتاپ. برای اجرای نمونه در این راهنما، اعتبارنامه‌ها را به عنوان یک فایل JSON با نام credentials.json در دایرکتوری محلی خود ذخیره کنید.
  برای راهنمایی، مراحل راه‌اندازی محیط خود را در این راهنمای سریع تکمیل کنید.
• یک محدوده مجوز انتخاب کنید که از احراز هویت کاربر پشتیبانی کند.

پایتون

1. در دایرکتوری کاری خود، فایلی با نام chat_pin_message.py ایجاد کنید.

2. کد زیر را در chat_pin_message.py قرار دهید:

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Define your app's authorization scopes.
   SCOPES = ["https://www.googleapis.com/auth/chat.spaces.pins"]
   
   def main():
       '''
       Authenticates with Chat API via user credentials,
       then pins a message in a space.
       '''
   
       # Authenticate with Google Workspace and get user authorization.
       flow = InstalledAppFlow.from_client_secrets_file('credentials.json', SCOPES)
       creds = flow.run_local_server()
   
       # Build a service endpoint for Chat API.
       service = build('chat', 'v1', credentials=creds)
   
       # Pin a message.
       result = service.spaces().messagePins().create(
           # The space to pin the message in.
           #
           # Replace SPACE with a space ID or name.
           # Obtain the space name from the spaces resource of Chat API,
           # or from a space's URL.
           parent='spaces/SPACE',
   
           # The message to pin.
           body={
               'message': 'spaces/SPACE/messages/MESSAGE'
           }
       ).execute()
   
       # Print Chat API's response in your command line interface.
       print(result)
   
   if __name__ == '__main__':
       main()
   

3. در کد، موارد زیر را جایگزین کنید:

   • SPACE : شناسه‌ی name فاصله.
   • MESSAGE : شناسه‌ی name پیام.

4. در دایرکتوری کاری خود، نمونه را بسازید و اجرا کنید:

   python3 chat_pin_message.py

پایتون

1. در دایرکتوری کاری خود، فایلی با نام chat_unpin_message.py ایجاد کنید.

2. کد زیر را در chat_unpin_message.py قرار دهید:

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Define your app's authorization scopes.
   SCOPES = ["https://www.googleapis.com/auth/chat.spaces.pins"]
   
   def main():
       '''
       Authenticates with Chat API via user credentials,
       then unpins a message from a space.
       '''
   
       # Authenticate with Google Workspace and get user authorization.
       flow = InstalledAppFlow.from_client_secrets_file('credentials.json', SCOPES)
       creds = flow.run_local_server()
   
       # Build a service endpoint for Chat API.
       service = build('chat', 'v1', credentials=creds)
   
       # Unpin a message.
       result = service.spaces().messagePins().delete(
           # The resource name of the message pin to delete.
           #
           # Replace SPACE with a space ID or name, and MESSAGE with the message ID.
           name='spaces/SPACE/messagePins/MESSAGE'
       ).execute()
   
       print(result)
   
   if __name__ == '__main__':
       main()
   

3. در کد، موارد زیر را جایگزین کنید:

   • SPACE : شناسه‌ی name فاصله.
   • MESSAGE : شناسه‌ی name پیام.

4. در دایرکتوری کاری خود، نمونه را بسازید و اجرا کنید:

   python3 chat_unpin_message.py

پایتون

1. در دایرکتوری کاری خود، فایلی با نام chat_list_pinned_messages.py ایجاد کنید.

2. کد زیر را در chat_list_pinned_messages.py قرار دهید:

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Define your app's authorization scopes.
   SCOPES = ["https://www.googleapis.com/auth/chat.spaces.pins.readonly"]
   
   def main():
       '''
       Authenticates with Chat API via user credentials,
       then lists pinned messages in a space.
       '''
   
       # Authenticate with Google Workspace and get user authorization.
       flow = InstalledAppFlow.from_client_secrets_file('credentials.json', SCOPES)
       creds = flow.run_local_server()
   
       # Build a service endpoint for Chat API.
       service = build('chat', 'v1', credentials=creds)
   
       # List pinned messages.
       result = service.spaces().messagePins().list(
           # The space to list pinned messages from.
           #
           # Replace SPACE with a space ID or name.
           parent='spaces/SPACE'
       ).execute()
   
       print(result)
   
   if __name__ == '__main__':
       main()
   

3. در کد، به جای SPACE ، شناسه‌ی فضا را از name فضا وارد کنید.

4. در دایرکتوری کاری خود، نمونه را بسازید و اجرا کنید:

   python3 chat_list_pinned_messages.py