טבלאות

במדריך הזה מוסבר איך להשתמש ב-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.

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

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

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

מחיקת טבלה

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

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

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

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