В этом руководстве объясняется, как использовать метод download
на ресурсе Media
API Google Chat для загрузки медиафайла (файла) из сообщения в Google Chat.
Когда пользователь отправляет сообщение в ваше приложение, Google Chat отправляет событие взаимодействия MESSAGE
. Событие взаимодействия, полученное вашим приложением, включает тело запроса, представляющее собой полезную нагрузку JSON, представляющую событие взаимодействия, включая любые вложения. Данные во вложении различаются в зависимости от того, является ли вложение загруженным контентом (локальным файлом) или файлом, хранящимся на Диске. Ресурс Media
представляет собой файл, загруженный в Google Chat, такой как изображения, видео и документы. Ресурс Attachment
представляет собой экземпляр медиафайла (файла), прикрепленного к сообщению. Ресурс Attachment
содержит метаданные о вложении, например, место его сохранения.
Предпосылки
Питон
- Учетная запись Google Workspace Business или Enterprise с доступом к Google Chat .
- Настройте свою среду:
- Создайте проект Google Cloud .
- Настройте экран согласия OAuth .
- Включите и настройте API Google Chat, указав имя, значок и описание для вашего приложения Chat.
- Установите клиентскую библиотеку Python Google API .
- Создайте учетные данные для доступа на основе того, как вы хотите выполнить аутентификацию в своем запросе API Google Chat:
- Чтобы пройти аутентификацию в качестве пользователя чата, создайте учетные данные идентификатора клиента OAuth и сохраните их в виде JSON-файла с именем
credentials.json
в локальном каталоге. - Чтобы выполнить аутентификацию в приложении Chat, создайте учетные данные сервисной учетной записи и сохраните их как JSON-файл с именем
credentials.json
.
- Чтобы пройти аутентификацию в качестве пользователя чата, создайте учетные данные идентификатора клиента OAuth и сохраните их в виде JSON-файла с именем
- Выберите область авторизации в зависимости от того, хотите ли вы пройти аутентификацию как пользователь или как приложение чата.
Загрузить из прикрепленного файла
Чтобы загрузить медиафайл из прикрепленного файла, передайте в запрос следующее:
- При аутентификации пользователя укажите область авторизации
chat.messages.readonly
илиchat.messages
. При аутентификации приложения укажите область авторизацииchat.bot
. - Вызовите следующие методы Google Chat:
- Получите
attachmentDataRef
, вызвав один из следующих методов:- Метод
get
для ресурсаAttachment
. - Метод
get
или методlist
в ресурсеMessage
.
- Метод
- Вызовите метод
download
на ресурсеMedia
и укажите ранее извлеченныйattachmentDataRef.resourceName
какmedia.download.resourceName
.
- Получите
В следующем примере загружается файл, прикрепленный к сообщению:
Питон
- В рабочем каталоге создайте файл с именем
chat_media_and_attachment_download.py
. Включите следующий код в
chat_media_and_attachment_download.py
:import io from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build from googleapiclient.http import MediaIoBaseDownload # 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"] def main(): ''' Authenticates with Chat API via user credentials, then downloads a file attached to a 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. chat = build('chat', 'v1', credentials=creds) # Download media resource. request = chat.media().download_media( resourceName=RESOURCE_NAME, ) file = io.BytesIO() downloader = MediaIoBaseDownload(file, request) done = False while done is False: status, done = downloader.next_chunk() if status.total_size: print(f'Total size: {status.total_size}') print(f'Download {int(status.progress() * 100)}') if __name__ == '__main__': main()
В коде замените
RESOURCE_NAME
наattachmentDataRef.resourceName
, который можно получить одним из следующих способов:- Метод
get
для ресурсаAttachment
. - Метод
get
для ресурсаMessage
. - Метод
list
в ресурсеMessage
.
- Метод
В вашем рабочем каталоге соберите и запустите пример:
python3 chat_media_and_attachment_download.py
В случае успеха этот метод возвращает содержимое файла в виде байтов.
Чтобы загрузить содержимое файла, выберите один из следующих способов:
Мы рекомендуем использовать класс
MediaIoBaseDownload
в Python, который содержит методы для загрузки файла по разделам и сохранения содержимого в выходном потоке.Если вам необходимо сделать HTTP-запрос вручную, вызовите метод
download
и укажите часть файла, которую вы хотите загрузить, используя диапазон байтов с заголовкомRange
, например:Range: bytes=500-999
.
Похожие темы
- Если сообщение представляет собой файл Диска, используйте API Диска, чтобы получить доступ к файлу .
- Загрузить медиафайл как вложенный файл
- Загрузить медиафайл как вложенный файл
- Получить метаданные о вложении к сообщению