מילון מונחים

המונחים הבאים מופיעים בתיעוד הזה.

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

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

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

כרטיס

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

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

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

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

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

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

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

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

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

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

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

הקשר

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

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

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

תוספי עריכה

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

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

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

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

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

תוספים ל-Gmail

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

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

דף הבית

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

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

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

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

מבוססת HTML

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

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

תצוגה מקדימה למפתחים: התכונה הזו זמינה כחלק מתוכנית התצוגה המקדימה למפתחים של Google Workspace, שמעניקה גישה מוקדמת לתכונות מסוימות.

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

מידע נוסף זמין במאמר תצוגה מקדימה של קישורים ב-Google Docs.

מניפסט

קובץ 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 של ווידג'טים, שאפשר להשתמש בהם כדי להתחבר לפעולות. הפונקציות של הווידג'טים מגדירות את סוג האינטראקציה של המשתמש שגורמת לביצוע הפעולה שמתקבלת, והן רכיב חיוני באינטראקטיביות של הווידג'ט.

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