טבלאות

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

מהי טבלה?

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

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

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

הוספת טבלה

כדי להוסיף טבלה, משתמשים ב-method‏ 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.

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

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

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

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

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

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

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

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

מחיקת טבלה

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

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

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

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