Guidance for Google Docs connector

Read the following information for guidance and best practices when using the Google Docs connector in your flows.

Action card-specific limitations

Update Document action card

Review the additional information for each field.

Field Details

Insert Inline Image

If you select this option, exceeding the height and width of a page can cause a new Google Docs page to be appended.

Text

Inserting a newline character implicitly creates a paragraph at that index. The paragraph style of the new paragraph is copied from the paragraph at the current insertion index, including lists and bullets.

Text styles for inserted text are determined automatically, generally preserving the styling of neighboring text. Generally, the text style for the inserted text matches the text immediately before the insertion index.

Some control characters (U+0000 to U+0008, U+000C to U+001F) and characters from the Unicode Basic Multilingual Plane Private Use Area (U+E000 to U+F8FF) are stripped out of the inserted text.

Segment ID

Use the Read Document card to obtain the Segment ID value.

Usage:

  • A slash (/) with a character is considered 1 character.
  • Segment ID and Index: Inserts the text to the specified segment (header, footer, footnotes), starting from the index.
  • Segment ID: Inserts the text to the end of the document body.
  • Index: Inserts the text to the specified index of the document body.

For the document body, use index values in the Start Index and End Index properties. They represent the index of the first character in the line and the last character respectively. You can retrieve the start and end indexes using the Read Document card.

For a specific segment (header, footer, footnotes), use the End Index as the length of the line.

The starting index is always 0.

Index

Usage:

  • A slash (/) with a character is considered 1 character.
  • Segment ID and Index: Inserts the text to the specified segment (header, footer, footnotes), starting from the index.
  • Segment ID: Inserts the text to the end of the document body.
  • Index: Inserts the text to the specified index of the document body.

For the document body, use index values in the Start Index and End Index properties. They represent the index of the first character in the line and the last character respectively. You can retrieve the start and end indexes using the Read Document card.

For a specific segment (header, footer, footnotes), use the End Index as the length of the line.

The starting index is always 0.

Font Weight

The font weight makes up just one component of the rendered font weight. Google Docs determines the rendered weight as a combination of the weight and the text style's resolved bold value, after accounting for inheritance.

  • If the text is bold and the weight is less than 400, the rendered weight is 400.
  • If the text is bold and the weight is greater than or equal to 400 but is less than 700, the rendered weight is 700.
  • If the weight is greater than or equal to 700, the rendered weight is equal to the weight.
  • If the text isn't bold, the rendered weight is equal to the weight.

The Font Weight should be passed with a Font Family value. If you only pass one value, the card returns an error.

Image Height

If you don't specify a height, then the default size of the image is calculated based on its resolution.

If you only specify one dimension, then the other dimension is calculated to preserve the aspect ratio of the image.

If you specify both width and height, the image is scaled to fit within the provided dimensions while maintaining its aspect ratio.

Image Width

If you don't specify a width, then the default size of the image is calculated based on its resolution.

If you only specify one dimension, then the other dimension is calculated to preserve the aspect ratio of the image.

If you specify both width and height, the image is scaled to fit within the provided dimensions while maintaining its aspect ratio.

Related topics

Google Docs connector

Cards in flows

Google Docs API Documentation