איך מצמידים הודעות ומבטלים את ההצמדה במרחבים ב-Google Chat

Node.js

• חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat.

• מגדירים את הסביבה:
  • יוצרים פרויקט ב-Google Cloud.
  • הגדרת מסך ההסכמה ל-OAuth.
  • מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
  • מתקינים את ספריית הלקוח של Cloud ל-Node.js.
  • יצירת פרטי כניסה של מזהה לקוח OAuth לאפליקציה למחשב. כדי להריץ את הדוגמה במדריך הזה, שומרים את פרטי הכניסה כקובץ JSON בשם credentials.json בספרייה המקומית.
  כדי לקבל הנחיות, מבצעים את השלבים להגדרת הסביבה במדריך למתחילים הזה.
• בחירת היקף הרשאה שתומך באימות משתמשים.

Python

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

Python

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

Python

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