In diesem Leitfaden wird erläutert, wie Sie die Methode list
für die Ressource Message
von
die Google Chat API verwenden, um eine paginierte, filterbare Liste von Nachrichten in einem Gruppenbereich aufzurufen.
In der Chat API wird eine Chatnachricht durch das
Message
-Ressource
Chat-Nutzer können zwar nur Nachrichten senden, die Text enthalten,
Chat-Apps können viele andere Messaging-Funktionen nutzen, darunter
Anzeige statischer oder interaktiver Benutzeroberflächen, das Erfassen von Informationen
und Nachrichten privat zu übermitteln. Weitere Informationen zur Nachrichtenfunktion
die für die Chat API zur Verfügung stehen, finden Sie in der
Nachrichten in Google Chat
Vorbereitung
Python
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Richten Sie Ihre Umgebung ein:
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, und eine Beschreibung der Chat App.
- Installieren Sie die Python Google API-Clientbibliothek
- <ph type="x-smartling-placeholder"></ph>
Erstellen Sie OAuth-Client-ID-Anmeldedaten für eine Desktopanwendung. Um das Beispiel in diesem
sollten Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihrem lokales Verzeichnis.
- <ph type="x-smartling-placeholder"></ph> Wählen Sie einen Autorisierungsbereich aus, der die Nutzerauthentifizierung unterstützt.
Nachrichten auflisten
So listen Sie Nachrichten auf mit Nutzerauthentifizierung Übergeben Sie in Ihrer Anfrage Folgendes:
- Geben Sie den Autorisierungsbereich
chat.messages.readonly
oderchat.messages
an. - Rufen Sie die Methode
list
-Methode amMessage
-Ressource.
Im folgenden Beispiel werden Nachrichten in einem Chatbereich aufgelistet, die nach dem 16. März 2023:
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 einen Namen für den Gruppenbereich, der erhalten Sie in der Methodespaces.list
in der Chat API oder über die URL eines Gruppenbereichs.Erstellen Sie das Beispiel in Ihrem Arbeitsverzeichnis und führen Sie es aus:
python3 chat_messages_list.py
Die Chat API gibt eine Liste der Nachrichten zurück, die im angegebenen Gruppenbereich gesendet wurden
nach dem 16. März 2023. Wenn die Anfrage keine Nachrichten enthält, enthält der Parameter
Die Chat API-Antwort gibt ein leeres Objekt zurück. Bei Verwendung eines
REST/HTTP-Schnittstelle enthält, enthält die Antwort das leere JSON-Objekt {}
.
Weitere Informationen
- Nachricht formatieren
- Nachricht löschen
- Details zu einer Nachricht abrufen
- Nachricht aktualisieren
- Nachricht senden: