‫Sheets – הוספת משימה

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

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

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

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

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

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

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

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

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

הגדרת המשימה Sheets – Append (צירוף)

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

    מעבר אל Application Integration

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

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

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

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

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

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

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

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

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

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

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

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

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

טווח String הסימון A1 של טווח לחיפוש הטבלה הרצויה בגיליון.
IncludeValuesInResponse בוליאני מציין אם האובייקט שמוחזר צריך לכלול את הערכים של התאים שנוספו להם ערכים.
InsertDataOption enum (InsertDataOption) מציין איך הנתונים הקיימים ישתנו כשהנתונים החדשים יצורפו.
ValueInputOption enum (ValueInputOption) מציין איך הנתונים מפורשים.

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

ResponseDateTimeRenderOption enum (DateTimeRenderOption) מציין איך ערכים שקשורים לתאריך, לשעה ולמשך מוצגים בפלט.

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

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

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

בקשה JSON גוף הבקשה הוא אובייקט ValueRange שמתאר את ערכי הטווח לכתיבה. ראו מבנה JSON של בקשה.

פלט המשימה

המשימה Sheets - Append מחזירה את פלט התגובה שמכיל אובייקט AppendValuesResponse, בדומה לפלט לדוגמה הבא:

    {
        "spreadsheetId": SPREADSHEET_ID,
        "tableRange": "Sheet1!A1:D2",
        "updates": {
          "spreadsheetId": SPREADSHEET_ID,
          "updatedRange": "Sheet1!A3:D4",
          "updatedRows": 2,
          "updatedColumns": 4,
          "updatedCells": 8,
        }
      }

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

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

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

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

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