Diese Seite wurde von der Cloud Translation API übersetzt.

Nachrichten auflisten

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 oder chat.messages erforderlich.

Nachrichten auflisten

Übergeben Sie in der Anfrage Folgendes, um Nachrichten mit Nutzerauthentifizierung aufzulisten:

Geben Sie den Autorisierungsbereich chat.messages.readonly oder chat.messages an.
Rufen Sie die Methode list für die Ressource Message 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 details about the created membership.
    print(result)

if __name__ == '__main__':
    main()

Ersetzen Sie im Code SPACE durch den Namen eines Gruppenbereichs, den Sie mit der Methode spaces.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.