このページは Cloud Translation API によって翻訳されました。

テーブルオペレーション

Google Slides API を使用すると、ページ上で表の作成や編集ができます。このページの例では、presentations.batchUpdate メソッドを使用した一般的な表操作を示します。

サンプルで使用する変数は次のとおりです。

PRESENTATION_ID - プレゼンテーション ID を指定する場所を示します。この ID の値はプレゼンテーションの URL で確認できます。
PAGE_ID - ページオブジェクト ID を指定する場所を示します。この ID の値は URL から、または API の読み取りリクエストを使用して取得できます。
TABLE_ID - 作業するテーブルのページ要素オブジェクト ID を指定する場所を示します。作成する要素の ID は自身で指定するか（いくつかの制限事項があります）、Slides API で自動的に生成できます。要素 ID は、API 読み取りリクエストで取得できます。

これらの例では、特定の言語に依存しない HTTP リクエストの形式を採用しています。Google API クライアントライブラリを使用してさまざまな言語でバッチアップデートを実装する方法については、シェイプとテキストの追加をご覧ください。

テーブルを作成する

次の presentations.batchUpdate コードサンプルは、CreateTableRequest メソッドを使用して、PAGE_ID で指定されたスライドに表を追加する方法を示しています。

この表は 8 行 5 列で構成されます。なお、elementProperties の一部として提供される size フィールドや transform フィールドは無視されます。代わりに、この 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 メソッドを使用して 6 行目を削除する方法を示しています。次に、DeleteTableColumnRequest メソッドを使用して 4 列目を削除します。テーブルは TABLE_ID で指定します。cellLocation 内の rowIndex と columnIndex はどちらもゼロベースです。

テーブルの行または列を削除するリクエストプロトコルは次のとおりです。

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 で指定します。影響を受けるセルは 5 行目 3 列目にあります。cellLocation 内の rowIndex と columnIndex はどちらもゼロベースです。

テーブルデータを編集するためのリクエストプロトコルは次のとおりです。

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 メソッドを使用して、TABLE_ID で指定された tableRange 内の表要素のヘッダー行をフォーマットする方法を示しています。次に、TableCellProperties メソッドを使用して、ヘッダー行の背景色を黒に設定します。

その後の各リクエストでは、UpdateTextStyleRequest メソッドを使用して、ヘッダー行の 1 つのセルのテキスト形式を、textRange 内で太字の 18 pt カンブリアフォントに設定します。ヘッダーの追加セルごとに、このリクエストを繰り返す必要があります。

location と cellLocation 内の rowIndex と columnIndex はどちらもゼロベースです。

表のヘッダー行の書式設定を行うリクエストプロトコルは次のとおりです。

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 メソッドを使用して 6 行目の下に 3 行を追加する方法を示しています。次に、InsertTableColumnsRequest メソッドを使用して、同じテーブルの 4 列目の左に 2 列追加します。

テーブルは TABLE_ID で指定されます。cellLocation 内の rowIndex と columnIndex はどちらもゼロベースです。

表に行または列を挿入するリクエストプロトコルは次のとおりです。

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

テーブル オペレーション