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