משימת Apps Script

המשימה Apps Script מאפשרת להריץ Google Apps Script מהשילוב. ‫Google Apps Script היא פלטפורמה מהירה לפיתוח אפליקציות שאפשר ליצור בה אפליקציות עסקיות במהירות ובקלות. מידע נוסף זמין במאמר בנושא Google Apps Script. המשימה הזו שימושית כשרוצים להריץ סקריפטים בהתאמה אישית או לעשות שימוש חוזר בסקריפטים קיימים בשילוב.

לפני שמתחילים

לפני שמשתמשים במשימת Apps Script, צריך לבצע את השלבים הבאים:

הפעלת Apps Script API

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

יצירת מזהה לקוח ב-OAuth 2.0

אם יש לכם מזהה לקוח OAuth 2.0, אתם יכולים לדלג על השלב הזה ולעבור אל הגדרת פרופיל אימות.

מידע על יצירת מזהה לקוח OAuth חדש זמין במאמר יצירת מזהה לקוח OAuth.

הגדרת פרופיל אימות

הכלי Application Integration משתמש בפרופיל האימות כדי להתחבר ל-Google Cloud לצורך פריסה והרצה של פרויקט Apps Script. כדי להגדיר פרופיל אימות:

הוספת משימה של Apps Script

  1. נכנסים לדף Application Integration במסוף Google Cloud .

    מעבר אל Application Integration

  2. בתפריט הניווט, לוחצים על Integrations (שילובים).

    מוצג הדף Integrations (שילובים) עם רשימה של כל השילובים שזמינים בפרויקט בענן של Google.

  3. בוחרים שילוב קיים או לוחצים על יצירת שילוב כדי ליצור שילוב חדש.

    אם יוצרים שילוב חדש:

    1. מזינים שם ותיאור בחלונית יצירת שילוב.
    2. בוחרים אזור לשילוב.
    3. בוחרים חשבון שירות לאינטגרציה. אפשר לשנות או לעדכן את פרטי חשבון השירות של שילוב בכל שלב מחלונית סיכום השילוב בסרגל הכלים של השילוב.
    4. לוחצים על יצירה. השילוב החדש שנוצר ייפתח בכלי השילובים.

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

יצירת פרופיל אימות

  1. לוחצים על הרכיב Apps Script (סקריפט של Apps) בכלי העיצוב כדי להציג את חלונית הגדרת המשימות של Apps Script.
  2. בחלונית הגדרת המשימה של Apps Script, לוחצים על + פרופיל אימות חדש.
  3. בתיבת הדו-שיח פרופיל אימות, מזינים שם ותיאור לפרופיל ומגדירים את המאפיינים הבאים:
    • סוג האימות: בוחרים באפשרות קוד הרשאה OAuth 2.0.
    • נקודת קצה לאימות: מזינים https://accounts.google.com/o/oauth2/auth
    • נקודת הקצה של הטוקן: מזינים https://oauth2.googleapis.com/token
    • מזהה לקוח: מזינים את מזהה הלקוח.

      מזהה הלקוח זמין בלוח הבקרה של הפרויקט בענן ב-Google Cloud בקטע Credentials > OAuth 2.0 Client IDs (פרטי כניסה > מזהי לקוח OAuth 2.0).

    • ‫Secret: מזינים את סוד הלקוח

      סוד הלקוח זמין בלוח הבקרה של פרויקט בענן ב-Google Cloud בקטע Credentials > OAuth 2.0 Client IDs.

    • היקפים: מזינים את הערכים הבאים:

      https://www.googleapis.com/auth/script.projects https://www.googleapis.com/auth/script.deployments https://www.googleapis.com/auth/script.deployments.readonly https://www.googleapis.com/auth/drive.scripts https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/script.external_request https://www.googleapis.com/auth/userinfo.email

      הערה: אפשר להפריד בין כמה היקפי הרשאות באמצעות רווח אחד (" ").

  4. לוחצים על יצירת אסימון גישה ושמירה.

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

הגדרת המשימה של Apps Script

כדי להגדיר פרויקט של Apps Script במשימה Apps Script, מבצעים את השלבים הבאים:

  1. בחלונית הגדרת המשימה, לוחצים על Configure Apps Script Project (הגדרת פרויקט Apps Script).

    מופיעה תיבת הדו-שיח Apps Script Configuration (הגדרות של Apps Script).

  2. אפשר לקשר לפרויקט קיים של Apps Script או ליצור פרויקט חדש של Apps Script.

    הגדרת פרויקט Apps Script משייכת את פרויקט Apps Script לשילוב שלכם ב-Application Integration.

  3. לוחצים על 'שמירה'.
  4. לוחצים על פתיחת פרויקט Apps Script.

    ב-Apps Script Editor, אפשר לראות את הקבצים הבאים:

    • ‫Run.gs: מכיל את קוד ההפעלה. כותבים את הסקריפט בתוך הפונקציה run. הפונקציה הזו מופעלת כשמשימת Apps Script מורצת. בסקריפט, אפשר להשתמש במשתנים שהוגדרו ברמת השילוב. מידע על השימוש במשתני האינטגרציה זמין במאמר שימוש במשתני אינטגרציה.
    • ‫Main.gs: מכיל את קוד האתחול להפעלת Apps Script מהשילוב. אין לערוך או לשנות את הקובץ הזה.
    • ‫Test.gs: מכיל את קוד ההפעלה להרצת בדיקות. אפשר לכתוב את התסריט בתוך הפונקציה testRun כדי לבדוק את התסריט.

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

גישה למשתני שילוב

משימת Apps Script משתמשת בספרייה AppsScriptTask, שמאפשרת לכם להשתמש במשתני שילוב בסקריפט. הספרייה AppsScriptTask מיובאת אוטומטית וזמינה לשימוש בפונקציה run.

כדי לגשת למשתנה שילוב ב-Apps Script, צריך להעביר את המשתנה בצורה של פרמטרים של משימה למשימת Apps Script. פרמטרי המשימה הם צמדי מפתח-ערך, שבהם Key הוא שם המשתנה במשימת AppsScript ו-Value הוא שם משתנה השילוב התואם. אפשר להוסיף פרמטר אחד או יותר של משימה בקטע Task Parameters (פרמטרים של משימה) בחלונית ההגדרות של המשימה.

לדוגמה, אם יש לכם משתנה שילוב בשם Product שבו אתם רוצים להשתמש ב-Apps Script, אתם יכולים להגדיר את Key כ-ProductKey ואת הערך כ-Product. ב-Apps Script, אפשר להשתמש ב-AppsScriptTask.getTaskParameter('ProductKey') כדי לקרוא את המשתנה Product.

ספריית AppsScriptTask מספקת את השיטות הבאות לגישה למשתני שילוב:

שם הפונקציה תיאור Usage

setIntegrationVariable