Ce guide explique comment utiliser l'API Google Docs pour effectuer une fusion de courriers.
Introduction
Une mise en page avec imbrication de données extrait les valeurs des lignes d'une feuille de calcul ou d'une autre source de données, puis les insère dans un document de modèle. Vous pouvez ainsi créer un seul document principal (le modèle) à partir duquel vous pouvez générer de nombreux documents similaires, chacun personnalisé avec les données fusionnées. Le résultat n'est pas nécessairement utilisé pour l'envoi de courriers ou de lettres types, mais peut servir à n'importe quel autre fin, comme la génération d'un lot de factures client.
La fusion de courriers existe depuis l'apparition des feuilles de calcul et des traitements de texte, et fait partie de nombreux processus métier aujourd'hui. La convention consiste à organiser les données en un enregistrement par ligne, les colonnes représentant les champs des données, comme indiqué dans le tableau suivant:
Nom | Adresse | Zone | |
---|---|---|---|
1 | UrbanPq | 123 1st St. | Ouest |
2 | Pawxana | 456 2nd St. | Sud |
L'application exemple de cette page montre comment utiliser les API Google Docs, Sheets et Drive pour éliminer les détails de la fusion de courriers, ce qui protège les utilisateurs des problèmes d'implémentation. Pour en savoir plus sur cet exemple Python, consultez le dépôt GitHub de l'exemple.
Exemple d'application
Cet exemple d'application copie votre modèle principal, puis fusionne les variables de votre source de données désignée dans chacune des copies. Pour essayer cet exemple d'application, commencez par configurer votre modèle:
- Créez un fichier Docs. Choisissez le modèle que vous souhaitez utiliser.
- Notez l'ID du document du nouveau fichier. Pour en savoir plus, consultez ID de document.
- Définissez la variable
DOCS_FILE_ID
sur l'ID du document. - Remplacez les coordonnées par des variables d'espace réservé de modèle que l'application fusionnera avec les données sélectionnées.
Voici un exemple de modèle de lettre avec des espaces réservés pouvant être fusionnés avec des données réelles provenant d'une source telle que du texte brut ou Sheets. Voici à quoi ressemble ce modèle:
Ensuite, choisissez le texte brut ou Sheets comme source de données à l'aide de la variable SOURCE
. L'exemple utilise par défaut le texte brut, ce qui signifie que les données de l'exemple utilisent la variable TEXT_SOURCE_DATA
. Pour extraire des données à partir de Sheets, remplacez la variable SOURCE
par 'sheets'
et faites-la pointer vers notre feuille d'exemple (ou la vôtre) en définissant la variable SHEETS_FILE_ID
.
Voici à quoi ressemble la feuille pour que vous puissiez voir le format:
Essayez l'application avec nos exemples de données, puis adaptez-la à vos données et à votre cas d'utilisation. L'application de ligne de commande fonctionne comme suit:
- Configuration
- Récupérer les données de la source de données
- Itérer chaque ligne de données
- Créer une copie du modèle
- Fusionner la copie avec les données
- Lien de sortie vers le document nouvellement fusionné
Toutes les lettres nouvellement fusionnées s'affichent également dans Mon Drive de l'utilisateur. Voici un exemple de lettre fusionnée:
Code source
Python
Pour en savoir plus, consultez le fichier README
et le code source complet de l'application dans le dépôt GitHub de l'application exemple.
Articles associés
- Envoyer des e-mails personnalisés avec le publipostage
- Créer un publipostage avec Gmail et Google Sheets