תפעול טבלאות

Google Slides API מאפשר ליצור ולערוך טבלאות בדפים. הדוגמאות באתר במאמר הזה מוצגות כמה פעולות נפוצות בטבלה באמצעות presentations.batchUpdate .

בדוגמאות האלה משתמשים במשתנים הבאים:

• PRESENTATION_ID – מציין איפה אתם מספקים את מצגת מזהה. אפשר לגלות את הערך של המזהה בכתובת ה-URL של המצגת.
• PAGE_ID – מציין איפה מספקים את אובייקט הדף מזהים. אפשר לאחזר את הערך הזה מכתובת ה-URL או באמצעות בקשת קריאה ל-API.
• TABLE_ID – מציין איפה מספקים את הדף מזהה אובייקט ברכיב של שאיתה אתם עובדים. אפשר לציין את המזהה הזה לרכיבים שיוצרים (עם חלק הגבלות) או לאפשר ל-API של Slides ליצור אותו באופן אוטומטי. מזהי הרכיבים להיות נגישים באמצעות בקשת קריאה של API.

הדוגמאות האלה מוצגות כבקשות HTTP כך שהשפה תהיה ניטרלית. למידה איך לבצע עדכון בכמות גדולה בשפות שונות באמצעות Google API לספריות לקוח. מידע נוסף זמין בקטע הוספת צורות text.

צור טבלה

הבאים presentations.batchUpdate דוגמת הקוד מראה איך להשתמש CreateTableRequest כדי להוסיף טבלה לשקף שצוין על ידי PAGE_ID.

בטבלה הזו יש שמונה שורות וחמש עמודות. שימו לב שה-API של Slides מתעלמת מכל שדה מסוג size או transform שמסופק כחלק elementProperties. במקום זאת, ה-API יוצר טבלה שנמצאת במרכז השקף, מותאם למספר השורות והעמודות שצוין, אם זה אפשרי.

זה פרוטוקול הבקשה ליצירת טבלה:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createTable": {
        "objectId": TABLE_ID,
        "elementProperties": {
          "pageObjectId": PAGE_ID,
        },
        "rows": 8,
        "columns": 5
      }
    }
  ]
}

מחיקה של שורות או עמודות בטבלה

הבאים presentations.batchUpdate דוגמת הקוד מראה איך להשתמש DeleteTableRowRequest להסרת השורה השישית. לאחר מכן היא משתמשת DeleteTableColumnRequest להסרת העמודה הרביעית. הטבלה מצוינת על ידי TABLE_ID גם rowIndex וגם columnIndex בתוך cellLocation מבוססים על אפס.

פרוטוקול הבקשה למחיקת שורות או עמודות בטבלה:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "deleteTableRow": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 5
        }
      }
    },
    {
      "deleteTableColumn": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "columnIndex": 3
        }
      }
    }
  ]
}

עריכת נתוני הטבלה

הבאים presentations.batchUpdate דוגמת הקוד מראה איך להשתמש DeleteTextRequest שיטה להסרת כל הטקסט בתא שבתוך textRange. הוא ואז משתמשת InsertTextRequest כדי להחליף אותו בטקסט החדש של "Kangaroo".

הטבלה מצוינת על ידי TABLE_ID. התא שהושפע נמצא ב- את השורה החמישית והעמודה השלישית. גם rowIndex וגם columnIndex בתוך הערכים cellLocation מבוססים על אפס.

זה פרוטוקול הבקשה לעריכת נתוני טבלה:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "deleteText": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 4,
          "columnIndex": 2
        },
        "textRange": {
          "type": "ALL",
        }
      }
    },
    {
      "insertText": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 4,
          "columnIndex": 2
        },
        "text": "Kangaroo",
        "insertionIndex": 0
      }
    }
  ]
}

עיצוב של שורת כותרת של טבלה

הבאים presentations.batchUpdate דוגמת הקוד מראה איך להשתמש UpdateTableCellPropertiesRequest כדי לעצב את שורת הכותרת של רכיב בטבלה, בתוך tableRange, שצוין על ידי TABLE_ID. לאחר מכן היא משתמשת TableCellProperties כדי להגדיר את צבע הרקע של שורת הכותרת לשחור.

כל בקשה הבאה משתמשת UpdateTextStyleRequest שיטה להגדרת עיצוב הטקסט בתא אחד בשורת הכותרת להדגשה, לבן 18 נקודות גופן Cambria בתוך textRange שלך צריך לחזור על הבקשה הזו עבור כל תא נוסף בכותרת.

גם rowIndex וגם columnIndex בתוך location וגם הערכים של cellLocation מבוססים על אפס.

זה פרוטוקול הבקשה לעיצוב שורת הכותרת של טבלה:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "updateTableCellProperties": {
        "objectId": TABLE_ID,
        "tableRange": {
          "location": {
            "rowIndex": 0,
            "columnIndex": 0
          },
          "rowSpan": 1,
          "columnSpan": 3
        },
        "tableCellProperties": {
          "tableCellBackgroundFill": {
            "solidFill": {
              "color": {
                "rgbColor": {
                  "red": 0.0,
                  "green": 0.0,
                  "blue": 0.0
                }
              }
            }
          }
        },
        "fields": "tableCellBackgroundFill.solidFill.color"
      }
    },
    {
      "updateTextStyle": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 0,
          "columnIndex": 0
        },
        "style": {
          "foregroundColor": {
            "opaqueColor": {
              "rgbColor": {
                "red": 1.0,
                "green": 1.0,
                "blue": 1.0
              }
            }
          },
          "bold": true,
          "fontFamily": "Cambria",
          "fontSize": {
            "magnitude": 18,
            "unit": "PT"
          }
        },
        "textRange": {
          "type": "ALL"
        },
        "fields": "foregroundColor,bold,fontFamily,fontSize"
      }
    },
    // Repeat the above request for each additional cell in the header row....
  ]
}

כך נראית שורת הכותרת המעוצבת אחרי העדכונים האלה:

הוספת שורות או עמודות בטבלה

הבאים presentations.batchUpdate דוגמת הקוד מראה איך להשתמש InsertTableRowsRequest כדי להוסיף שלוש שורות מתחת לשורה השישית. לאחר מכן היא משתמשת InsertTableColumnsRequest להוספת שתי עמודות משמאל לעמודה הרביעית באותה טבלה.

הטבלה מצוינת על ידי TABLE_ID. גם rowIndex וגם הערכים columnIndex שבתוך cellLocation מבוססים על אפס.

זה פרוטוקול הבקשה להוספת שורות או עמודות בטבלה:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "insertTableRows": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 5
        },
        "insertBelow": true,
        "number": 3
      }
    },
    {
      "insertTableColumns": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "columnIndex": 3
        },
        "insertRight": false,
        "number": 2
      }
    }
  ]
}