הפעלת הרשאת גישה לסקריפט וגישה אליו

ממשק Google Apps Script API דורש סוגים שונים של הרשאות, בהתאם למטרה שלכם:

• שימוש ב-Apps Script API באפליקציה.
• מאפשרת לאפליקציות אחרות לנהל את הנתונים או את הפריסות של פרויקט הסקריפט.

כדי להשתמש ב-Apps Script API באפליקציה, צריך להפעיל את ה-API בפרויקט Google Cloud של האפליקציה. כך תוכלו ליצור פרטי כניסה ל-OAuth כדי שמשתמשים באפליקציה יוכלו לתת לה הרשאה.

כדי לאפשר לאפליקציות של צד שלישי לנהל את התוכן או את הפריסה של פרויקטים של סקריפטים, צריך לתת להן גישה לפרויקטים האלה.

שימוש ב-Apps Script API באפליקציה

כדי להשתמש ב-Apps Script API בתוך האפליקציה, צריך להפעיל את Apps Script API בפרויקט בענן של Google של האפליקציה. אחרי שמפעילים את Apps Script API, אפשר ליצור פרטי כניסה ל-OAuth ולהוריד את מזהה הלקוח ואת הסוד כדי לכלול אותם באפליקציה. אפשר גם לעקוב אחרי השימוש ב-API במסוף Google Cloud.

אפשר להשתמש באשף להפעלת API כדי ליצור או לבחור פרויקט בענן ב-Google Cloud במסוף Google Cloud ולהפעיל את ה-API באופן אוטומטי. אפשרות אחרת היא לפתוח את הדף Manage Resources במסוף, לבחור פרויקט, ואז לחפש את Apps Script API ולהוסיף אותו באופן ידני באמצעות לוח הבקרה APIs & services של הפרויקט. אחרי שמפעילים את ה-API, אפשר ליצור פרטי כניסה ל-OAuth, מזהי לקוח וסודות לקוח לאפליקציות בחלונית APIs & services > Credentials.

במדריכים למתחילים בנושא Apps Script API מוסבר שלב אחר שלב איך להפעיל את ה-API ולהגדיר הרשאה לאפליקציה.

איך מעניקים לאפליקציות צד שלישי גישה לפרויקטים של סקריפטים

‫Apps Script API יכול לאפשר לאפליקציות ליצור ולשנות את הסקריפטים שלכם ואת הפריסות שלהם. זה עלול להוביל למצב לא טוב אם תאשרו אפליקציית צד שלישי זדונית, שתמשיך ליצור סקריפטים זדוניים נוספים או לשנות את ההתנהגות של סקריפטים שכבר יש לכם.

כדי להפחית את הסיכון הזה, כברירת מחדל, ל-Apps Script API אין גישה לפרויקטים של סקריפטים. צריך להעניק גישה ל-API באופן מפורש כדי להשתמש בכל אפליקציה שיוצרת או משנה סקריפטים או פריסות. אחרי שתעניקו גישת API לסקריפטים שלכם, אפליקציות שתאשרו יוכלו להשתמש ב-API כדי לנהל את פרויקטי הסקריפטים שלכם.

אם מנסים להפעיל אפליקציה מושפעת בלי להעניק קודם גישה ל-API, מתקבלת שגיאה. השגיאה הזו מתרחשת אחרי שמאשרים את הגישה לאפליקציה.

אפשר להעניק ל-Apps Script API גישה לפרויקטים של סקריפטים באמצעות מרכז הבקרה של Apps Script. אפשר גם להשתמש בלוח הבקרה כדי לבטל את הגישה הזו בכל שלב. כשאתם מעניקים גישה ל-API, אתם עושים זאת לכל האפליקציות. עם זאת, עדיין צריך לאשר אפליקציות ספציפיות.

לפני שמעניקים גישה, חשוב להבין את הסיכון הכרוך בהרשאת אפליקציות לשנות את הסקריפטים. אל תאשרו אף אפליקציה שאתם חושדים שהיא זדונית.