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

As imagens podem ser enviadas usando a classe ImageBuilder, que recebe um nome e dados da 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 upload de pacotes de mídia com a classe MediaBundleBuilder, que recebe um nome e dados de arquivo. Assim como as 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 fazer consultas a mídias de todos os tipos nos 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 a seguir 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 conferir alguns exemplos de código que mostram como criar anúncios compatíveis com mídia anexada.