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 de outra fonte de dados e insere em um documento modelo. Assim, você pode criar uma instância documento (o modelo) a partir do qual é possível gerar muitos documentos semelhantes, cada personalizado com os dados que estão sendo mesclados. O resultado não é necessariamente usado para correspondência ou cartas de formulário, mas podem ser para qualquer finalidade, como gerar um lote de faturas de clientes.
A mala direta existe desde que havia planilhas e palavras processadores e faz parte de muitos fluxos de trabalho empresariais hoje. A convenção é organizar os dados como um registro por linha, com as colunas representando os campos em os dados, conforme mostrado na tabela a seguir:
Nome | Endereço | Zona | |
---|---|---|---|
1 | UrbanPq | Avenida Brasil, 123 | Oeste |
2 | Pawxana | Avenida Brasil, 123 | Sul |
O app de exemplo nesta página mostra como usar os recursos do Documentos Google, Planilhas e Drive para abstrair detalhes de como malas diretas são realizadas, protegendo usuários contra implementações problemas. Para mais informações sobre esse exemplo em Python, acesse o repositório do GitHub.
Exemplo de aplicativo
Este aplicativo de exemplo copia seu modelo principal e mescla as variáveis do seu em cada uma das cópias. Para testar este app de exemplo, primeiro configurar seu modelo:
- Crie um arquivo dos Documentos Google. Escolha o 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 os dados de contato por variáveis de marcador de posição do modelo que o com os dados selecionados.
Este é um exemplo de carta modelo com espaços reservados que podem ser mesclados com dados reais de uma fonte, como texto texto ou Planilhas. Veja como é esse modelo:
Em seguida, escolha o texto simples ou as Planilhas como sua fonte de dados.
usando a variável SOURCE
. A amostra usa texto simples como padrão, ou seja,
os dados de amostra usam a variável TEXT_SOURCE_DATA
. Para extrair dados de
Planilhas, atualize a variável SOURCE
para 'sheets'
e aponte-a
para nossa planilha
de amostra
(ou a sua própria) definindo a variável SHEETS_FILE_ID
.
Para você conferir o formato da planilha, veja como ela é:
Teste o app com nossos dados de amostra e depois adapte-o aos seus dados e caso de uso. O aplicativo de linha de comando funciona assim:
- Configuração
- buscar os dados na fonte de dados.
- Repetir 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 letras mescladas recentemente também vão aparecer no Meu Drive do usuário. Um exemplo de uma letra mesclada é mais ou menos assim:
Código-fonte
Python
Para mais informações, consulte o arquivo README
e o código-fonte completo do aplicativo
no GitHub do aplicativo de exemplo
repositório.