> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Workspace: Update Cells

> Writing enrichment results or run status back to explicit ranges in an existing workspace-owned spreadsheet, with safe retries.

Writing enrichment results or run status back to explicit ranges in an existing workspace-owned spreadsheet, with safe retries.

<Info>
  Tool ID: `google_workspace_update_cells`
</Info>

## Run this action

This action has conditional or dynamic input fields that cannot be represented by a reliable static example.

Inspect the live contract before executing it:

```bash theme={null}
deepline tools get google_workspace_update_cells --json
```

## Example response

The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.

```json theme={null}
{
  "spreadsheet_id": "spreadsheet_123",
  "spreadsheet_url": "https://example.com",
  "operation_key": "example",
  "updated_ranges": [
    "2026-01-15T12:00:00Z"
  ],
  "updated_cells": 123,
  "replayed": true
}
```

Use `deepline tools get google_workspace_update_cells --json` for the latest machine-readable contract.

## Input reference

Overwrite explicit cells in an existing workspace-owned spreadsheet, up to 25,000 cells across 100 ranges. Leaves other cells and formatting intact. Writes and a retry receipt are atomic. This is an explicit overwrite, not a compare-and-set or row-ID lookup.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.spreadsheet_id` | `string` | Yes | — | Minimum length: 1. Pattern: `\S`. |
| `payload.updates` | `array` | Yes | — | Minimum items: 1. Maximum items: 100. |
| `payload.operation_key` | `string` | Yes | — | Stable key scoped to this spreadsheet. Reuse only for retries of the exact same updates; use a new key for each new write. Minimum length: 8. Pattern: `\S`. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Overwrite explicit cells in an existing workspace-owned spreadsheet, up to 25,000 cells across 100 ranges. Leaves other cells and formatting intact. Writes and a retry receipt are atomic. This is an explicit overwrite, not a compare-and-set or row-ID lookup.",
    "properties": {
      "spreadsheet_id": {
        "type": "string",
        "minLength": 1,
        "pattern": "\\S"
      },
      "updates": {
        "type": "array",
        "minItems": 1,
        "maxItems": 100,
        "items": {
          "type": "object",
          "properties": {
            "range": {
              "type": "string",
              "description": "Fixed A1 range including the tab name, for example 'Accounts!D2:F3'. Must fit the existing grid.",
              "minLength": 1
            },
            "values": {
              "type": "array",
              "description": "Row-major values exactly matching the range. Strings are literal, never formulas. null clears a cell.",
              "minItems": 1,
              "items": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              }
            }
          },
          "required": [
            "range",
            "values"
          ],
          "additionalProperties": false
        }
      },
      "operation_key": {
        "type": "string",
        "description": "Stable key scoped to this spreadsheet. Reuse only for retries of the exact same updates; use a new key for each new write.",
        "minLength": 8,
        "pattern": "\\S"
      }
    },
    "required": [
      "spreadsheet_id",
      "updates",
      "operation_key"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.spreadsheet_id` | `string` | Yes | — | — |
| `result.spreadsheet_url` | `string` | Yes | — | — |
| `result.operation_key` | `string` | Yes | — | — |
| `result.updated_ranges` | `array` | Yes | — | — |
| `result.updated_cells` | `integer` | Yes | — | — |
| `result.replayed` | `boolean` | Yes | — | True when this operation was already applied; later collaborator edits were not overwritten again. |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "spreadsheet_id": {
        "type": "string"
      },
      "spreadsheet_url": {
        "type": "string"
      },
      "operation_key": {
        "type": "string"
      },
      "updated_ranges": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "updated_cells": {
        "type": "integer"
      },
      "replayed": {
        "type": "boolean",
        "description": "True when this operation was already applied; later collaborator edits were not overwritten again."
      }
    },
    "required": [
      "spreadsheet_id",
      "spreadsheet_url",
      "operation_key",
      "updated_ranges",
      "updated_cells",
      "replayed"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)
