מילון מונחים

המונחים הבאים מופיעים לאורך כל המאמר הזה.

תוסף לשיחות ועידה ביומן

תוסף מיוחד שמאפשר לספקי שיחות ועידה להציג אפשרויות לשיחות ועידה באירועים ביומן Google. כדי שהתוספים האלה יוכלו להתחבר, הם צריכים פתרון לשיחות ועידה שפותח היטב. בגלל הדרישה הזו, לרוב המפתחים אין צורך ליצור תוסף לשיחות ועידה ביומן.

מידע נוסף זמין במאמר בנושא תוספים לשיחות ועידה ביומן. במאמר שדרוג תוספים שפורסמו מוסבר איך להמיר תוסף לשיחות ועידה ביומן לתוסף ל-Google Workspace.

קלפים

'דף' יחיד בממשק המשתמש של תוסף. כרטיסים מורכבים מאובייקטים שונים של ווידג'טים (כפתורים, שדות טקסט, כותרות וכו').

מידע נוסף זמין במאמר בנושא כרטיסים.

מבוסס כרטיסים

תוסף שממשק המשתמש שלו מופיע כחלונית בסרגל הצד (או בנייד, כחלון פעילות אחר שאליו מגיעים דרך התפריט). בתוסף יש סרגל כלים עליון שמזהה את התוסף ומציג כרטיס – בעצם 'דף' בממשק המשתמש של התוסף.

התוספים ל-Google Workspace מבוססים על כרטיסים.

נתוני שיחות ועידה

קבוצת המידע שיומן Google צריך כדי לאפשר למשתמשים ליצור שיחות ועידה של צד שלישי ולהצטרף אליהן באמצעות תוסף של Google Workspace או תוסף לשיחות ועידה ביומן.

מידע נוסף זמין במאמר בנושא נתונים של שיחות ועידה.

פתרון לשיחות ועידה

ייצוג של שיחת ועידה של צד שלישי שאפשר ליצור מיומן Google באמצעות תוסף של Google Workspace או תוסף לשיחות ועידה של יומן Google.

מידע נוסף זמין במאמר בנושא פתרונות לשיחות ועידה.

הקשר

המצב הנוכחי של אפליקציית המארח. לדוגמה, איזו הודעה פתוחה כרגע ב-Gmail, איזה אירוע ביומן אתם עורכים או אילו קבצים ב-Drive בחרתם הם חלק מההקשר הנוכחי של אפליקציית המארח. הקונטקסט, יחד עם מידע נוסף, נאסף לאובייקט אירוע שמועבר לפונקציית הטריגר כפרמטר.

הפעלה לפי הקשר

השיטה של הגדרת טריגרים שמופעלים כשהמשתמש נכנס להקשר ספציפי, למשל כשהוא פותח שרשור אימייל ב-Gmail. הפעלה לפי הקשר מאפשרת לתוסף לספק ממשק משתמש שרלוונטי להקשר הזה. טריגרים הקשריים מוגדרים במניפסט של פרויקט הסקריפט של התוסף, ולכן הם סוג של טריגר מניפסט.

תוספי עריכה

הקבוצה המקורית של סוגי התוספים שמאפשרים רק הרחבות של Google Docs,‏ Sheets,‏ Forms או Slides. תוספים ל-Editor לא מבוססים על כרטיסים. במקום זאת, המפתח צריך ליצור ממשק משתמש מ-HTML ו-CSS גולמיים. כל תוסף של כלי העריכה יכול להרחיב רק אפליקציית מארח אחת.

מידע נוסף זמין במאמר בנושא תוספים ל-Editor.

אובייקט האירוע

אובייקט ה-JSON שנוצר באופן אוטומטי כשמתבצעת בקשה לדפי בית, כשתוסף נכנס להקשרים שהוא צריך להגיב להם או כתוצאה מאינטראקציות של משתמשים עם ווידג'טים בממשק התוסף. אחרי שיוצרים אובייקטים של אירועים, הם מועברים לפונקציית טריגר או לפונקציית קריאה חוזרת שצוינו. המטרה של אובייקטים של אירועים היא להעביר מידע מסביבת הלקוח של המשתמש (למשל, מידע שהמשתמש הזין בווידג'טים של ממשק התוסף) לקוד בצד השרת של התוסף. לאחר מכן, הקוד יכול לפעול על סמך המידע הזה ולהחזיר את התגובה המתאימה.

פרטים נוספים זמינים במאמר בנושא אובייקטים של אירועים.

תוספים ל-Gmail

תוסף שמרחיב רק את Gmail. תוספים ל-Gmail מבוססים על כרטיסים. הרבה מהפונקציונליות, ההתנהגות ופרטי הפיתוח שמשמשים ליצירת תוספים ל-Gmail זהים לפרטים שמשמשים ליצירת תוספים ל-Google Workspace.

מידע נוסף זמין במאמר בנושא תוספים ל-Gmail. אפשר גם לעיין במאמר בנושא שדרוג תוספים שפורסמו כדי לקבל מידע על המרת תוסף ל-Gmail לתוסף Google Workspace.

דף הבית

כרטיס ממשק המשתמש הבסיסי של תוסף. דפי הבית מוצגים כשמשתמשים פותחים את התוסף, והם מאפשרים לתוסף להציג תוכן מחוץ להקשר ספציפי (לדוגמה, כשהמשתמש צופה בשרשורי האימייל שלו ב-Gmail, אבל לא פתח אחד מהם). אתם מגדירים את המראה וההתנהגות של דף הבית של התוסף, כמו כל כרטיס אחר.

מידע נוסף זמין במאמר בנושא דפי בית.

מארח או אפליקציית מארח

האפליקציה של Google Workspace שתוסף ל-Google Workspace מרחיב, כמו Gmail או יומן Google.

מבוסס על HTML

תוסף שממשק המשתמש שלו מוגדר באמצעות HTML ו-CSS במקום שירות הכרטיסים המובנה של Apps Script. רק תוספים ישנים יותר ל-Editor מבוססים על HTML.

טריגר לתצוגה מקדימה של קישור

טריגרים של תצוגה מקדימה של קישור מופעלים כשמשתמשים יוצרים אינטראקציה עם כתובת URL של צד שלישי או כתובת URL שאינה של Google באפליקציית מארח של Google, כמו Google Docs. הפעלת תצוגה מקדימה של קישור מאפשרת לכם להגדיר תבניות של כתובות URL כדי להציג תצוגה מקדימה מהשירות או מה-API שלכם, ולקבוע את תוכן התצוגה המקדימה, כולל הצ'יפ החכם וכרטיס התצוגה המקדימה. הגדרת הטריגרים לתצוגה מקדימה של קישורים מתבצעת במניפסט של פרויקט הסקריפט של התוסף, ולכן הם סוג של טריגר מניפסט.

מידע נוסף זמין במאמר תצוגה מקדימה של קישורים באמצעות צ'יפים חכמים.

מניפסט

קובץ JSON שמצורף לפרויקט Apps Script. קובץ המניפסט משמש להגדרת פרטי הפרויקט שהסקריפט צריך כדי לפעול בצורה תקינה. בתוספים ל-Google Workspace, קובץ המניפסט משמש כדי לציין אילו מארחים התוסף יכול להרחיב ולספק הגדרות מסוימות של רכיבים אינטראקטיביים בממשק המשתמש.

טריגר מניפסט

טריגר שמוגדר במניפסט של פרויקט, כמו טריגר של דף הבית או טריגר הקשרי. טריגרים של מניפסט משמשים באופן בלעדי ליצירה ולהצגה של כרטיסים חדשים כשמתבצעת בקשה לדף הבית של התוסף או כשהתוסף נכנס להקשר שדורש עדכון של התצוגה.

טריגרים של מניפסט שונים מטריגרים אחרים ב-Apps Script כי הם לא מובנים (כמו טריגרים פשוטים) ואי אפשר ליצור אותם באופן פרוגרמטי באמצעות שירות הסקריפט של Apps Script (כמו טריגרים שניתנים להתקנה).

כרטיסים לא הקשריים

כרטיסים שמציגים תוכן כשהמשתמש נמצא מחוץ להקשר מסוים. לדוגמה, כשהמשתמש צופה בשרשורי האימייל שלו ב-Gmail, אבל לא פתח אף אחד מהם. דפי הבית הם סוג של כרטיס לא תלוי-הקשר.

סרגל צד

הקטע בצד שמאל של ממשק המשתמש של המארח שבו מופיע ממשק המשתמש של תוסף ל-Google Workspace. תוספים ל-Gmail ול-Editor יכולים גם להגדיר סרגלי צד.

צ'יפ חכם

צ'יפ חכם הוא אזכור של אדם, קובץ, אירוע ביומן או ישות אחרת באפליקציית Google Workspace. כשמשתמשים מעבירים את העכבר מעל צ'יפ, הם יכולים גם לראות תצוגה מקדימה של תוכן נוסף על הקובץ או הקישור. לדוגמה, כשמשתמשים מעבירים את העכבר מעל צ'יפ במצגת Google Slides, הם רואים צילום מסך של שקף, את הבעלים של המצגת ואם הם צפו במצגת בעבר.

אתם יכולים להגדיר את התוסף כך שישתמש בצ'יפים חכמים כדי להציג תצוגה מקדימה של קישורים לשירות של צד שלישי או לשירות שאינו של Google. הצגת תצוגה מקדימה של קישורים ב-Google Docs

טריגר

תנאי ותגובה אוטומטית לאירוע שמוגדרים על ידי פרויקט Apps Script או תוסף. הטריגרים מופעלים כשהאירוע המשויך להם מתרחש (לדוגמה, כשפותחים תוסף), וגורמים להפעלה אוטומטית של פונקציית Apps Script שצוינה (פונקציית הטריגר). בתוספים של Google Workspace, פונקציות טריגר יוצרות לעיתים קרובות כרטיסים חדשים כדי לשלוט באיזה חלק מממשק המשתמש של התוסף יוצג. רק לסוגים מסוימים של אירועים יכולים להיות טריגרים.

מידע נוסף זמין במאמר בנושא טריגרים של תוספים.

פונקציית טריגר

פונקציית Apps Script בפרויקט שמופעלת בתגובה להפעלת טריגר.

ווידג'ט

רכיב בממשק המשתמש, כמו לחצן, שדה טקסט או תיבת סימון. הכרטיסים מורכבים מרצף של אובייקטים של ווידג'טים, שמוגדרים על ידי שירות הכרטיסים המובנה של Apps Script.

מידע נוסף זמין במאמר בנושא ווידג'טים.

פונקציית handler של ווידג'ט

פונקציה שמקשרת ווידג'ט מסוים לאובייקט פעולה מסוים. לכל סוג ווידג'ט יש קבוצה של פונקציות לטיפול בווידג'ט, שאפשר להשתמש בהן כדי להתחבר לפעולות. פונקציות של רכיבי handler של ווידג'טים מגדירות איזה סוג של אינטראקציה של משתמש מפעיל את הפעולה שמתקבלת, והן רכיב חיוני באינטראקטיביות של הווידג'ט.

מידע נוסף זמין במאמר בנושא פונקציות לטיפול בווידג'טים.