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

ה-Apps Script API דורש סוגים שונים של הרשאות, בהתאם ליעד שלכם:

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

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

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

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

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

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

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

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

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

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

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

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

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

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