# Extract a random row — Google Sheets

Botize method — `gspreadsheet.read_random_row` (action).

Extract randomly each row of a sheet.

- You can exclude rows that contain or do not contain certain words or values.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `sheet_url` *(string)* — URL of your sheet document
- `sheet` *(string)* — Sheet. Sheet id (gid) chosen from the list, or the sheet name. Empty = first sheet.
- `exclude_first_row` *(boolean)*
- `value_render_option` *(boolean)* — Exclude first row
- `by_column` *(string)* — Filter rows based on column values

It also accepts repeatable field groups, with these prefixes: `filter_*`. These are composite components (buttons, filters, keyboards); the trailing number is set by the user as they are added.

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{column_a}}` *(text)* — Column A
- `{{column_b}}` *(text)* — Column B
- `{{column_c}}` *(text)* — Column C
- `{{column_d}}` *(text)* — Column D
- `{{column_e}}` *(text)* — Column E
- `{{column_f}}` *(text)* — Column F
- `{{column_g}}` *(text)* — Column G
- `{{column_h}}` *(text)* — Column H
- `{{column_i}}` *(text)* — Column I
- `{{column_j}}` *(text)* — Column J
- `{{column_k}}` *(text)* — Column K
- `{{column_l}}` *(text)* — Column L
- `{{column_m}}` *(text)* — Column M
- `{{column_n}}` *(text)* — Column N
- `{{column_o}}` *(text)* — Column O
- `{{column_p}}` *(text)* — Column P
- `{{column_q}}` *(text)* — Column Q
- `{{column_r}}` *(text)* — Column R
- `{{column_s}}` *(text)* — Column S
- `{{column_t}}` *(text)* — Column T
- `{{column_u}}` *(text)* — Column U
- `{{column_v}}` *(text)* — Column V
- `{{column_w}}` *(text)* — Column W
- `{{column_x}}` *(text)* — Column X
- `{{column_y}}` *(text)* — Column Y
- `{{column_z}}` *(text)* — Column Z
- `{{row}}` *(int)* — Number of Row

## Account

Needs a connected Google Sheets account in Botize: https://botize.com/en/app/gspreadsheet/authenticate

## This app

Every trigger and action for Google Sheets: https://botize.com/en/app/gspreadsheet.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/gspreadsheet/read_random_row