Google Sheets Integration Error & Data Format Mismatch

I tested the example you provided, and it works as expected. I can see that the possibilities are enormous—this is great.

However, I’m still having trouble setting up my trigger with Google Sheets.

The first issue I noticed with the triggers is that the Export button does not work. Clicking it causes RTILA X to crash.

The JSON file I previously provided for the trigger was retrieved using the macOS Terminal. My LLM gave me a command that extracted all the triggers from RTILA X. However, when I use the Export button directly in the interface, the software crashes.

The second issue is that when an automation has been started and I stop it manually, the trigger treats the action as a failure. Alternatively, I may have configured something incorrectly.

Great, thanks for the confirmation!

Could you please check if you are able to export the trigger chain? Also, please make sure to remove all sensitive data from the JSON file before uploading it.

Quick updates on my previous points:

  1. Export button — I initially reported that the Export button was crashing RTILA X. After investigating, I found that the crash was not caused by the software itself, but by an invalid data format in the data field of the Google Sheets step (and possibly the read_project_dataset step). When the expected format is not respected, the Export button crashes. Once I used a valid format, the Export button worked correctly. :white_check_mark:

  2. Manual stop treated as failure — Still observing this, but it’s lower priority for now.


Now, the main issue I need help with: Google Sheets integration in a trigger chain.

My goal is simple: run a project → read the extracted dataset → append the data to Google Sheets.

Here’s my current trigger chain (3 steps):

Step Type output_variable_name Notes
0 launch_project launch_project_3_queue_id wait_for_completion: true
1 read_project_dataset read_project_dataset_2_records Reads 307 records with fields url and page_source
2 google_sheets google_sheets_3_cell_value Operation: append_row — this step fails

Steps 0 and 1 work perfectly. The project runs to completion, and read_project_dataset returns 307 records. I can see the data in the run record — URLs and page sources are all there.

Step 2 (Google Sheets) fails every time.


What I’ve tried for the data field in the Google Sheets step:

The documentation in the Builder says:

“Data — The data for append or update operations. For append_row, pass a list of values (e.g., ["value1", "value2"]). Supports {variable} substitution. Placeholder: e.g., {dataset} or ["{nombre}", "{precio}"]”

Based on this documentation, I tried all of the following:

Attempt data value Result Export
1 {read_project_dataset_2_records} :cross_mark: Trigger chain fails :cross_mark: Export crashes
2 [{read_project_dataset_2_records}] :cross_mark: Trigger chain fails :cross_mark: Export crashes
3 ["{url}", "{page_source}"] :cross_mark: Trigger chain fails :cross_mark: Export crashes
4 "data": ["${url}", "${page_source}"] :cross_mark: Trigger chain fails :cross_mark: Export crashes
5 ["${url}", "${page_source}"] :cross_mark: Trigger chain fails :cross_mark: Export crashes
6 ["url", "page_source"] :white_check_mark: Succeeds, but writes literal strings “url” and “page_source” to Google Sheets — not the actual data :white_check_mark: Export works

Attempts 1–5 follow the documentation examples, but none of them work. Attempt 6 succeeds but only sends static field names instead of actual values. The Export button was also crashing during attempts 1–5, and only started working again with attempt 6 — confirming that the crash was caused by the invalid data format, not by the software itself.


The actual error (captured via terminal spy mode):

I ran RTILA from the terminal to capture the engine output. Here’s the exact error when using {read_project_dataset_2_records} as the data value:


Error: Google API Error: Invalid value at 'data.values[0]' (type.googleapis.com/google.protobuf.ListValue), "[[{'url': 'www.instagram.com/ldlc/p/DdWAIfUlnCu/', 'page_source': 'https://www.ledemondujeu.com/concours-instagram-1.html'}, {'url': 'www.instagram.com/campinginternationalgiens/p/Dc1TG2Rjw9J/', 'page_source': 'https://www.ledemondujeu.com/concours-instagram-1.html'}, ...]]"

What’s happening: The read_project_dataset step produces an array of objects (dicts):

python
[
  {'url': 'www.instagram.com/...', 'page_source': 'https://www.ledemondujeu.com/...'},
  {'url': 'www.instagram.com/...', 'page_source': 'https://www.ledemondujeu.com/...'},
  ...
]

But the Google Sheets API expects a list of lists (rows of simple values):

python
[
  ["www.instagram.com/...", "https://www.ledemondujeu.com/..."],
  ["www.instagram.com/...", "https://www.ledemondujeu.com/..."],
  ...
]

So the data format from read_project_dataset is incompatible with what the google_sheets append_row operation expects.


Additional observation:

When the data field contains {read_project_dataset_2_records}, the engine also logs this warning about the gcp_credentials_json field:


Warning: Unresolved variable placeholder: { "type": "service_account", ... } — this will be passed as literal text.
Available keys: [name, _dataset_fields, launch_project_3_queue_id, read_project_dataset_2_records]

It seems the engine interprets the { in the JSON credentials as a variable placeholder. This doesn’t block authentication (the credentials are passed through), but it’s worth noting.

I notice also, in read project, Dataset name is not saved when I edit the workflow.

Watch Video

and also, rest api, no data are saved

Thank you so much for the detailed breakdown, logs and context regarding the Google Sheets integration, dataset names, and REST API issues. This is very helpful!

Update 8.3.214 is now live and includes fixes addressing these points. Could you please update to this new version and confirm if everything is working smoothly on your end now?

Thanks again for your support and for helping us improve RTILA!

Saving Data in read_project_dataset works, but not in rest-api.

I still have a failure to export data to Google Sheets. Can you make an example to use with the Trigger Chain Example.

Thanks for your feedback Alexandre.

I can confirm that we managed to fix the issues with exporting data to Google Sheets and the rest-api trigger. Your regular configuration should work seamlessly with the upcoming release on October 1.

Apologies for the delay! Due to deployment complications, the October 1 version was released today: Release RTILA X 8.3.216 · rtila-corporation/rtila-releases · GitHub

No problem! I tested, and append_rows works great. And saving data also. Thank you !

I have some issues understanding use cases of append_row.

Or this text
For append_row: a flat list of scalars, e.g. [“value1”, “value2”]. WARNING;
per-field placeholders like [“{url)”, “{price)”] only resolve in project post-
execution (iterate) runs, where each scraped record is injected
individually; in a standalone trigger chain there is no per-record context

  • always pass the whole record list to append_rows instead.

Hi Alexandre,

Regarding that text and the use cases for append_row, we were actually working on some serious refactoring behind the scenes. This time, we’ve made sure not to break anything and we will soon be sharing a detailed example for append_row along with the most common features of the new trigger chain to make it all much clearer!