Return files destination uris in all ToGCS operators

@shahar1

Description

Currently some storage operators return files destination uris list for example GoogleSheetsToGCSOperator. It would be a good idea to make all of such operators to return this list.

Use case / motivation

Having list of destination uris for files transferred with operator is useful for debugging and troubleshooting
Inconsistent operator behaviour might be confusing for users.

Edit (by @shahar1 on Jan. 31, 2026)
For operators that currently return a single entity, add the flag unwrap_single which controls whether the returned value is either list[obj] or obj (usually obj is str but could also be a dict). Until we apply consistency for all operators (unwrap_single=False), which will be a breaking change - set for now the default to return the single entity (unwrap_single=True).

Tracking (added by @shahar1 on Jan. 24, 2026)

All operators should return list[str] of destination URIs (gs://bucket/object).

To Do (Generated by AI, please double check if current situation is as described)

Thanks for opening your first issue here! Be sure to follow the issue template!

This issue spawn from #10991 (comment)
It probably can be useful but it's also a breaking change and so far I didn't see users complaining about it.
Could you please clarify the TODO part on this issue?
What operators need adjustments? Is it localized to GCP or also other providers?

Yeah I don’t see how this could break user code in practice. Should be doable.

@FHoffmannCode

Yeah. Nice feature to add. Would you like to implement it @FHoffmannCode ? Should I assign it to you ?

Yeah I don’t see how this could break user code in practice.

The suggestion was to change the returned value to make operators consistent. If changed then the value pushed to xcom is not as users are expecting.

It depends on what are correctly being returned; I’m assuming most (if not all) are currently returning None, which won’t have backward compatibility issues (except if someone is depending on an XCom is not pushed, but why would anyone do that). Are there instances of an operator currently pushing something else?

Yeah. Same here. I think it's no harm to return "more".

This issue has been automatically marked as stale because it has been open for 30 days with no response from the author. It will be closed in next 7 days if no further activity occurs from the issue author.

@yuseok89

@yuseok89 We are unassigning you from this issue as part of our updated assignment policy.

This is not meant to discourage your contribution — quite the opposite! You are still very welcome to work on this issue and submit a PR for it. Simply comment that you are working on it and open a PR when ready.