En esta guía, se explica cómo usar la API de Documentos de Google para realizar una combinación de correspondencia.
Introducción
Una combinación de correspondencia toma valores de las filas de una hoja de cálculo o de otra fuente de datos y los inserta en un documento de plantilla. Esto te permite crear un solo documento primario (la plantilla) a partir del cual puedes generar muchos documentos similares, cada uno personalizado con los datos que se combinan. El resultado no se usa necesariamente para correos electrónicos ni cartas de formularios, sino que puede usarse para cualquier propósito, como generar un lote de facturas de clientes.
La combinación de correspondencia existe desde que existen las hojas de cálculo y los procesadores de texto, y hoy en día forma parte de muchos flujos de trabajo empresariales. La convención es organizar los datos como un registro por fila, con las columnas que representan campos en los datos, como se muestra en la siguiente tabla:
Nombre | Dirección | Zona | |
---|---|---|---|
1 | UrbanPq | Calle 123 1ª | Oeste |
2 | Pawxana | 456 2nd St. | Sur |
En la app de ejemplo de esta página, se muestra cómo puedes usar las APIs de Google Docs, Sheets y Drive para abstraer los detalles de cómo se realizan las fusiones de correspondencia, lo que protege a los usuarios de las preocupaciones de implementación. Puedes encontrar más información sobre este ejemplo de Python en el repositorio de GitHub del ejemplo.
Aplicación de ejemplo
Esta app de ejemplo copia tu plantilla principal y, luego, combina las variables de tu fuente de datos designada en cada una de las copias. Para probar esta app de ejemplo, primero configura tu plantilla:
- Crea un archivo de Documentos. Elige la plantilla que quieres usar.
- Anota el ID del documento del archivo nuevo. Para obtener más información, consulta ID de documento.
- Establece la variable
DOCS_FILE_ID
como el ID del documento. - Reemplaza la información de contacto por variables de marcador de posición de plantilla que la app combinará con los datos seleccionados.
Esta es una plantilla de carta de muestra con marcadores de posición que se pueden combinar con datos reales de una fuente, como texto sin formato o Hojas de cálculo. Esta es la apariencia de esa plantilla:
A continuación, elige texto sin formato o Hojas de cálculo como fuente de datos con la variable SOURCE
. El valor predeterminado de la muestra es texto sin formato, lo que significa que los datos de muestra usan la variable TEXT_SOURCE_DATA
. Para obtener datos de Hojas de cálculo, actualiza la variable SOURCE
a 'sheets'
y configúrala para que apunte a nuestra hoja de cálculo de muestra (o la tuya propia) configurando la variable SHEETS_FILE_ID
.
Así se ve la hoja para que puedas ver el formato:
Prueba la app con nuestros datos de muestra y, luego, ajústala a tus datos y caso de uso. La aplicación de línea de comandos funciona de la siguiente manera:
- Configuración
- Recupera los datos de la fuente de datos
- Realiza un bucle en cada fila de datos
- Crea una copia de la plantilla
- Combina la copia con los datos
- Vínculo de salida al documento recién fusionado
Todas las letras combinadas recientemente también aparecen en Mi unidad del usuario. Un ejemplo de una carta combinada se ve de la siguiente manera:
Código fuente
Python
Para obtener más información, consulta el archivo README
y el código fuente completo de la aplicación en el repositorio de GitHub de la app de ejemplo.
Temas relacionados
- Envía mensajes personalizados con la combinación de correo electrónico
- Cómo crear una combinación de correo electrónico con Gmail y Hojas de cálculo de Google