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