תפריטים מותאמים אישית ב-Google Workspace

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

תפריטים מותאמים אישית ב-Google Docs, Sheets, Slides או Forms

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

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

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

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  // Or DocumentApp or FormApp.
  ui.createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addSeparator()
      .addSubMenu(ui.createMenu('Sub-menu')
          .addItem('Second item', 'menuItem2'))
      .addToUi();
}

function menuItem1() {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
     .alert('You clicked the first menu item!');
}

function menuItem2() {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
     .alert('You clicked the second menu item!');
}

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

הערה: תוספי עריכה יכולים לכלול גם תפריטים, אבל כדאי להשתמש בכללים מיוחדים שהם מוגדרים.

תמונות ושרטוטים שניתנים ללחיצה ב-Google Sheets

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

1. ב-Google Sheets, בוחרים את האפשרות בתפריט תוספים > Apps Script כדי ליצור סקריפט שמקושר לגיליון האלקטרוני.

2. מוחקים את הקוד בעורך הסקריפטים ומדביקים את הקוד שלמטה.

     function showMessageBox() {
       Browser.msgBox('You clicked it!');
     }
   

3. חוזרים אל Sheets ומוסיפים תמונה או שרטוט על ידי בחירה באפשרות הוספה > תמונה או הוספה > שרטוט.

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

5. בתיבת הדו-שיח שמופיעה, מקלידים את השם של פונקציית Apps Script שרוצים להריץ, ללא סוגריים – במקרה הזה, showMessageBox. לוחצים על אישור.

6. לוחצים שוב על התמונה או על השרטוט. הפונקציה תופעל כעת.

קישורים לסקריפט ב-Google Sites

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

1. באתר של Google, לוחצים על אפשרויות נוספות > ניהול אתר.
2. בסרגל הצד, לוחצים על Apps Scripts (סקריפטים של אפליקציות) ואז על Add new Script (הוספת סקריפט חדש) כדי ליצור סקריפט שקשור לאתר.

3. מוחקים כל קוד בעורך הסקריפטים ומדביקים את הקוד שבהמשך, מה שישלח אימייל כשהמשתמש ילחץ על קישור.

     function sitesLink() {
       var recipient = Session.getActiveUser().getEmail();
       GmailApp.sendEmail(recipient, 'Email from your site', 'You clicked a link!');
     }
   

4. חוזרים לאתר שנוצר באמצעות Google Sites ועורכים את הדף. מקלידים תווית שתהפוך לקישור, כמו Click me, מדגישים את הטקסט ובוחרים באפשרות הוספה > קישור.

5. בתיבת הדו-שיח שמופיעה, לוחצים על Apps Script ואז על הפונקציה sitesLink שיצרתם. לוחצים על אישור.

6. לוחצים על שמירה בראש הדף.

7. לוחצים על הקישור שהוספתם לדף.

8. תופיע תיבת דו-שיח ותודיע לך שהסקריפט דורש הרשאה. לוחצים על OK. לאחר מכן תוצג תיבת דו-שיח שנייה לבקשת הרשאה עבור שירותי Google ספציפיים. קוראים בעיון את ההודעה, לוחצים על Allow ולאחר מכן על Close.

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