Recursos

Antes de criar uma campanha Geração de demanda, é importante importar todos os recursos que você planeja usar. Você sempre pode voltar e adicionar recursos mais tarde, mas precisa de um conjunto deles para começar.

Consulte o guia de práticas recomendadas e especificações de recursos de campanhas Geração de demanda ao planejar sua campanha.

Os recursos de imagem e vídeo são os principais tipos, e este guia demonstra como fazer o upload de cada um deles. Esses princípios também podem ser estendidos a outros tipos de recursos. Não importa o tipo de recurso que você está criando, use AssetOperation.

Os recursos podem ser criados usando AdsApp sem usar mutate, mas, para manter a consistência, este guia faz isso da mesma forma que todas as outras operações. Observe que você pode e deve reutilizar os recursos atuais, se já tiver alguns disponíveis. Embora seja necessário ter recursos para criar uma campanha Geração de demanda, não é estritamente necessário criá-los como parte do processo de criação da campanha.

Recursos de imagem

Os recursos de imagem são enviados em um formato codificado em base64. Como não é possível fazer upload de imagens diretamente nos scripts do Google Ads, você pode escolher entre duas abordagens diferentes para receber os dados da imagem e codificá-los para o upload.

Para buscar uma imagem do Google Drive, primeiro você precisa do ID dela, que é a melhor maneira de identificar a imagem de forma exclusiva. Uma maneira de conseguir o ID é copiar o link compartilhável da interface do Google Drive e extrair o ID. Você também pode buscar uma série de arquivos de forma programática e selecionar aqueles que quer enviar. Este código demonstra como fazer upload de uma única imagem com um ID conhecido:

const file = DriveApp.getFileById(fileId);
const imageAsset =  {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing Logo",
      "type": "IMAGE",
      "imageAsset": {
        "data": Utilities.base64Encode(file.getBlob().getBytes())
      }
    }
  }
}

Como alternativa, você pode buscar uma imagem hospedada em um servidor da Web pelo URL usando UrlFetchApp:

const file = UrlFetchApp.fetch(imageUrl);

Em seguida, você pode chamar getBlob nesse arquivo da mesma forma que faria com um arquivo do Drive. Assim, a construção da operação é idêntica às etapas de um arquivo do Google Drive.

Recursos de vídeo

Os recursos de vídeo são gerenciados por vídeos do YouTube. Se você estiver fazendo upload de recursos como parte do processo de criação da campanha, use um ID temporário. Caso contrário, anote o nome do recurso retornado para usar em uma operação futura quando precisar referenciar o recurso para adicioná-lo a um grupo de recursos.

const videoAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing video",
      "type": "YOUTUBE_VIDEO",
      "youtube_video_asset": {
        "youtube_video_title": "Demand Gen video",
        "youtube_video_id": "123456789"
      }
    }
  }
}
operations.push(videoAsset);