רמת הקוד: בינונית
משך: 30 דקות
סוג הפרויקט: תוסף ל-Google Workspace
מטרות
- להבין מה הפתרון עושה.
- הסבר על הפעולות של שירותי Apps Script בתוך הפתרון.
- מגדירים את הסביבה.
- מגדירים את הסקריפט.
- מריצים את הסקריפט.
מידע על הפתרון הזה
העתקה ידנית של מאקרו ב-Google Sheets מגיליון אלקטרוני אחד לגיליון אחר עשויה להיות זמן רב ומועדת לשגיאות. התוסף הזה ל-Google Workspace מעתיק באופן אוטומטי פרויקט סקריפט ומצרף אותו לגיליון אלקטרוני שהמשתמש מציין. הפתרון הזה מתמקד במאקרוסים של Sheets, אבל אפשר להשתמש בו כדי להעתיק ולשתף כל סקריפט שמקושר לקונטיינר.
איך זה עובד
הסקריפט מעתיק את פרויקט Apps Script שמקושר לגיליון האלקטרוני המקורי ויוצר עותק כפול של פרויקט Apps Script שמקושר לגיליון האלקטרוני שצוין על ידי המשתמש.
שירותי Apps Script
הפתרון הזה משתמש בשירותים הבאים:
- שירות אחזור של כתובות אתרים – מתחבר ל-AppsScript API כדי להעתיק את פרויקט המקור וליצור עותק.
- שירות סקריפט – הרשאה ל-Apps Script API כדי למנוע הופעה של בקשה שנייה לאישור.
- שירות גיליון אלקטרוני – פותח את גיליון האלקטרוני היעד כדי להוסיף את פרויקט Apps Script שהועתק.
- שירות כרטיסים – יוצר את ממשק המשתמש של התוסף.
דרישות מוקדמות
כדי להשתמש בדוגמה הזו, צריך את הדרישות המוקדמות הבאות:
- חשבון Google (יכול להיות שחשבונות Google Workspace ידרשו אישור מהאדמין).
דפדפן אינטרנט עם גישה לאינטרנט.
Google Apps Script API מופעל בהגדרות של לוח הבקרה של Apps Script.
הגדרת הסביבה
פותחים את פרויקט Cloud במסוף Google Cloud
אם הוא עדיין לא פתוח, פותחים את פרויקט Cloud שבו רוצים להשתמש לדוגמה הזו:
- נכנסים לדף Select a project במסוף Google Cloud.
- בוחרים את הפרויקט ב-Google Cloud שבו רוצים להשתמש. לחלופין, לוחצים על Create project (יצירת פרויקט) ופועלים לפי ההוראות במסך. אם יוצרים פרויקט ב-Google Cloud, יכול להיות שתצטרכו להפעיל את החיוב בפרויקט.
הפעלת Google Apps Script API
במדריך למתחילים הזה נעשה שימוש ב-Google Apps Script API.
לפני שמשתמשים ב-Google APIs, צריך להפעיל אותם בפרויקט ב-Google Cloud. אפשר להפעיל ממשק API אחד או יותר בפרויקט אחד ב-Google Cloud.בפרויקט ב-Cloud, מפעילים את Google Apps Script API.
הגדרת מסך ההסכמה של OAuth
כדי להשתמש בתוספים של Google Workspace, צריך להגדיר מסך הסכמה. הגדרת מסך ההסכמה ל-OAuth של התוסף קובעת מה Google תציג למשתמשים.
- במסוף Google Cloud, נכנסים לתפריט > > Branding.
- אם כבר הגדרתם את , תוכלו להגדיר את ההגדרות הבאות של מסך ההסכמה ל-OAuth בקטע מיתוג, קהל וגישה לנתונים. אם מופיעה ההודעה not configured yet, לוחצים על Get Started:
- בקטע פרטי האפליקציה, בשדה שם האפליקציה, מזינים שם לאפליקציה.
- בקטע כתובת אימייל לתמיכה במשתמשים, בוחרים כתובת אימייל לתמיכה שבה המשתמשים יוכלו לפנות אליכם אם יש להם שאלות לגבי ההסכמה שלהם.
- לוחצים על הבא.
- בקטע קהל, בוחרים באפשרות פנימי.
- לוחצים על הבא.
- בקטע פרטים ליצירת קשר, מזינים כתובת אימייל שאליה יישלחו התראות על שינויים בפרויקט.
- לוחצים על הבא.
- בקטע סיום, קוראים את המדיניות בנושא נתוני משתמשים בשירותי Google API. אם מסכימים, בוחרים באפשרות אני מסכים/ה למדיניות בנושא נתוני משתמשים בשירותי Google API.
- לוחצים על המשך.
- לוחצים על יצירה.
- בשלב הזה, אפשר לדלג על הוספת היקפי הרשאות. בעתיד, כשיוצרים אפליקציה לשימוש מחוץ לארגון ב-Google Workspace, צריך לשנות את סוג המשתמש לחיצוני. לאחר מכן מוסיפים את היקפי ההרשאה הנדרשים לאפליקציה. למידע נוסף, קראו את המדריך המלא בנושא הגדרת הסכמה ל-OAuth.
הגדרת הסקריפט
יצירת פרויקט Apps Script
- לוחצים על הלחצן הבא כדי לפתוח את הפרויקט שיתוף מאקרו ב-Apps Script.
פתיחת הפרויקט - לוחצים על סקירה כללית .
- בדף הסקירה הכללית, לוחצים על 'יצירת עותק'
.
מעתיקים את מספר הפרויקט ב-Cloud
- במסוף Google Cloud, נכנסים לתפריט > IAM & Admin > Settings.
- בשדה Project number, מעתיקים את הערך.
הגדרת הפרויקט ב-Cloud של פרויקט Apps Script
- בפרויקט Apps Script שהעתקתם, לוחצים על Project Settings (הגדרות הפרויקט)
.
- בקטע פרויקט Google Cloud Platform (GCP), לוחצים על שינוי פרויקט.
- בשדה GCP project number, מדביקים את מספר הפרויקט ב-Google Cloud.
- לוחצים על Set project.
התקנת פריסה לבדיקה
- בפרויקט Apps Script שהעתקתם, לוחצים על Editor (עריכה) .
- פותחים את הקובץ
UI.gs
ולוחצים על הפעלה. כשמוצגת בקשה, מאשרים את הסקריפט. - לוחצים על פריסה > בדיקת הפריסות.
- לוחצים על התקנה > סיום.
אחזור הסקריפט של המאקרו ומידע על הגיליון האלקטרוני
- פותחים גיליון אלקטרוני ב-Sheets שמכיל מאקרו ויש לכם הרשאה לערוך אותו. כדי להשתמש בגיליון אלקטרוני לדוגמה, יוצרים עותק של הגיליון האלקטרוני Sample macro.
- לוחצים על תוספים > Apps Script.
- בפרויקט Apps Script, לוחצים על Project settings (הגדרות הפרויקט)
.
- מתחת למזהה הסקריפט, לוחצים על העתקה.
- שומרים את מזהה הסקריפט לשימוש בשלב מאוחר יותר.
- פותחים או יוצרים גיליון אלקטרוני חדש שבו רוצים להוסיף את המאקרו. צריכה להיות לכם הרשאה לערוך את הגיליון האלקטרוני.
- מעתיקים את כתובת ה-URL של הגיליון האלקטרוני ומניחים אותה בצד לשימוש בשלב מאוחר יותר.
מריצים את הסקריפט
מוודאים שממשק ה-API של Google Apps Script מופעל בהגדרות של מרכז הבקרה. כדי להריץ את הסקריפט, פועלים לפי השלבים שמפורטים בקטעים הבאים.
העתקת המאקרו
- ב-Sheets, בסרגל הצד הימני, פותחים את התוסף Share Macro
.
- בקטע Source macro (מאקרו של מקור), מדביקים את מזהה הסקריפט.
- בקטע גיליון אלקטרוני יעד, מדביקים את כתובת ה-URL של הגיליון האלקטרוני.
- לוחצים על שיתוף המאקרו.
- לוחצים על אישור גישה ומאשרים את התוסף.
- חוזרים על שלבים 2 עד 4.
פתיחת המאקרו שהועתק
- אם הגיליון האלקטרוני שאליו העתקתם את המאקרו עדיין לא פתוח, פותחים אותו.
- לוחצים על תוספים > Apps Script.
- אם פרויקט Apps Script שהעתקתם לא מופיע, עליכם לוודא ש-Google Apps Script API מופעל בהגדרות של לוח הבקרה וחוזרים על השלבים שמפורטים בקטע העתקת המאקרו.
בדיקת הקוד
כדי לבדוק את הקוד של Apps Script לפתרון הזה, לוחצים על הצגת קוד המקור בהמשך:
הצגת קוד המקור
Code.gs
UI.gs
appsscript.json
תורמים
Google שומרת על הדוגמה הזו בעזרת מומחי הפיתוח של Google.