במדריך הזה מוסבר איך להשתמש ב-Google Docs API כדי לבצע מיזוג אימיילים.
מבוא
מיזוג אימיילים לוקח ערכים משורות של גיליון אלקטרוני או ממקור נתונים אחר ומוסיפה אותן למסמך תבנית. כך אפשר ליצור חשבון ראשי אחד מסמך (התבנית) שממנו אפשר ליצור מסמכים דומים רבים, מותאמים אישית עם הנתונים שממוזגים. התוצאה לא בהכרח משמשת בדואר רגיל או מכתבי טופס, אך יכולים להיות לכל מטרה, כגון יצירת קבוצה של חשבוניות הלקוח.
התכונה 'מיזוג אימיילים' קיימת כל עוד יש גיליונות אלקטרוניים ו-Word והיא חלק מתהליכי עבודה עסקיים רבים. המוסכמה היא לארגן את הנתונים כרשומה אחת בכל שורה, כאשר העמודות מייצגות שדות של הנתונים, כפי שמוצג בטבלה הבאה:
שם | כתובת | תחום (zone) | |
---|---|---|---|
1 | UrbanPq | רחוב בן יהודה 123 | מערב |
2 | Pawxana | 456 2nd St. | דרום |
האפליקציה לדוגמה שבדף הזה מראה איך אפשר להשתמש ב-Google Docs, Sheets ו-Drive API כדי להפשט פרטים על האופן שבו מבוצעים מיזוגי אימיילים, וכך מגינים על המשתמשים מפני הטמעה לבעיות. מידע נוסף על דוגמת Python זו זמין GitHub מאגר תגים.
אפליקציה לדוגמה
האפליקציה לדוגמה הזו מעתיקה את התבנית הראשית ואז ממזגת משתנים מהתבנית הראשית את מקור הנתונים הייעודי בכל אחד מהעותקים. כדי לנסות את האפליקציה לדוגמה, תחילה מגדירים את התבנית:
- יוצרים קובץ Docs. בוחרים את שבה רוצים להשתמש.
- בודקים את מזהה המסמך החדש. מידע נוסף זמין בקטע מסמכים ID (מזהה).
- מגדירים את המשתנה
DOCS_FILE_ID
כמזהה המסמך. - מחליפים את הפרטים ליצירת קשר במשתני placeholder של תבניות האפליקציה תמוזג עם הנתונים שנבחרו.
הנה מכתב לדוגמה תבנית באמצעות placeholders שאפשר למזג עם נתונים אמיתיים ממקור, כמו טקסט או גיליונות אלקטרוניים. כך נראית התבנית הזו:
בשלב הבא, בוחרים באפשרות 'טקסט פשוט' או 'Sheets' כמקור הנתונים
באמצעות המשתנה SOURCE
. ברירת המחדל של הדוגמה היא טקסט פשוט, כלומר
הנתונים לדוגמה משתמשים במשתנה TEXT_SOURCE_DATA
. המקור של הנתונים
Sheets, צריך לעדכן את המשתנה SOURCE
ל-'sheets'
ולהפנות אותו
אל הדוגמה שלנו
גיליון
(או משלכם) על ידי הגדרה של המשתנה SHEETS_FILE_ID
.
כך נראה הגיליון כדי שתוכלו לראות את הפורמט:
כדאי לנסות את האפליקציה עם הנתונים לדוגמה שלנו, ואז להתאים אותה לנתונים ולתרחיש הדוגמא שלכם. אפליקציית שורת הפקודה פועלת כך:
- הגדרה
- אחזור הנתונים ממקור הנתונים
- הצגת כל שורה של נתונים בלופ
- יצירת עותק של התבנית
- מיזוג העותק עם הנתונים
- קישור לפלט למסמך שמוזג לאחרונה
כל האותיות החדשות שמוזגו יופיעו גם בתיקייה 'האחסון שלי' של המשתמש. דוגמה לאות ממוזגת נראית בערך כך:
קוד מקור
Python
למידע נוסף, אפשר לעיין בקובץ README
ובקוד המקור המלא של האפליקציה
ב-GitHub של האפליקציה לדוגמה
מאגר.
נושאים קשורים
- איך שולחים אימיילים מותאמים אישית באמצעות מיזוג אימיילים
- יוצרים מיזוג אימיילים באמצעות Gmail ו גיליון אלקטרוני ב-Google Sheets