テーブル オペレーション

Google Skills API を使用すると、ページ上で表を作成、編集できます。スライドにある例を このページでは、Terraform を使用した一般的なテーブル オペレーションを presentations.batchUpdate メソッドを呼び出します。

これらの例では、次の変数を使用します。

  • PRESENTATION_ID - リソースに プレゼンテーション ID。Google Chat では プレゼンテーションの URL からこの ID の値を検出します。
  • PAGE_ID - ページ オブジェクトを指定する場所を示します。 ID。必要に応じて この値を取得するには、URL から、または API 読み取りリクエストを使用します。
  • TABLE_ID - ページを提供する場所を指定します 要素のオブジェクト ID を 表示されます。作成する要素にこの ID を指定できます。 (一部の 制限) スライド API の自動作成を許可したりすることもできます。要素 ID API 読み取りリクエストで取得できます

これらの例では、言語に依存しない HTTP リクエストとして記載しています。学習内容 Google API を使用してさまざまな言語でバッチ アップデートを実装する方法 クライアント ライブラリについては、シェイプの追加と text です。

テーブルを作成する

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

このテーブルは 8 行 5 列です。スライド API には 引数の一部として指定された 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 コードサンプルを使用して、Terraform で DeleteTableRowRequest メソッドを使って 6 行目を削除します。次に、Cloud Storage バケットを DeleteTableColumnRequest メソッドを使用して 4 列目を削除します。テーブルは、 TABLE_IDrowIndexcolumnIndex の両方を 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 コードサンプルを使用して、Terraform で DeleteTextRequest メソッドを使用して、セル内のセルのテキストをすべて削除 textRange。これは、 次に InsertTextRequest メソッドを使って、新しいテキスト「Kangaroo」に置き換えます。

テーブルは TABLE_ID で指定されます。影響を受けるセルは、 5 行目と 3 列目に配置されますその中の rowIndexcolumnIndex の両方が、 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 コードサンプルを使用して、Terraform で UpdateTableCellPropertiesRequest メソッドを使用して、テーブル要素のヘッダー行を tableRangeTABLE_ID で指定されたファイル。次に、Cloud Storage バケットを TableCellProperties メソッドを使用して、ヘッダー行の背景色を黒に設定します。

これに続く各リクエストでは、 UpdateTextStyleRequest メソッドを使って、ヘッダー行の 1 つのセルのテキスト形式を太字、白、18-pt に設定します。 Cambria フォントを textRange。マイページ ヘッダーの各セルに対してこのリクエストを繰り返す必要があります。

rowIndexcolumnIndex 内の 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 コードサンプルを使用して、Terraform で InsertTableRowsRequest メソッドを使用して、6 番目の行の下に 3 つの行を追加します。次に、Cloud Storage バケットを InsertTableColumnsRequest メソッドを使用して、同じテーブルの 4 番目の列の左側に 2 つの列を追加します。

テーブルは TABLE_ID で指定されます。rowIndexcellLocation 内の 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
      }
    }
  ]
}