‫Sheets – קבלת משימה

המשימה Sheets - Get מאפשרת לקרוא ולאחזר טווח יחיד של ערכים מגיליון אלקטרוני ב-Google.

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

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

לפני שמגדירים את המשימה Sheets - Get, צריך לבצע את המשימות הבאות בפרויקט ב-Google Cloud:

  1. מפעילים את Google Sheets API ‏ (sheets.googleapis.com).

    מפעילים את Google Sheets API

  2. יוצרים פרופיל אימות מסוג חשבון שירות. Application Integration משתמשת בפרופיל אימות (חשבון שירות) כדי להתחבר לנקודת קצה של אימות למשימה Sheets - Get.

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

  3. ב-Google Sheets, מעניקים לחשבון השירות הרשאה לגשת לגיליון האלקטרוני.
  4. הסבר על המונחים הנפוצים שמשמשים ב-Google Sheets.

הגדרה של Sheets – קבלת משימה

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

    מעבר אל Application Integration

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

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

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

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

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

  4. בסרגל הניווט של כלי העריכה של השילוב, לוחצים על משימות כדי לראות את רשימת המשימות והמחברים הזמינים.
  5. לוחצים על הרכיב Sheets - Get (גיליונות אלקטרוניים – אחזור) וגוררים אותו לתוך כלי העריכה של השילוב.
  6. לוחצים על הרכיב Sheets - Get (Sheets – קבלת נתונים) בכלי העיצוב כדי להציג את חלונית הגדרת המשימה Sheets - Get.
  7. עוברים אל אימות ובוחרים פרופיל אימות קיים שרוצים להשתמש בו.

    זה שינוי אופציונלי. אם לא יצרתם פרופיל אימות לפני הגדרת המשימה, לוחצים על + פרופיל אימות חדש ופועלים לפי השלבים שמפורטים במאמר יצירת פרופיל אימות חדש.

  8. עוברים אל Task Input (קלט משימה) ומגדירים את שדות הקלט שמוצגים באמצעות הטבלה הבאה של Task input parameters (פרמטרים של קלט משימה).

    השינויים בשדות הקלט נשמרים אוטומטית.

פרמטרים של קלט למשימה

בטבלה הבאה מפורטים פרמטרי הקלט של המשימה Sheets - Get:

מאפיין (property) סוג נתונים תיאור
SpreadsheetId String המזהה של הגיליון האלקטרוני.

המזהה של הגיליון האלקטרוני מופיע בכתובת ה-URL שלו באינטרנט. לדוגמה, https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0

MajorDimension enum (מאפיין) הקטגוריה הראשית או המאפיין שצריך להחיל. לדוגמה, ROWS או COLUMNS.

ערך ברירת המחדל: DIMENSION_UNSPECIFIED

טווח String הסימון A1 או הסימון R1C1 של הטווח שממנו יאוחזרו הערכים.
dateTimeRenderOption enum (DateTimeRenderOption) מציין איך ערכים שקשורים לתאריך, לשעה ולמשך מוצגים בפלט.

ערך ברירת המחדל: SERIAL_NUMBER

ValueRenderOption enum (ValueRenderOption) מציין איך הערכים שאוחזרו מיוצגים בפלט.

ערך ברירת המחדל: FORMATTED_VALUE

פלט המשימה

המשימה Sheets - Get מחזירה את פלט התגובה שמכיל אובייקט ValueRange שמתאים לטווח המבוקש. דוגמה לפלט:

    {
        "range": "Sheet1!A1:D5",
        "majorDimension": "ROWS",
        "values": [
          ["Item", "Cost", "Stocked", "Ship Date"],
          ["Wheel", "$20.50", "4", "42430"],
          ["Door", "$15", "2", "42444"],
          ["Engine", "$100", "1", "42449"],
          ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
        ],
      }

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

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

מכסות ומגבלות

מידע על מכסות ומגבלות זמין במאמר מכסות ומגבלות.

המאמרים הבאים