תפריטים מותאמים אישית ב-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 ולהוסיף תמונה או שרטוט, בוחרים באפשרות Insert > image או Insert > Drawings.
  4. אחרי שמוסיפים את התמונה או השרטוט, לוחצים עליהן. בפינה השמאלית העליונה יופיע תפריט נפתח קטן. לוחצים עליו ובוחרים באפשרות הקצאת סקריפט.
  5. בתיבת הדו-שיח שמופיעה, מקלידים את שם הפונקציה ב-Apps Script שרוצים להפעיל, ללא סוגריים מרובעים – במקרה הזה, showMessageBox. לוחצים על OK (אישור).
  6. לוחצים שוב על התמונה או השרטוט. הפונקציה תופעל עכשיו.

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

  1. באתר של Google, לוחצים על עוד > ניהול אתר.
  2. בסרגל הצד, לוחצים על Apps Scripts (אפליקציות Apps) ואז על 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, מדגישים את הטקסט ובוחרים באפשרות Insert > Link.
  5. בתיבת הדו-שיח שתוצג, לוחצים על סקריפט של Apps, ולאחר מכן לוחצים על הפונקציה sitesLink שיצרתם. לוחצים על OK (אישור).
  6. בראש הדף לוחצים על שמירה.
  7. לוחצים על הקישור שהוספתם לדף.
  8. תופיע תיבת דו-שיח ותודיע לכם שהסקריפט דורש הרשאה. לוחצים על אישור. לאחר מכן, תופיע תיבת דו-שיח נוספת שבה תתבקשו להעניק הרשאה לשירותי Google ספציפיים. קוראים בעיון את ההודעה ולוחצים על אישור ולאחר מכן על סגירה.
  9. לאחר שהסקריפט יאושר, לחצו שוב על הקישור שהוספתם לדף. הפונקציה תופעל עכשיו. לבדוק את האימייל שלכם כדי לראות את הודעת האימייל ששלחתם בעצמכם.