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

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

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

אם אתם צריכים להשתמש ב-Apps Script API באפליקציה, עליכם enable את ה-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 והגדרת הרשאות לאפליקציה.

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

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

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

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

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

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

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