In dieser Anleitung wird erläutert, wie Sie mit der Methode list
für die Ressource Message
der Google Chat API eine paginierte, filterbare Liste von Nachrichten in einem Gruppenbereich aufrufen.
Die Ressource Message
stellt eine Textnachricht oder eine Kartennachricht in Google Chat dar. Sie können eine Nachricht in der Google Chat API create
, get
, update
oder delete
senden, indem Sie die entsprechenden Methoden aufrufen. Weitere Informationen zu Text- und Kartennachrichten finden Sie unter Nachrichten in Google Chat.
Voraussetzungen
Python
- Python 3.6 oder höher
- Das Paketverwaltungstool pip
Die aktuellen Google-Clientbibliotheken für Python. Führen Sie den folgenden Befehl in der Befehlszeile aus, um sie zu installieren oder zu aktualisieren:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Ein Google Cloud-Projekt, in dem die Google Chat API aktiviert und konfiguriert ist. Eine entsprechende Anleitung finden Sie unter Google Chat-App erstellen.
Für die Chat-App konfigurierte Autorisierung. Zum Auflisten von Nachrichten ist eine Nutzerauthentifizierung mit dem Autorisierungsbereich
chat.messages.readonly
oderchat.messages
erforderlich.
Nachrichten auflisten
Übergeben Sie in der Anfrage Folgendes, um Nachrichten mit Nutzerauthentifizierung aufzulisten:
- Geben Sie den Autorisierungsbereich
chat.messages.readonly
oderchat.messages
an. - Rufen Sie die Methode
list
für die RessourceMessage
auf.
Im folgenden Beispiel werden Nachrichten in einem Chatbereich aufgelistet, die nach dem 16. März 2023 gesendet wurden:
Python
- Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen
chat_messages_list.py
. Fügen Sie den folgenden Code in
chat_messages_list.py
ein: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()
Ersetzen Sie im Code
SPACE
durch den Namen eines Gruppenbereichs, den Sie mit der Methodespaces.list
in der Chat API oder aus der URL eines Gruppenbereichs abrufen können.Erstellen Sie das Beispiel in Ihrem Arbeitsverzeichnis und führen Sie es aus:
python3 chat_messages_list.py
Die Google Chat API gibt eine Liste der Nachrichten zurück, die nach dem 16. März 2023 an den angegebenen Gruppenbereich gesendet wurden.
Weitere Informationen
- Nachrichten formatieren
- Nachrichten löschen
- Informationen zu Nachrichten abrufen
- Nachrichten aktualisieren
- Nachricht senden: