מילון מונחים

המונחים הבאים מופיעים במסמך הזה.

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

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

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

קלפים

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

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

מבוסס כרטיס

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

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

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

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

למידע נוסף, ראו נתוני שיחות.

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

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

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

הקשר

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

טריגר לפי הקשר

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

תוספי עריכה

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

לפרטים נוספים, ראו תוספי עריכה.

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

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

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

תוספים ל-Gmail

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

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

דף הבית

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

למידע נוסף, ראו דפי הבית.

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

התוסף של אפליקציית 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 ולעריכה יכולים גם להגדיר סרגלי צד.

צ'יפ חכם

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

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

Trigger

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

למידע נוסף, ראו טריגרים לתוספים.

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

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

ווידג'ט

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

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

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

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

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