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