ב-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, כי הבעלים שלו כבר לא בארגון שלכם. זה חשוב במיוחד לתוספים.
שיתוף פעולה וטריגרים
כשאתם משתפים פעולה בפרויקט, טריגרים שניתנים להתקנה שאתם יוצרים לא משותפים עם האנשים שיש להם גישה לפרויקט. אם אתם צריכים הגדרת טריגר עקבית לכל שותפי העריכה, תוכלו להשתמש בשירות הסקריפט כדי ליצור טריגרים באופן פרוגרמטי בזמן הריצה. למידע נוסף קראו את המאמר ניהול טריגרים באופן פרוגרמטי.
שיתופי פעולה וספריות
הספריות שכלולות בפרויקט זמינות לשותפי העריכה בפרויקט. עם זאת, אם אין להם גישה ברמת הקריאה לפחות לספרייה כלולה, הם לא יוכלו להשתמש בספריות האלה – במקרה הזה הסקריפט יגרום לשגיאה. מידע נוסף על ספריות זמין במאמר ניהול ספריות.
שיתוף פעולה ומאפייני משתמשים
מאפייני משתמש הם ייחודיים למשתמש שיצר אותם. המשמעות היא ששותפי העריכה בפרויקט לא יכולים לראות את מאפייני המשתמש שלכם או לגשת אליהם, ואי אפשר לראות את מאפייני המשתמשים או לגשת אליהם. כדאי להשתמש במאפייני סקריפט כדי לשתף עם שותפי העריכה מאפיינים ספציפיים לפרויקט. למידע נוסף, עיינו במדריך המאפיינים.