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. Mais informações sobre esse exemplo em Python podem ser encontradas no arquivo GitHub gcloud.
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 Documento ID.
- 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
nossa amostra
página
(ou os seus) 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. A 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.