Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 26 additions & 3 deletions source/_integrations/google_sheets.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -70,17 +70,40 @@ The integration setup will next give you instructions to enter the [Application
## Troubleshooting

If you have an error with your credentials you can delete them in the [Application Credentials](/integrations/application_credentials/) user interface.
The below services will only work with the Sheets document created at setup by default. If you wish to append to or edit other documents, configure it for read/write access from the integrations page.

### Service `google_sheets.append_sheet`

You can use the service `google_sheets.append_sheet` to add a row of data to the Sheets document created at setup.
You can use the service `google_sheets.append_sheet` to add a row of data to a Sheets document.

{% details "Create Event Service details" %}

| Service data attribute | Optional | Description | Example |
| ---------------------- | -------- | ----------- | --------|
| `config_entry` | no | Config entry to use.
| `config_entry` | no | Config entry to use. | [See selectors here](/docs/blueprint/selectors/#config-entry-selector)
| `document_id` | yes | The id of the document. Defaults to the one created at setup. See below.
| `worksheet` | yes | Name of the worksheet. Defaults to the first one in the document. | Sheet1
| `data` | no | Data to be appended to the worksheet. This puts the data on a new row, one value per column. | ["foo"]
| `data` | no | Data to be appended to the worksheet. This puts the data on a new row, one value per column. | {"foo": "bar"} [See templating here](/integrations/template)

{% enddetails %}

### Service `google_sheets.edit_sheet`

You can use the service `google_sheets.edit_sheet` to edit cells of a Sheets document.

{% details "Create Event Service details" %}

| Service data attribute | Optional | Description | Example |
| ---------------------- | -------- | ----------- | --------|
| `config_entry` | no | Config entry to use. | [See selectors here](/docs/blueprint/selectors/#config-entry-selector)
| `document_id` | yes | The id of the document. Defaults to the one created at setup. See below.
| `worksheet` | yes | Name of the worksheet. Defaults to the first one in the document. | Sheet1
| `data` | no | Data to be appended to the worksheet. This puts the data on a new row, one value per column. | {"A1": "bar} [See templating here](/integrations/template)

{% enddetails %}

## Where to find your document id

<p class='img'>
<img src='/images/screenshots/google_sheets_document_id.png' />
</p>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.