Mídia do anúncio

Alguns tipos de anúncio, como ImageAd e ResponsiveDisplayAd, conter 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 o upload das imagens usando o ImageBuilder que usa um nome e dados de imagem. Os dados são fornecidos como um Objeto de troca de dados Blob que pode ser criados por serviços como o Drive ou 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. Fazer upload de pacotes de mídia com o MediaBundleBuilder que usa um nome e dados de arquivo. Assim como nas imagens, os dados são fornecidos 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 nos scripts do Google Ads usando uma MediaSelector Use o withCondition() para filtrar a mídia por nome, tipo ou outros campos. Por exemplo, o o snippet a seguir encontra todas as imagens de 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 códigos exemplos de criação de anúncios compatíveis com mídia anexada.