רמת תכנות: ביניים
משך: 30 דקות
סוג הפרויקט: תוסף ל-Google Workspace
מטרות
- הבנה מה הפתרון עושה.
- להבין מה שירותי Apps Script עושים במסגרת הפתרון.
- הגדרת הסביבה.
- מגדירים את הסקריפט.
- מריצים את הסקריפט.
מידע על הפתרון הזה
העתקה ידנית של פקודות מאקרו ב-Google Sheets מגיליון אלקטרוני אחד לאחר יכולה להימשך זמן רב ועשויה לגרום לשגיאות. התוסף של Google Workspace מעתיק באופן אוטומטי פרויקט סקריפט ומצרפים אותו לגיליון אלקטרוני שהוגדר על ידי המשתמש. למרות שהפתרון הזה מתמקד בפקודות מאקרו של Sheets, אפשר להשתמש בו כדי להעתיק ולשתף כל סקריפט שמוגבל לקונטיינר.
איך זה עובד
הסקריפט מעתיק את פרויקט Apps Script שמצורף לגיליון האלקטרוני המקורי ויוצר פרויקט Apps Script כפול שמצורף לגיליון האלקטרוני שצוין על ידי המשתמש.
שירותי Apps Script
הפתרון הזה משתמש בשירותים הבאים:
- השירות לאחזור כתובות URL – מתחבר ל-Apps Script API כדי להעתיק את פרויקט המקור וליצור עותק.
- שירות סקריפט – נותן הרשאה ל-Apps Script API כדי להימנע מהצגת בקשה להרשאה שנייה.
- שירות גיליונות אלקטרוניים – פתיחת הגיליון האלקטרוני המיועד להוספת פרויקט Apps Script שהועתק.
- שירות כרטיסים – יצירת ממשק המשתמש של התוסף.
דרישות מוקדמות
כדי להשתמש בדוגמה הזו, נדרשות הדרישות המוקדמות הבאות:
- חשבון Google (יכול להיות שיהיה צורך באישור אדמין).
דפדפן אינטרנט עם גישה לאינטרנט.
צריך להפעיל את Google Apps Script API בהגדרות של מרכז השליטה של Apps Script.
הגדרת הסביבה
פתיחת הפרויקט ב-Cloud במסוף Google Cloud
אם הוא לא פתוח, פותחים את הפרויקט ב-Cloud שבו אתם מתכוונים להשתמש בדוגמה הזו:
- נכנסים לדף Select a project במסוף Google Cloud.
- בוחרים את הפרויקט ב-Google Cloud שבו רוצים להשתמש. לחלופין, לוחצים על יצירת פרויקט ופועלים לפי ההוראות שבמסך. אם אתם יוצרים פרויקט ב-Google Cloud, ייתכן שאתם צריכים להפעיל את החיוב בפרויקט.
הפעלה של Google Apps Script API
המדריך למתחילים משתמש ב-Google Apps Script API.
כדי להשתמש ב-Google APIs, צריך להפעיל אותם בפרויקט ב-Google Cloud. אפשר להפעיל ממשק API אחד או יותר בפרויקט אחד ב-Google Cloud.צריך להפעיל את Google Apps Script API בפרויקט בענן.
הגדרת מסך ההסכמה של OAuth
לתוספים ל-Google Workspace נדרשת הגדרה של מסך הסכמה. הגדרה של מסך ההסכמה ל-OAuth של התוסף מגדירה מה Google מציגה למשתמשים.
- במסוף Google Cloud, נכנסים לתפריט > APIs & Services > מסך ההסכמה של OAuth.
- בהגדרה סוג משתמש, בוחרים באפשרות פנימי ולוחצים על יצירה.
- ממלאים את טופס ההרשמה לאפליקציה ולוחצים על שמירה והמשך.
בינתיים, אפשר לדלג על הוספת היקפים וללחוץ על שמירה והמשך. בעתיד, כשיוצרים אפליקציה לשימוש מחוץ לארגון ב-Google Workspace, צריך לשנות את סוג המשתמש לחיצוני ואז להוסיף את היקפי ההרשאות שנדרשים לאפליקציה.
- לבדוק את הסיכום של רישום האפליקציה. כדי לבצע שינויים, לוחצים על עריכה. אם הרישום של האפליקציה נראה בסדר, לוחצים על Back to Dashboard (חזרה למרכז השליטה).
הגדרת הסקריפט
יצירת פרויקט Apps Script
- לוחצים על הלחצן הבא כדי לפתוח את פרויקט שיתוף של רכיב מאקרו ב-Apps Script.
פתיחת הפרויקט - לוחצים על סקירה כללית .
- בדף הסקירה הכללית, לוחצים על 'יצירת עותק' .
העתקת מספר הפרויקט ב-Cloud
- במסוף Google Cloud, נכנסים לתפריט > IAM & Admin > הגדרות.
- מעתיקים את הערך בשדה Project number.
הגדרת הפרויקט בענן של פרויקט Apps Script
- בפרויקט Apps Script שהעתקתם, לוחצים על Project Settings (הגדרות הפרויקט) .
- בקטע פרויקט Google Cloud Platform (GCP), לוחצים על שינוי פרויקט.
- בקטע מספר פרויקט GCP, מדביקים את מספר הפרויקט ב-Google Cloud.
- לוחצים על Set project.
התקנה של פריסת בדיקה
- בפרויקט Apps Script שהעתקתם, לוחצים על עריכה .
- פותחים את הקובץ
UI.gs
ולוחצים על הפעלה. כשמתבקשים, מאשרים את הסקריפט. - לוחצים על פריסה > בדיקת פריסות.
- לוחצים על התקנה > סיום.
קבל את סקריפט המאקרו ומידע על הגיליון האלקטרוני
- פותחים גיליון אלקטרוני ב-Sheets שמכיל מאקרו ושיש לכם הרשאת עריכה. כדי להשתמש בגיליון אלקטרוני לדוגמה, יוצרים עותק של הגיליון האלקטרוני מאקרו לדוגמה.
- לוחצים על תוספים > Apps Script.
- בפרויקט Apps Script, לוחצים על Project settings .
- מתחת למזהה הסקריפט, לוחצים על העתקה.
- שומרים את מזהה הסקריפט בצד לשימוש בשלב מאוחר יותר.
- פותחים או יוצרים גיליון אלקטרוני חדש שאליו רוצים להוסיף את המאקרו. צריכה להיות לכם הרשאה לערוך את הגיליון האלקטרוני.
- מעתיקים את כתובת ה-URL של הגיליון האלקטרוני ושומרים אותה לשימוש בשלב מאוחר יותר.
מריצים את הסקריפט
צריך לוודא ש-Google Apps Script API מופעל בהגדרות של מרכז הבקרה. כדי להריץ את הסקריפט, צריך לבצע את השלבים שמפורטים בקטעים הבאים.
העתקת המאקרו
- בסרגל הצד השמאלי ב-Sheets, פותחים את התוסף 'שיתוף מאקרו' .
- בקטע מאקרו מקור, מדביקים את מזהה הסקריפט.
- בקטע גיליון אלקטרוני יעד, מדביקים את כתובת ה-URL של הגיליון האלקטרוני.
- לוחצים על שיתוף רכיב מאקרו.
- לוחצים על אישור גישה ומאשרים את התוסף.
- חוזרים על שלבים 2-4.
פתיחת רכיב המאקרו שהועתק
- אם המאקרו עדיין לא פתוח, פותחים את הגיליון האלקטרוני שאליו העתקתם את המאקרו.
- לוחצים על תוספים > Apps Script.
- אם פרויקט Apps Script לא מופיע, צריך לוודא ש-Google Apps Script API מופעל בהגדרות של מרכז הבקרה ולחזור על השלבים שמפורטים בקטע העתקת המאקרו.
בדיקת הקוד
כדי לבדוק את קוד Apps Script של הפתרון הזה, לוחצים על הצגת קוד המקור למטה:
הצגת קוד המקור
Code.gs
UI.gs
appsscript.json
תורמים
הדוגמה הזו מנוהלת על ידי Google בעזרת מומחי המפתחים של Google.