Method: files.create

Загружает файл для использования в медиа-сообщениях или расширенных карточках.

Агент предоставляет URL-адрес или двоичный файл файла и (опционально) URL-адрес соответствующего файла миниатюры.

Важно: В целях конфиденциальности и безопасности пользователей платформа RCS for Business загружает и обрабатывает медиа- и PDF-файлы с предоставленных URL-адресов перед их доставкой пользователю. Это предотвращает отслеживание агентами по уникальным URL-адресам. Поэтому не отправляйте большое количество уникальных URL-адресов. Платформа RCS for Business не поддерживает это, независимо от того, указывают ли URL-адреса на один и тот же файл или на разные. Используйте один и тот же URL-адрес для идентичных файлов.

Платформа RCS for Business кэширует файл на 60 дней и возвращает уникальное имя, которое можно использовать для идентификации файла при отправке сообщений агенту.

Чтобы загрузить двоичный файл, выполните HTTP-запрос POST к URI загрузки, исключив поле fileUrl из тела JSON-запроса и указав двоичный файл в теле POST-запроса. Например, используйте флаг cURL --upload-file с полным путём к двоичному файлу.

HTTP-запрос

  • URI загрузки для запросов на загрузку медиафайлов:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • URI метаданных для запросов только на метаданные:
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

URL использует синтаксис перекодировки gRPC .

Текст запроса

Тело запроса содержит данные со следующей структурой:

JSON-представление 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "agentId": string
}
Поля
fileUrl

string

Необязательно. Публично доступный URL-адрес файла. Платформа RCS for Business определяет тип MIME файла по полю content-type в HTTP-заголовках при загрузке файла. RCS for Business поддерживает изображения, аудио, видео и PDF-файлы.

Поддерживаемые типы изображений: image/jpeg, image/jpg, image/gif, image/png.

Поддерживаемые типы аудиоконтента: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg.

Поддерживаемые типы видеоконтента: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm.

Поддерживаемые типы содержимого PDF: application/pdf.

Примечание: URL-адрес файла может иметь одно перенаправление. Перенаправленные URL-адреса файлов должны быть общедоступны. Перенаправления не поддерживаются для URL-адресов файлов в CreateAgentMessageRequest.

thumbnailUrl

string

Необязательно. Публично доступный URL-адрес миниатюры, соответствующей файлу. Если это поле не задано, платформа RCS for Business автоматически сгенерирует миниатюру из файла. Платформа RCS for Business определяет MIME-тип файла из поля content-type в HTTP-заголовках при загрузке файла.

Поддерживаемые типы изображений: image/jpeg, image/jpg, image/gif, image/png.

agentId

string

Обязательно. Уникальный идентификатор агента.

Тело ответа

Файловый ресурс с уникальным именем, которое агент может использовать для идентификации файла при отправке сообщений.

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "name": string
}
Поля
name

string

Уникальное имя, назначенное сервером для файлового ресурса, которое агенты могут использовать для идентификации файла при отправке сообщений. Формат: "files/{uid}", где {uid} — уникальный идентификатор.

Области авторизации

Требуется следующая область OAuth:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

Для получения более подробной информации см.OAuth 2.0 Overview .