Google Apps Script מספק תכונות שעוזרות לצוותים לבנות ולתחזק סקריפטים, תוספים ל-Google Workspace ואפליקציות אינטרנט ביחד. המדריך הזה עוסק בשיתוף פעולה פעיל בפרויקט על ידי כמה מפתחים. אם אתם רוצים לשתף קוד כדי שאחרים יוכלו לכלול אותו בפרויקטים שלהם, כדאי לעיין במדריך בנושא ספריות.
מידע בסיסי על שיתוף פעולה
כדי לשתף פעולה בפרויקט, לכם ולמשתפי הפעולה שלכם צריכה להיות גישת עריכה לקובץ הפרויקט ב-Apps Script (ולקונטיינר שלו, אם מדובר בסקריפט שקשור למסמך). כך כל חברי הצוות יוכלו לראות את קוד Apps Script ולבצע בו שינויים. משתמשים עם הרשאת עריכה יכולים גם ליצור גרסאות קוד חדשות, לפרסם תוספים ולפרוס סקריפטים כאפליקציות אינטרנט או כקבצים הפעלה עבור Apps Script API.
כדאי לתכנן מראש איך תערכו, תבדקו, תנהלו גרסאות ו (אם רלוונטי) תפרסמו את הפרויקט, התוסף או אפליקציית האינטרנט שלכם. פרויקטים עצמאיים הם בדרך כלל הכי קלים לשיתוף פעולה, כי הם מופיעים ישירות ב-Google Drive והם סוג הפרויקט המומלץ לפיתוח תוספים ואפליקציות אינטרנט.
בעיה נפוצה בשיתוף פעולה מתרחשת כשבעלי פרויקט סקריפט עוזבים את הצוות בלי להעביר את הבעלות על הפרויקט למישהו אחר בצוות. יכול להיות שלא תוכלו לתחזק או לעדכן את הפרויקט. כדי למנוע את הבעיה הזו, כדאי לשמור את פרויקט הסקריפט באחסון שיתופי, כי לקבצים באחסון שיתופי אין בעלים ספציפיים.
תמיד לשתף את הבעלות על פרויקטים של סקריפטים. אם מישהו עוזב את הארגון והחשבון שלו מוסר, הגישה לסקריפטים ללא בעלים אחרים אובדת. משתפים את הסקריפט ב-Drive או מעבירים אותו לאחסון שיתופי.
איך משתמשים בכלי שורת הפקודה clasp
clasp מאפשר לסנכרן פרויקטים בין script.google.com לבין מערכת הקבצים המקומית. כך תוכלו לייעל את פיתוח הקוד ולאוטומט אותו אם אתם ושותפי העריכה שלכם משתמשים בתוכנה לניהול בקרת מקורות כמו git.
לפרטים נוספים, אפשר לעיין במדריך בנושא ממשק שורת פקודה באמצעות clasp.
שיתוף פעולה עם תיקיות אחסון שיתופי
תיקיות משותפות זמינות רק ללקוחות Google Workspace Business ו-Google Workspace Enterprise.
תיקיות אחסון שיתופי מספקות מרחב משותף ב-Drive שבו קבוצות של משתמשי Drive יכולות לשתף פעולה בצורה יעילה יותר. הקבצים שמוסיפים לאחסון השיתופי שייכים לקבוצה כולה, ולא לאנשים פרטיים. כלומר, כשמשתף פעולה עוזב את הקבוצה, הוא לא לוקח איתו את הבעלות על הקובץ ואת השליטה בו.
בנוסף, תיקיות אחסון שיתופי מאפשרות להעביר קבצים בין דומיינים – בתיקיית אחסון שיתופי בדומיין אחד יכולים להיות שותפי עריכה מדומיין אחר, שיכולים להעביר קבצים מהדומיין הזה לתיקיית האחסון השיתופי. האפשרות הזו מאפשרת לצוות לפתח תוספים, אפליקציות אינטרנט או קוד אחר ללקוחות בדומיינים שונים.
כשמשתמשים באחסון שיתופי כדי לשתף פעולה בפרויקטים של Apps Script:
- משתפי פעולה עם גישת עריכה לאחסון השיתופי יכולים ליצור קבצים חדשים באחסון השיתופי או להעביר אליו קבצים. בתור עורכי סקריפטים, הם יכולים להציג ולערוך פרויקטים של סקריפטים, להריץ קוד של סקריפטים, ליצור גרסאות חדשות של סקריפטים ולפרסם תוספים.
- כדי לפרוס סקריפטים כאפליקציות אינטרנט או כקבצים הפעלה עבור Apps Script API, החשבון שיוצר את הפריסה צריך להיות שייך לאותו דומיין כמו הכונן השיתופי שבו נמצא הסקריפט.
- תיקיות אחסון שיתופי מאפשרות לכם לשתף קבצים ספציפיים בתיקיית האחסון השיתופי עם אנשים מחוץ לקבוצה, ולעדכן את הרשאות העריכה והצפייה שלהם בקבצים האלה כמו בכל קובץ אחר ב-Drive. עם זאת, אם משתמש הוא חלק מהצוות שאליו שייך האחסון השיתופי, אי אפשר לצמצם את הגישה שלו לקבצים ספציפיים. לדוגמה, אם למשתמש יש גישת עריכה באחסון שיתופי, אי אפשר לשנות את ההרשאה הזו לגישה לצפייה בלבד בקובץ ספציפי באחסון השיתופי.
- משתמשים שיש להם גישה מלאה לאחסון השיתופי יכולים גם למחוק קבצים ופרויקטים של Apps Script, ולהעביר קבצים מחוץ לאחסון השיתופי.
- כל הסקריפטים שקשורים למאגר התגים משתמשים באותן רשימות של גישת צפייה וגישת עריכה שהוגדרו לקובץ מאגר התגים. לדוגמה, אם יש לכם גישת עריכה לגיליון אלקטרוני ב-Google Sheets, יש לכם גם גישת עריכה לכל קוד של פרויקט Apps Script שמצורף אליו. אם מציבים קובץ מאגר כזה באחסון שיתופי, משתפי הפעולה באחסון השיתופי מקבלים את אותה גישה לקוד הסקריפט כמו הגישה שיש להם למאגר עצמו.
- כשפרויקט סקריפט נמצא בתיקייה משותפת, יכול להיות שהגישה לפרויקט Google Cloud שלו תהיה מוגבלת. פרטים נוספים זמינים בקטע פרויקטים ב-Google Cloud ותיקיות אחסון שיתופי במדריך.
- אפליקציות אינטרנט שנפרסו בדומיין אחד מפסיקות לפעול אם הבעלות עליהן משתנה לאחסון שיתופי או לחשבון בדומיין אחר. כדי לתקן את זה, צריך להעביר את הסקריפט בחזרה לדומיין המקורי שלו.
- באופן דומה, פרויקטים של סקריפטים שנפרסו כקובץ הפעלה של Apps Script API מפסיקים לפעול כשקוראים להם דרך ה-API אם הם מועברים דרך אחסון שיתופי מדומיין אחד לדומיין אחר. כדי לתקן את זה, צריך להעביר את הסקריפט בחזרה לדומיין המקורי.
שיתוף פעולה בתיקייה משותפת
חשוב לפעול בזהירות כשיוצרים פרויקט Apps Script או מעבירים אותו לתיקייה משותפת. חשוב לוודא שהתיקייה משותפת רק עם אנשים שסומכים עליהם.
אם אתם לא יכולים לשתף פעולה באחסון שיתופי, אתם יכולים להשתמש בתיקייה משותפת. כשיוצרים פרויקט Apps Script או מעבירים אותו לתיקייה ב-Drive שאנשים אחרים יכולים לגשת אליה, הם מקבלים את אותה גישה לפרויקט Apps Script שיש להם לתיקייה. לדוגמה:
- אם למישהו יש גישת עריכה לתיקייה, הוא יכול לערוך או למחוק את פרויקט Apps Script ולהריץ את הסקריפט.
- אם למישהו יש רק גישת צפייה לתיקייה, הוא יכול לראות את פרויקט Apps Script ולהריץ את הסקריפט.
שיתוף פעולה באמצעות שיתוף פרויקטים
שיתוף ישיר של הפרויקט עם כל המשתתפים כדי לעבוד יחד על הפרויקט. לשתף ישירות פרויקטים של סקריפטים שנמצאים בתיקיות רגילות ב-Drive או בתיקיות אחסון שיתופי. חשוב לתכנן בקפידה מי יהיה הבעלים של הסקריפט ומי יתחזק אותו לאורך זמן.
פרויקטים עצמאיים מופיעים ב-Drive כקובץ, ואפשר לשתף אותם כמו כל קובץ אחר. מידע נוסף זמין במאמר בנושא שיתוף קבצים ותיקיות.
פרויקטים שקשורים למאגר לא מוצגים ב-Drive. כדי לשתף פרויקט שקשור למאגר, משתפים את קובץ המאגר הראשי. לדוגמה, אם יש לכם סקריפט שמקושר לגיליון אלקטרוני ב-Google Sheets, אתם יכולים להגדיר מישהו כעורך של הסקריפט על ידי הגדרתו כעורך של הגיליון האלקטרוני. פרויקטים שקשורים למאגר מקבלים בירושה את הגדרות הגישה לצפייה ולעריכה של קובץ המאגר.
לכל הסקריפטים שקשורים למאגר התגים יש את אותה רשימת גישה של בעלים, צופים ועורכים שהוגדרה לקובץ מאגר התגים. בעלי מאגר התגים מקבלים בעלות על פרויקט סקריפט חדש, לא משנה מי יצר אותו.
שיתוף פעולה ומשאבי פרויקט
משאבים הם ישויות שמשויכות לפרויקט, אבל קיימות באופן עצמאי מהקוד שלו. בקטע הזה מוסבר איך שיתוף פעולה בפרויקט משפיע על המשאבים שלו, ובמיוחד על פרויקט Google Cloud, על הטריגרים, על הספריות ועל מאפייני המשתמש.
שיתוף פעולה ופרויקטים ב-Google Cloud
לכל פרויקט ב-Apps Script יש פרויקט בענן ב-Google Cloud שמשויך אליו. לפרויקטים ב-Google Cloud יש קבוצה משלהם של בעלים, עורכים ותפקידים אחרים, שיכולה להיות שונה מקבוצת המשתמשים שיכולים לגשת לפרויקט הסקריפט.
שיתוף פעולה וטריגרים
כשמשתפים פעולה בפרויקט, טריגרים שאפשר להתקין שיוצרים לא משותפים עם מי שיש לו גישה לפרויקט. אם אתם צריכים להגדיר טריגרים באופן עקבי לכל שותפי העריכה, אתם יכולים להשתמש בשירות Script כדי ליצור טריגרים באופן פרוגרמטי בזמן הריצה. מידע נוסף זמין במאמר בנושא ניהול טריגרים באופן פרוגרמטי.
טריגרים פשוטים נוצרים מקוד, ולכן הם משותפים עם משתפי הפעולה בפרויקט.
שיתוף פעולה וספריות
הספריות שכלולות בפרויקט זמינות לשותפי העריכה של הפרויקט. עם זאת, אם אין להם גישה ברמת קריאה לפחות לספרייה כלשהי, הם לא יכולים להשתמש בספריות האלה – במקרה כזה הסקריפט יציג שגיאה. מידע נוסף על ספריות זמין במאמר בנושא ניהול ספריות.
שיתוף פעולה ומאפייני משתמש
מאפייני משתמש ייחודיים למשתמש שיצר אותם. כלומר, משתפי הפעולה בפרויקט לא יכולים לראות את מאפייני המשתמשים שלכם או לגשת אליהם, ואתם לא יכולים לראות את מאפייני המשתמשים שלהם או לגשת אליהם. כדאי להשתמש במאפייני סקריפט אם רוצים לשתף מאפיינים ספציפיים לפרויקט עם משתפי פעולה. מידע נוסף זמין במדריך המאפיינים.