Este guia explica como usar a API Google Docs para fazer uma mala direta.
Introdução
Uma mala direta usa valores de linhas de uma planilha ou outra fonte de dados e os insere em um modelo de documento. Isso permite criar um único documento principal (o modelo) com base no qual você pode gerar muitos documentos semelhantes, cada um personalizado com os dados que estão sendo mesclados. O resultado não é necessariamente usado para correspondências ou cartas modelo, mas pode ser para qualquer finalidade, como gerar um lote de faturas de clientes.
A mala direta existe há tanto tempo quanto as planilhas e os processadores de texto, e faz parte de muitos fluxos de trabalho comerciais hoje. A convenção é organizar os dados como um registro por linha, com as colunas representando campos nos dados, conforme mostrado na tabela a seguir:
Nome | Endereço | Zona | |
---|---|---|---|
1 | UrbanPq | Rua 1º de Maio, 123 | Oeste |
2 | Pawxana | 456 2nd St. | Sul |
O app de exemplo nesta página mostra como usar as APIs do Google Docs, Planilhas e Drive para abstrair os detalhes de como as mala diretas são realizadas, protegendo os usuários de problemas de implementação. Para mais informações sobre essa amostra em Python, acesse o repositório do GitHub.
Exemplo de aplicativo
Esse app de exemplo copia seu modelo principal e mescla variáveis da fonte de dados designada em cada uma das cópias. Para testar esse app de exemplo, primeiro configure seu modelo:
- Crie um arquivo do Documentos. Escolha o modelo que você quer usar.
- Anote o ID do documento do novo arquivo. Para mais informações, consulte ID do documento.
- Defina a variável
DOCS_FILE_ID
como o ID do documento. - Substitua as informações de contato por variáveis de marcador de posição do modelo que o app vai mesclar com os dados selecionados.
Confira um modelo de carta de exemplo com marcadores de posição que podem ser mesclados com dados reais de uma fonte, como texto simples ou o Google Sheets. Veja como fica o modelo:
Em seguida, escolha texto simples ou Google Sheets como sua origem de dados usando a variável SOURCE
. O exemplo usa texto simples por padrão, ou seja, os dados de amostra usam a variável TEXT_SOURCE_DATA
. Para extrair dados das
Planilhas Google, atualize a variável SOURCE
para 'sheets'
e aponte para nossa planilha de exemplo (ou a sua) definindo a variável SHEETS_FILE_ID
.
Confira como a planilha aparece para entender o formato:
Teste o app com nossos dados de amostra e adapte-o aos seus dados e caso de uso. O aplicativo de linha de comando funciona da seguinte maneira:
- Configuração
- Buscar os dados da fonte
- Faça um loop em cada linha de dados
- Criar uma cópia do modelo
- Mesclar a cópia com os dados
- Link de saída para o documento recém-mesclado
Todas as cartas recém-mescladas também aparecem no Meu Drive do usuário. Um exemplo de carta mesclada é assim:
Código-fonte
Python
Para mais informações, consulte o arquivo README
e o código-fonte completo do aplicativo
no repositório do GitHub do app de exemplo.
Temas relacionados
- Enviar e-mails personalizados com a mala direta
- Criar uma mala direta com o Gmail e as Planilhas Google