מילון מונחים

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

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

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

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

קלפים

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

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

מבוסס-כרטיס

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

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

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

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

למידע נוסף, ראו נתוני כנסים.

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

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

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

הקשר

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

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

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

תוספים לעריכה

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

פרטים נוספים זמינים במאמר תוספים לעורך.

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

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

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

תוספים ל-Gmail

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

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

דף הבית

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

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

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

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

מבוסס HTML

תוסף שממשק המשתמש שלו מוגדר באמצעות HTML ו-CSS במקום שירות הכרטיסים המובנה של Apps Script. רק תוספים ישנים יותר של הכלי לעריכה מבוססים על 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.

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

פונקציית הטיפול בווידג'ט

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

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