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

テーブルオペレーション

Google Sheets 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_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 コードサンプルを使用して、Terraform で DeleteTextRequest メソッドを使用して、セル内のセルのテキストをすべて削除 textRange。これは、次に InsertTextRequest メソッドを使って、新しいテキスト「Kangaroo」に置き換えます。

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

これに続く各リクエストでは、 UpdateTextStyleRequest メソッドを使って、ヘッダー行の 1 つのセルのテキスト形式を太字、白、18-pt に設定します。 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 コードサンプルを使用して、Terraform で InsertTableRowsRequest メソッドを使用して、6 番目の行の下に 3 つの行を追加します。次に、Cloud Storage バケットを InsertTableColumnsRequest メソッドを使用して、同じテーブルの 4 番目の列の左側に 2 つの列を追加します。

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

テーブル オペレーション