Elenco di messaggi

Questa guida spiega come utilizzare il metodo list nella risorsa Message di l'API Google Chat per vedere un elenco impaginato e filtrabile di messaggi in uno spazio.

Nell'API Chat, un messaggio di Chat è rappresentato dalla Message risorsa. Anche se gli utenti di Chat possono inviare solo messaggi contenenti testo, Le app di chat possono utilizzare molte altre funzionalità di messaggistica, tra cui: Mostrare interfacce utente statiche o interattive, raccogliendo informazioni da utenti e distribuire i messaggi in privato. Per scoprire di più sui messaggi disponibili per l'API Chat, consulta le Panoramica dei messaggi di Google Chat.

Prerequisiti

Python

Elenco di messaggi

Per elencare i messaggi con autenticazione degli utenti, inserisci quanto segue nella tua richiesta:

Nell'esempio seguente sono elencati i messaggi di uno spazio di Chat che sono stati inviati dopo 16 marzo 2023:

Python

  1. Nella directory di lavoro, crea un file denominato chat_messages_list.py.

  2. Includi il seguente codice in chat_messages_list.py:

    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()

  3. Nel codice, sostituisci SPACE con il nome di uno spazio, che che puoi ottenere Metodo spaces.list nell'API Chat o dall'URL di uno spazio.

  4. Nella directory di lavoro, crea ed esegui l'esempio:

    python3 chat_messages_list.py

L'API Chat restituisce un elenco di messaggi inviati nello spazio specificato dopo il 16 marzo 2023. Se la richiesta non contiene messaggi, La risposta dell'API Chat restituisce un oggetto vuoto. Se utilizzi un Interfaccia REST/HTTP, la risposta contiene un oggetto JSON vuoto, {}.