Google Docs Batch Update icon

Google Docs Batch Update

Build and send Google Docs batch update requests

Create Document Request → Create Footnote

AI-generated

Summary

Creates a footnote insertion request for a Google Document, with location controlled by insertion type, index, and optional segment/tab context.

Inputs

  • insertionLocation — Location Type: 'Location' places the footnote at the specified index; 'End of Segment Location' places it at the end of a specified segment (header, footer, or footnote). Defaults to 'Location'. No data expression allowed; value is static from UI options.
  • additionalLocationFields — Additional fields for the end of segment location. Appears when insertionLocation is 'End of Segment Location'. Contains segmentId (ID of header/footer/footnote segment; empty string signifies document body) and tabId (tab identifier; when omitted, applies to first tab).
  • index (required) — The zero-based index, in UTF-16 code units, relative to the beginning of the segment specified by segmentId. Required when insertionLocation is 'Location'.
  • additionalLocationFields — Additional fields for the end of segment location. Appears when insertionLocation is 'Location'. Contains segmentId and tabId (same semantics as above).

Output shape

The updated Google Document or request confirmation reflecting the footnote insertion.

Parameter visibility is conditional: insertionLocation toggles which additionalLocationFields and index parameters appear. When insertionLocation is 'Location', index is required and additionalLocationFields provides segment/tab context. When 'End of Segment Location', additionalLocationFields provides segment/tab context and index is not shown.

Examples

Example 1: Add a footnote at the end of the document body.

insertionLocation: 'End of Segment Location', additionalLocationFields.segmentId: '' (empty), additionalLocationFields.tabId: omitted

Example 2: Add a footnote at index 5 in the document body.

insertionLocation: 'Location', index: 5, additionalLocationFields.segmentId: '' (empty), additionalLocationFields.tabId: omitted

Links

Discussion