Tabellenvorgänge

Mit der Google Slides API können Sie Tabellen auf Seiten erstellen und bearbeiten. Die Beispiele auf werden auf dieser Seite einige gängige Tabellenvorgänge presentations.batchUpdate .

In diesen Beispielen werden die folgenden Variablen verwendet:

  • PRESENTATION_ID: Gibt an, wo Sie die Präsentation ID fest. Sie können finden Sie den Wert für diese ID in der Präsentations-URL.
  • PAGE_ID: Gibt an, wo Sie das Seitenobjekt bereitstellen. IDs: Sie können die Daten abrufen, den Wert hierfür aus der URL oder mithilfe einer API-Leseanfrage.
  • TABLE_ID: Gibt an, wo Sie die Seite bereitstellen. Objekt-ID des Elements für ein Tabelle, mit der Sie arbeiten. Sie können diese ID für Elemente angeben, die Sie erstellen (mit einigen Einschränkungen) oder über die Slides API automatisch eine erstellen lassen. Element-IDs kann über eine API-Leseanfrage abgerufen werden.

Diese Beispiele werden als HTTP-Anfragen dargestellt, damit sie sprachneutral sind. Weitere Informationen Wie eine Batch-Aktualisierung in verschiedenen Sprachen mithilfe der Google API implementiert wird finden Sie unter Formen und Text.

Tabelle erstellen

Die folgenden presentations.batchUpdate wird gezeigt, wie Sie mit der CreateTableRequest , um einer Folie, die durch PAGE_ID angegeben wird, eine Tabelle hinzuzufügen.

Diese Tabelle hat acht Zeilen und fünf Spalten. Beachten Sie, dass die Slides API ignoriert alle size- oder transform-Felder, die als Teil des elementProperties Stattdessen erstellt die API eine Tabelle, die in etwa zentriert auf der Folie steht und , um die angegebene Anzahl von Zeilen und Spalten aufzunehmen.

Das folgende Anfrageprotokoll dient zum Erstellen einer Tabelle:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createTable": {
        "objectId": TABLE_ID,
        "elementProperties": {
          "pageObjectId": PAGE_ID,
        },
        "rows": 8,
        "columns": 5
      }
    }
  ]
}

Tabellenzeilen oder -spalten löschen

Die folgenden presentations.batchUpdate wird gezeigt, wie Sie mit der DeleteTableRowRequest um die sechste Zeile zu entfernen. Dann wird die Methode DeleteTableColumnRequest um die vierte Spalte zu entfernen. Die Tabelle wird durch den TABLE_ID Sowohl rowIndex als auch columnIndex innerhalb der cellLocation sind nullbasiert.

Folgendes ist das Anfrageprotokoll zum Löschen von Tabellenzeilen oder -spalten:

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
        }
      }
    }
  ]
}

Tabellendaten bearbeiten

Die folgenden presentations.batchUpdate wird gezeigt, wie Sie mit der DeleteTextRequest den gesamten Text aus einer Zelle innerhalb der textRange Es verwendet dann die Methode InsertTextRequest , um ihn durch den neuen Text "Känguru" zu ersetzen.

Die Tabelle wird durch TABLE_ID angegeben. Die betroffene Zelle befindet sich in in der fünften Zeile und in der dritten Spalte. Sowohl der rowIndex als auch der columnIndex innerhalb cellLocation sind nullbasiert.

Das folgende Anfrageprotokoll dient zum Bearbeiten von Tabellendaten:

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
      }
    }
  ]
}

Kopfzeilen von Tabellen formatieren

Die folgenden presentations.batchUpdate wird gezeigt, wie Sie mit der UpdateTableCellPropertiesRequest zur Formatierung der Kopfzeile eines Tabellenelements innerhalb der tableRange die durch TABLE_ID angegeben werden. Dann wird die Methode TableCellProperties , um die Hintergrundfarbe der Kopfzeile auf Schwarz zu setzen.

Jede folgende Anfrage verwendet den Parameter UpdateTextStyleRequest -Methode, um das Textformat in einer Zelle der Kopfzeile in Fettdruck, weiß 18-pt, festzulegen Cambria-Schriftart innerhalb der textRange Ich diese Anfrage für jede weitere Zelle im Header wiederholen.

Sowohl rowIndex als auch columnIndex innerhalb von location und cellLocation sind nullbasiert.

Das folgende Anfrageprotokoll dient zum Formatieren einer Kopfzeile einer Tabelle:

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....
  ]
}

So sieht die formatierte Kopfzeile nach diesen Aktualisierungen aus:

Formatieren Sie das Schemaergebnis für die Kopfzeile.

Tabellenzeilen oder -spalten einfügen

Die folgenden presentations.batchUpdate wird gezeigt, wie Sie mit der InsertTableRowsRequest um drei Zeilen unterhalb der sechsten Zeile hinzuzufügen. Dann wird die Methode InsertTableColumnsRequest , um zwei Spalten links von der vierten Spalte in derselben Tabelle hinzuzufügen.

Die Tabelle wird durch TABLE_ID angegeben. Sowohl rowIndex als auch Die columnIndex innerhalb der cellLocation sind nullbasiert.

Folgendes ist das Anfrageprotokoll zum Einfügen von Tabellenzeilen oder -spalten:

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
      }
    }
  ]
}