‫Sheets – משימת אחזור באצווה

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

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

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

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

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

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

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

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

  3. הסבר על המונחים הנפוצים שמשמשים ב-Google Sheets.

הגדרת המשימה Sheets - Batch Get

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

    מעבר אל Application Integration

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

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

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

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

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

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

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

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

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

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

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

{
        "spreadsheetId": SPREADSHEET_ID,
        "valueRanges": [
          {
            "range": "Sheet1!B1:B1000",
            "majorDimension": "COLUMNS",
            "values": [
              ["Cost",20.5,15,100,135.5]
            ]
          },
          {
            "range": "Sheet1!D1:D1000",
            "majorDimension": "COLUMNS",
            "values": [
              ["Ship Date",42430,42444,42449,42449]
            ]
          }
        ]
      }

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

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

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

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

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