Рекламные носители,Рекламные носители

Некоторые типы объявлений, такие как ImageAd и ResponsiveDisplayAd , содержат изображения и другие мультимедийные элементы. В этом руководстве описывается, как загружать и запрашивать медиафайлы с помощью скриптов Google Рекламы.

Загрузка изображений

Изображения можно загружать с помощью класса ImageBuilder , который принимает имя и данные изображения. Данные предоставляются в виде объекта обмена данными Blob , который может быть создан такими службами, как Drive или URL-адрес .

В следующем фрагменте показано, как загрузить изображение с внешнего URL-адреса:

let imageUrl = "http://www.example.com/example.png";
let imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

Кроме того, изображение можно загрузить с Google Диска:

let imageFileId = "IMAGE_FILE_ID";
let imageBlob = DriveApp.getFileById(imageFileId).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

Загрузка медиапакетов

Медиа-пакеты – это ZIP-архивы, содержащие ресурсы HTML5, которые можно использовать для создания объявлений HTML5 . Загрузите пакеты мультимедиа с помощью класса MediaBundleBuilder , который принимает имя и данные файла. Как и в случае с изображениями, данные предоставляются в виде объекта обмена данными Blob .

В следующем фрагменте показано, как загрузить пакет мультимедиа с внешнего URL-адреса:

let mediaBundleUrl = "http://www.example.com/example.zip";
let mediaBundleBlob = UrlFetchApp.fetch(mediaBundleUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newMediaBundleBuilder()
    .withName("bundle name")
    .withData(mediaBundleBlob)
    .build();

Запрос мультимедиа

Медиафайлы любого типа можно запросить в скриптах Google Рекламы с помощью MediaSelector . Используйте предикат withCondition() для фильтрации мультимедиа по имени, типу или другим полям. Например, следующий фрагмент находит все изображения в учетной записи:

let mediaIterator = AdsApp.adMedia().media()
    .withCondition("Type = IMAGE")
    .get();
while (mediaIterator.hasNext()) {
  let image = mediaIterator.next();
}

Создание рекламы с помощью медиа

В нашей статье о рекламе приведены примеры кода для создания поддерживаемых объявлений с прикрепленными медиафайлами.