Загрузка медиа

Функция загрузки медиафайлов позволяет сохранять данные, которые можно использовать в Display & Video 360. Типы данных, которые могут потребоваться для загрузки, включают фотографии, видео, ZIP-файлы и т. д.

Варианты загрузки

API Display & Video 360 позволяет загружать определенные типы двоичных данных или медиафайлов. Характеристики загружаемых данных подробно описаны в руководстве разработчика для любой задачи, требующей загрузки медиафайлов:

  • Максимальный размер загружаемого файла : максимальный объем данных, который можно сохранить этим методом.
  • Допустимые MIME-типы носителей : типы двоичных данных, которые можно хранить с помощью этого метода.

Вы можете отправлять запросы на загрузку любым из следующих способов. Укажите используемый вами метод с помощью параметра uploadType .

  • Простая загрузка : uploadType=media . Быстрая передача файлов размером примерно 5 МБ или меньше.
  • Многокомпонентная загрузка : uploadType=multipart . Быстрая передача файлов и соответствующих метаданных. Передача файла и метаданных осуществляется в одном запросе.

При загрузке медиафайлов используется URI /upload . Используйте этот URI при передаче самих медиаданных.

Пример:

  POST /upload/media/resource-name

Простая загрузка

Простая отправка запроса на загрузку — это самый простой способ загрузки файла. Это хороший выбор, когда:

  • Размер файла достаточно мал, чтобы при необходимости загрузить его повторно.
  • Метаданные для отправки отсутствуют. Это может быть так, если метаданные не требуются или содержатся в другом месте запроса.

Для использования простой загрузки отправьте POST или PUT запрос к URI метода /upload и добавьте параметр запроса uploadType=media . Например:

  POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media

При выполнении простой загрузки файлов следует использовать следующие HTTP-заголовки:

  • Content-Type . Установите один из типов медиаданных, принимаемых методом.
  • Content-Length . Установите значение, равное количеству загружаемых байтов. Не требуется, если вы используете кодирование с пошаговой передачей .

Многокомпонентная загрузка

Если вам необходимо отправить метаданные вместе с загружаемыми данными, вы можете использовать многокомпонентный/связанный запрос multipart/related request). Это хороший вариант, если отправляемые данные достаточно малы, чтобы при необходимости их можно было загрузить повторно.

Для использования многокомпонентной загрузки отправьте POST или PUT запрос к URI метода /upload и добавьте параметр запроса uploadType=multipart . Например:

  POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart

В качестве основных HTTP-заголовков для многокомпонентной загрузки следует использовать следующие:

  • Content-Type . Установите значение multipart/related и укажите разделительную строку, используемую для идентификации частей запроса.
  • Content-Length . Установите значение, равное общему количеству байтов в теле запроса. Медиаконтент запроса должен быть меньше максимального размера файла, указанного для этого метода.

Тело запроса отформатировано как multipart/related тип контента [ RFC2387 ] и содержит ровно две части. Части идентифицируются разделительной строкой, а за последней разделительной строкой следуют два дефиса.

Каждая часть многокомпонентного запроса должна содержать дополнительный заголовок Content-Type :

  1. Метаданные : должны располагаться первыми, а Content-Type должен соответствовать одному из принятых форматов метаданных.
  2. Часть, относящаяся к медиафайлам : должна быть указана второй, а Content-Type должен соответствовать одному из MIME-типов медиафайлов, принимаемых данным методом.

Примеры

Для выполнения различных задач вы загружаете медиафайлы с помощью API Display & Video 360. В этом разделе приведены примеры запросов curl.

Загрузите креативный ресурс.

Вот как загрузить креативный материал:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
  --header 'Authorization: Bearer access-token' \
   -F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
   -F "file=@asset-path;type=asset-mime-type"

Более подробную информацию и примеры кода см. в руководстве по загрузке креативных ресурсов .

Загрузите файл пользовательского скрипта для торгов.

Вот как загрузить файл скрипта:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
  -H 'authorization: Bearer access-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @script-path

Более подробную информацию и примеры кода см. в руководстве по скрипту загрузки .