Carica contenuti multimediali come file allegato

Questa guida spiega come utilizzare il metodo upload nella risorsa Media dell'API Google Chat per caricare contenuti multimediali (un file) in Google Chat e quindi allegarli a un messaggio.

Quando l'utente invia un messaggio alla tua app, Google Chat invia un MESSAGE evento di interazione. L'evento di interazione ricevuto dalla tua app include il corpo della richiesta, ovvero il payload JSON che rappresenta l'evento di interazione, inclusi gli eventuali allegati. I dati nell'allegato variano a seconda che l'allegato sia stato caricato con contenuti (un file locale) o sia un file archiviato su Drive. La risorsa Media rappresenta un file caricato su Google Chat, ad esempio immagini, video e documenti. La risorsa Attachment rappresenta un'istanza di un elemento multimediale, ovvero un file, allegato a un messaggio. La risorsa Attachment include i metadati dell'allegato, ad esempio la posizione in cui è salvato.

Prerequisiti

Python

Carica come allegato file

Per caricare contenuti multimediali e allegarli a un messaggio, specifica quanto segue nella richiesta:

  • Specifica l'ambito di autorizzazione chat.messages.create o chat.messages.
  • Chiama i seguenti metodi di Google Chat:
    1. Per caricare il file, chiama il metodo upload sulla risorsa Media.
      • Imposta parent sul nome dello spazio che ospita il file.
      • In body (il corpo della richiesta), imposta filename sul nome dell'allegato del file caricato.
      • Imposta media_body come istanza del file da caricare.
    2. Per creare un messaggio con il file caricato allegato, chiama il metodo create nella risorsa Messages.

L'esempio seguente carica un file immagine PNG e lo allega a un messaggio.

Python

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

  2. Includi il seguente codice in chat_media_and_attachment_upload.py:

    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(
                  'client_secrets.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. Nel codice, sostituisci SPACE con il nome dello spazio in cui caricare l'allegato, che puoi ottenere dal metodo spaces.list nell'API Chat o dall'URL di uno spazio.

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

    python3 chat_media_and_attachment_upload.py

L'API Chat restituisce un corpo della risposta contenente attachmentDataRef con i dettagli del file caricato.

Limiti e considerazioni

Quando ti prepari a caricare i file e a allegarli ai messaggi, tieni presente i seguenti limiti e considerazioni: