Medien als Dateianhang hochladen

In dieser Anleitung wird beschrieben, wie Sie mit der Methode upload für die Ressource Media der Google Chat API Medien (eine Datei) in Google Chat hochladen und sie dann an eine Nachricht anhängen.

Wenn der Nutzer eine Nachricht an Ihre App sendet, sendet Google Chat ein MESSAGE Interaktionsereignis. Das von Ihrer App empfangene Interaktionsereignis enthält einen Anfragetext, der die JSON-Nutzlast darstellt, die das Interaktionsereignis enthält, einschließlich aller Anhänge. Die Daten im Anhang unterscheiden sich je nachdem, ob der Anhang hochgeladener Inhalt (eine lokale Datei) oder eine in Drive gespeicherte Datei ist. Die Ressource Media stellt eine in Google Chat hochgeladene Datei dar, z. B. Bilder, Videos und Dokumente. Die Attachment Ressource stellt eine Instanz von Medien – eine Datei – dar, die an eine Nachricht angehängt ist. Die Ressource Attachment enthält die Metadaten zum Anhang, z. B. wo er gespeichert ist.

Vorbereitung

Python

Als Dateianhang hochladen

Wenn Sie Medien hochladen und an eine Nachricht anhängen möchten, übergeben Sie Folgendes in Ihrer Anfrage:

  • Geben Sie den chat.messages.create oder chat.messages Autorisierungsbereich an.
  • Rufen Sie die folgenden Google Chat-Methoden auf:
    1. Rufen Sie die upload Methode für die Media Ressource auf, um die Datei hochzuladen.
      • Setzen Sie parent auf den Namen des Bereichs, in dem sich die Datei befindet.
      • Setzen Sie in body (dem Anfragetext) filename auf den Namen des hochgeladenen Dateianhangs.
      • Legen Sie media_body als Instanz der hochzuladenden Datei fest.
    2. Rufen Sie die create Methode für die Messages Ressourceauf, um eine Nachricht mit der angehängten hochgeladenen Datei zu erstellen.

Im folgenden Beispiel wird eine PNG-Bilddatei hochgeladen und an eine Nachricht angehängt.

Python

  1. Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen chat_media_and_attachment_upload.py.

  2. Fügen Sie den folgenden Code in chat_media_and_attachment_upload.py ein:

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.http import MediaFileUpload

# 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.create"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then uploads a file as media, creates a message, and
    attaches the file to the message.
    '''

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

    # Upload a file to Google Chat.
    media = MediaFileUpload('test_image.png', mimetype='image/png')

    # Create a message and attach the uploaded file to it.
    attachment_uploaded = service.media().upload(

        # The space to upload the attachment in.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        parent='spaces/SPACE',

        # The filename of the attachment, including the file extension.
        body={'filename': 'test_image.png'},

        # Media resource of the attachment.
        media_body=media

    ).execute()

    print(attachment_uploaded)

    # Create a Chat message with attachment.
    result = service.spaces().messages().create(

        # The space to create the message in.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        #
        # Must match the space name that the attachment is uploaded to.
        parent='spaces/SPACE',

        # The message to create.
        body={
            'text': 'Hello, world!',
            'attachment': [attachment_uploaded]
        }

    ).execute()

    print(result)

if __name__ == '__main__':
    main()

  3. Ersetzen Sie im Code SPACE durch den Namen des Bereichs, in den Sie den Anhang hochladen möchten. Sie können ihn mit der Methode spaces.list in der Chat API oder über die URL eines Bereichs abrufen.

  4. Erstellen Sie das Beispiel in Ihrem Arbeitsverzeichnis und führen Sie es aus:

    python3 chat_media_and_attachment_upload.py

Die Chat API gibt einen Antworttext zurück, der attachmentDataRef mit Details zur hochgeladenen Datei enthält.

Einschränkungen und Überlegungen

Beachten Sie beim Hochladen von Dateien und Anhängen an Nachrichten die folgenden Einschränkungen und Überlegungen:

  • Sie können Dateien mit einer Größe von bis zu 200 MB hochladen.
  • Einige Dateitypen werden nicht unterstützt und können nicht hochgeladen werden. Weitere Informationen finden Sie unter In Google Chat blockierte Dateitypen.
  • Ihre Nachricht darf keine Zubehör-Widgets enthalten.