В этом руководстве объясняется, как использовать API Документов Google для слияния почты.
Введение
Слияние почты берет значения из строк электронной таблицы или другого источника данных и вставляет их в документ-шаблон. Это позволяет создать единый первичный документ (шаблон), на основе которого можно создать множество похожих документов, каждый из которых настроен с учетом объединяемых данных. Результат не обязательно используется для почты или формальных писем, но может использоваться для любых целей, например для создания пакета счетов клиентов.
Слияние почты существует с тех пор, как появились электронные таблицы и текстовые процессоры, и сегодня оно является частью многих рабочих процессов в бизнесе. Согласно соглашению, данные должны быть организованы в виде одной записи в строке, где столбцы представляют поля данных, как показано в следующей таблице:
Имя | Адрес | Зона | |
---|---|---|---|
1 | УрбанПк | 123 1-я ул. | Запад |
2 | Павксана | 456 2-я ул. | Юг |
Пример приложения на этой странице показывает, как можно использовать API Google Docs, Sheets и Drive, чтобы абстрагироваться от деталей выполнения слияния почты, защищая пользователей от проблем с реализацией. Дополнительную информацию об этом образце Python можно найти в репозитории примера на GitHub .
Образец заявления
Этот пример приложения копирует ваш основной шаблон, а затем объединяет переменные из назначенного источника данных в каждую из копий. Чтобы попробовать этот пример приложения, сначала настройте шаблон:
- Создайте файл Документов . Выберите шаблон, который вы хотите использовать.
- Запишите идентификатор документа нового файла. Для получения дополнительной информации см. Идентификатор документа .
- Установите для переменной
DOCS_FILE_ID
идентификатор документа. - Замените контактную информацию переменными-заполнителями шаблона, которые приложение объединит с выбранными данными.
Вот образец шаблона письма с заполнителями, которые можно объединить с реальными данными из источника, например обычного текста или таблиц. Вот как выглядит этот шаблон:
Затем выберите в качестве источника данных обычный текст или Таблицы, используя переменную SOURCE
. По умолчанию в образце используется обычный текст, то есть в примере данных используется переменная TEXT_SOURCE_DATA
. Чтобы получить данные из Таблиц, обновите переменную SOURCE
до 'sheets'
и укажите ее на наш образец листа (или свой собственный), установив переменную SHEETS_FILE_ID
.
Вот как выглядит лист, чтобы вы могли видеть его формат:
Попробуйте приложение на нашем примере данных, а затем адаптируйте его к своим данным и варианту использования. Приложение командной строки работает следующим образом:
- Настраивать
- Получить данные из источника данных
- Перебирать каждую строку данных
- Создайте копию шаблона
- Объединить копию с данными
- Выходная ссылка на вновь объединенный документ
Все вновь объединенные буквы также отображаются в «Моем диске» пользователя. Пример объединенного письма выглядит примерно так:
Исходный код
Питон
Дополнительные сведения см. в файле README
и полном исходном коде приложения в репозитории примера приложения на GitHub .
Связанные темы
- Отправляйте персонализированные электронные письма с помощью слияния писем
- Создайте слияние почты с помощью Gmail и Google Sheets