Recursos

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

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

Os recursos de imagem e vídeo são os principais tipos de recursos, e este guia vai mostrar como fazer 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 para criá-lo.

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. Reutilize os recursos que já estão disponíveis. Portanto, embora seja necessário ter recursos para criar uma campanha Geração de demanda, não é estritamente necessário criar esses recursos 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ê tem duas abordagens diferentes para extrair 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 os 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())
      }
    }
  }
}

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

const file = UrlFetchApp.fetch(imageUrl);

Em seguida, chame 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

A maneira mais fácil de usar recursos de vídeo é com um vídeo do YouTube. Se você estiver enviando 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);