テーブル

このガイドでは、Google Sheets API を使用してスプレッドシートにテーブルを作成する方法と理由について説明します。

テーブルとは

テーブルを使用すると、データ範囲に書式や構造を自動的に適用することができ、データ作成を簡素化したり、データの書式設定、入力、更新を繰り返す手間を省いたりすることができます。

テーブルには、ヘッダー、フッター、列の型、フィルタ、ビュー、テーブル参照、テーブル名など、多くの機能があります。詳しくは、 機能の発表をご覧ください。 また、スプレッドシートでテーブルを使用する方法についてもご確認ください。

テーブルは、プロジェクトの追跡、イベントの計画、在庫管理などのタスクに使用できます。

表を追加する

テーブルを追加するには、 batchUpdate メソッドを使用して、 addTable リクエストを指定します。このリクエストを使用して、スプレッドシートにテーブルを追加します。

次の例では、指定された range に 2 つの列が設定された「Project Tracker」という名前のテーブルを作成します。最初の列はパーセント列、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 は 1 行拡張されます。フッター付きの既存のテーブルを更新してフッターを削除する場合、range は 1 行縮小されます。

テーブルに値を追加する

AppendCellsRequest を使用して、テーブルの末尾に行を追加します。tableIdこれにより、値が最初の空の行に追加され、行全体とフッターが認識されます。空の行がない場合は、テーブルの末尾とフッターの前に（該当する場合）行が挿入されます。

テーブルを削除する

spreadsheets.batchUpdate メソッドを使用して、 DeleteTableRequest を指定します。 DeleteTableRequest を使用して、テーブル全体とテーブルの内容を削除します。

DeleteBandingRequest を使用すると、テーブルの書式設定を削除してデータを保持できます。

他のスプレッドシート機能でテーブルを使用する

テーブルをバックアップ データとしてサポートする他の API 機能には、 フィルタ、 フィルタビュー、 保護された範囲などがあります。