Google Docs Batch Update icon

Google Docs Batch Update

Build and send Google Docs batch update requests

Actions40

Create Tables Request → Insert Table Column

AI-generated

Summary

Inserts a new column into a Google Docs table, optionally specifying the target location within a document segment.

Inputs

  • Table Start Index (required) — The zero-based UTF-16 code unit index marking the start of the segment where the table resides.
  • Additional Location Fields — A collection of fields to refine the insertion location: segmentId (header, footer, or footnote ID; empty string defaults to document body), and tabId (specific tab within the document; omitted targets the first tab or the singular tab).
  • Column Index — The zero-based index of the column where the new column will be inserted (0 inserts before the first column). Defaults to 0.
  • Insert Right — Whether to insert the new column to the right of the reference cell location. Defaults to true.

Output shape

no body — success/failure only

The operation returns a success or failure status without returning the modified document content. It creates a batch request that is applied to the specified table segment.

Examples

Example 1: Insert a column at the start of a table in the document body.

Table Start Index: 0, Additional Location Fields: {}, Column Index: 0, Insert Right: true

Example 2: Insert a column to the right of the first column in a specific tab.

Table Start Index: 10, Additional Location Fields: {tabId: 'tab_123'}, Column Index: 0, Insert Right: true

Links

Discussion