Mídia do anúncio

Alguns tipos de anúncios, como ImageAd e ResponsiveDisplayAd, contêm imagens e outros elementos de mídia. Este guia explica como fazer upload e consultar a mídia usando scripts do Google Ads.

Fazendo upload das imagens

É possível fazer upload de imagens usando a classe ImageBuilder, que recebe um nome e dados de imagem. Os dados são fornecidos como um objeto de troca de dados Blob que pode ser criado por serviços como o Drive ou a busca de URL.

O snippet a seguir mostra como fazer upload de uma imagem a partir de um URL externo:

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();

Também é possível carregar a imagem blob a partir do Google Drive:

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

Upload de pacotes de mídia

Pacotes de mídia são arquivos ZIP que contêm recursos HTML5, que podem ser usados para criar anúncios HTML5. Faça o upload de pacotes de mídia com a classe MediaBundleBuilder, que recebe um nome e dados de arquivo. Assim como nas imagens, os dados são fornecidos como um objeto de troca de dados Blob.

O snippet a seguir mostra como fazer upload de um pacote de mídia a partir de um URL externo:

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();

Consultas à mídia

É possível consultar mídias de todos os tipos em scripts do Google Ads usando um MediaSelector. Use o predicado withCondition() para filtrar mídia por nome, tipo ou outros campos. Por exemplo, o snippet abaixo encontra todas as imagens em uma conta:

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

Criação de anúncios com mídia

Consulte nosso artigo sobre anúncios para ver alguns exemplos de código de como criar anúncios compatíveis com mídia anexada.