En esta guía, se explica cómo usar la API de Google Docs 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 principal (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 cartas o 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 hay hojas de cálculo y 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 los campos en los datos, como se muestra en la siguiente tabla:
Nombre | Dirección | Zona | |
---|---|---|---|
1 | UrbanPq | Calle 123, 1st | Oeste |
2 | Pawxana | 456 2nd St. | Sur |
La app de ejemplo de esta página muestra cómo puedes usar las APIs de Google Docs, Hojas de cálculo y Drive para abstraer los detalles de cómo se realizan las combinaciones de correspondencia, lo que protege a los usuarios de problemas 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 quieras usar.
- Anota el ID del documento del archivo nuevo. Para obtener más información, consulta ID del documento.
- Configura la variable
DOCS_FILE_ID
como el ID del documento. - Reemplaza la información de contacto por variables de marcador de posición de la plantilla que la app combinará con los datos seleccionados.
Aquí tienes una plantilla de carta de ejemplo 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 la plantilla:
A continuación, elige texto sin formato o Hojas de cálculo como tu fuente de datos con la variable SOURCE
. El ejemplo se establece de forma predeterminada en 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 haz que apunte a nuestra hoja de cálculo de muestra (o a la tuya) 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, adáptala 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
- Itera a través de cada fila de datos.
- Crea una copia de la plantilla
- Cómo combinar la copia con los datos
- Vínculo de salida al documento recién combinado
Todas las cartas combinadas recientemente también aparecen en la sección 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 repo de GitHub de la app de ejemplo.
Temas relacionados
- Envía mensajes personalizados con la combinación de correo electrónico
- Crea una combinación de correo electrónico con Gmail y Hojas de cálculo de Google