טבלאות

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

מהי טבלה?

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

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

אתם יכולים להשתמש בטבלאות למשימות כמו מעקב אחרי פרויקטים, תכנון אירועים וניהול מלאי.

הוספת טבלה

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

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

{
  "addTable": {
    "table": {
      "name": "Project Tracker",
      "tableId": "123",
      "range": {
        "sheetId": 0,
        "startColumnIndex": 0,
        "endColumnIndex": 5,
        "startRowIndex": 0,
        "endRowIndex": 5,
      },
      "columnProperties": [
        {
          "columnIndex": 0,
          "columnName": "Column 1",
          "columnType": "PERCENT"
        },
        {
          "columnIndex": 1,
          "columnName": "Column 2",
          "columnType": "DROPDOWN",
          "dataValidationRule": {
            "condition": {
              "type": "ONE_OF_LIST",
              "values": [
                {
                  "userEnteredValue": "Not Started"
                },
                {
                  "userEnteredValue": "In Progress"
                },
                {
                  "userEnteredValue": "Complete"
                }
              ]
            }
          }
        }
      ],
    }
  }
}

סוגי עמודות

בטבלאות יש סוגי עמודות כמו מספר, תאריך, תפריט נפתח, צ'יפ חכם ותיבת סימון. סוגי העמודות 'דירוג' ו'תיבת סימון' מאוכלסים בערכי ברירת המחדל 0 ו-FALSE בהתאמה.

עמודה מסוג תפריט נפתח

סוג העמודה 'תפריט נפתח' יוצר צ'יפ שנפתח לרשימה. אם סוג העמודה מוגדר כ'תפריט נפתח', צריך להגדיר את dataValidationRule של העמודה עם תנאי ONE_OF_LIST. בשאר סוגי העמודות לא צריך להגדיר את השדה dataValidationRule.

עדכון טבלה

משתמשים בשיטה spreadsheets.batchUpdate ומספקים UpdateTableRequest.

שינוי הגודל של הטבלה

משתמשים בשיטה UpdateTableRequest כדי לשנות את range שהטבלה צריכה להוסיף שורות או עמודות חדשות.

אם צריך להוסיף שורה או עמודה חדשה בטבלה, אפשר להשתמש ב-InsertRangeRequest או ב-InsertDimensionRequest.

אם אתם צריכים למחוק שורה בטבלה, אתם יכולים להשתמש ב-DeleteRangeRequest. אם אתם רוצים למחוק שורה שלמה בגיליון האלקטרוני, אתם יכולים להשתמש ב-DeleteDimensionRequest.

הערה: אם משתמשים ב-InsertRangeRequest או ב-DeleteRangeRequest, הטווח בבקשה צריך לכלול את כל השורות אם מוחקים שורה, או את כל העמודות אם מוחקים עמודה.

החלפת מצב הכותרת התחתונה של הטבלה

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

הוספת ערכים לטבלה

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

מחיקת טבלה

משתמשים בשיטה spreadsheets.batchUpdate ומספקים DeleteTableRequest. משתמשים ב-DeleteTableRequest כדי למחוק את כל הטבלה ואת התוכן שלה.

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

שימוש בטבלאות עם תכונות אחרות של Sheets

תכונות נוספות של ה-API שתומכות בטבלאות כנתוני גיבוי כוללות מסננים, תצוגות מסוננות וטווחים מוגנים.