Upload em massa

Com os scripts do Google Ads, você pode fazer mudanças em massa na sua conta fazendo upload de dados em formato CSV. É possível fazer upload de dados de um arquivo CSV do Google Drive, de uma planilha Google ou do Microsoft Excel ou criar uma solicitação de upload em massa no seu script no momento da execução. Este guia explica como usar esse recurso nos seus scripts.

Uso

Com os uploads em massa, é possível fazer alguns tipos de mudanças que não teriam suporte direto dos scripts do Google Ads, como gerenciar campanhas ou fazer upload de conversões off-line.

Criação de upload em massa a partir do Google Drive

A maneira mais simples de usar o recurso de upload em massa é fazer o upload de um arquivo CSV no Google Drive e fazer o upload desse arquivo no Google Ads usando scripts do Google Ads:

const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
    .next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();

Isso cria uma entrada de visualização de upload em massa na sua conta em Ferramentas e configurações > AÇÕES EM MASSA > Uploads.

Clique no link Visualizar para conferir as alterações.

Para aplicar as alterações à sua conta, clique no botão Aplicar alterações, na página de detalhes. Se o arquivo enviado tiver erros ou se você não quiser fazer as alterações, clique no botão Descartar visualização para descartá-las.

Depois de verificar se o script está funcionando corretamente, você pode pular a etapa de visualização e aplicar as mudanças diretamente no script. Isso pode ser feito chamando o método apply() da instância de upload em massa em vez do método preview().

Criação de um upload em massa do zero

Você pode criar uma tarefa de upload em massa do zero desta forma:

// The best way to find column names is to consult a template
// as described in the last section of this guide.
const columns = [
   "Campaign", "Budget", "Bid Strategy type", "Campaign type"
];

const upload = AdsApp.bulkUploads().newCsvUpload(columns);

// Call append once for each row you'd like to upload
upload.append({
   "Campaign": "Test Campaign 1",
   "Budget": 2.34,
   "Bid Strategy type": "cpc",
   "Campaign type": "Search Only"
});
upload.forCampaignManagement();
upload.preview();

Definição da unidade monetária

Por padrão, os valores monetários nos uploads em massa são interpretados como o valor real na moeda. Se você preferir usar micros, defina a opção moneyInMicros como true ao criar o job de upload. Por exemplo, "€2,34" seria digitado como 2340000.

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {moneyInMicros: true});

Definição da localidade do arquivo

Por padrão, o conteúdo do arquivo CSV é interpretado na localidade de inglês dos EUA (en_US). Você pode especificar uma localidade diferente usando a opção fileLocale, conforme mostrado abaixo:

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {fileLocale: "fr_FR"});

Ao especificar uma localidade, você pode fornecer os cabeçalhos de coluna na localidade en_US ou na localidade especificada na propriedade fileLocale.

Definir fuso horário

Por padrão, as entradas de tempo no arquivo são interpretadas em America/Los_Angeles. É possível especificar um fuso horário diferente usando a opção timeZone. Especifique o fuso horário no formato do banco de dados TZ.

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {timeZone: "America/New_York"});

Definir um fuso horário pode ser útil ao fazer o upload de conversões off-line.

Modelos de planilhas para o upload em massa

A maneira mais fácil de ter um modelo de planilha para um upload em massa é a partir da interface do usuário do Google Ads.

• Faça login na sua conta do Google Ads.
• Acesse Ferramentas e configurações > AÇÕES EM MASSA > Uploads.
• Clique no botão + para iniciar um novo upload.
• Uma seção vai aparecer com vários modelos para você escolher.

Você também pode fazer o download de vários modelos diferentes na Central de Ajuda.