> For the complete documentation index, see [llms.txt](https://docs.onum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onum.com/listeners-changelog/google-cloud-storage-listener.md).

# Google Cloud Storage Listener

{% hint style="warning" %}
Note that this Listener is only available in certain Tenants. [Get in touch with us](broken://spaces/cSjT21I4EUhzghjc1rER/pages/nW8oZycpfVthtI5KYdQs) if you don't see it and want to access it.
{% endhint %}

Learn more about this Listener type in [this article](/listeners/listener-integrations/collect-data-from-google-cloud-storage.md).

<details>

<summary>v1.0.3</summary>

<mark style="background-color:purple;">**Released on**</mark> <mark style="background-color:purple;"></mark><mark style="background-color:purple;">06/03/2026</mark>

* Fixed incorrect deserialization of the GCS object size field. The GCS JSON API returns this value as a quoted string; the field type has been changed from `int64` to `uint64` to correctly represent the unsigned value.
* Fixed infinite Pub/Sub redelivery loop on permanent errors. Size limit exceeded, int64 overflow, corrupt compressed data (gzip/bzip2/zip), and oversized scanner tokens are now `acked` instead of `nacked`. Transient errors (network, I/O) continue to be `nacked` for retry.

</details>

<details>

<summary>v1.0.2</summary>

<mark style="background-color:purple;">**Released on**</mark> <mark style="background-color:purple;"></mark><mark style="background-color:purple;">03/17/2026</mark>

We added an error port to keep events even when an error occurs.

</details>

<details>

<summary>v1.0.1</summary>

<mark style="background-color:purple;">**Released on**</mark> <mark style="background-color:purple;"></mark><mark style="background-color:purple;">06/26/2025</mark>

* New option to read files as a stream into a buffer instead of loading them into memory.
* Added support for compression types.

</details>

<details>

<summary>v1.0.0</summary>

<mark style="background-color:purple;">**Released on**</mark> <mark style="background-color:purple;"></mark><mark style="background-color:purple;">05/22/2025</mark>

* Polling has been removed.
* Google Storage notifications using Pub/Sub added.
* In order to use this Listener, you must activate the environment variable in your distributor using docker compose (`GOOGLE_CLOUD_STORAGE_LISTENER_EXECUTION_ENABLED`)

</details>

<details>

<summary>v0.0.1</summary>

<mark style="background-color:purple;">**Released on**</mark> <mark style="background-color:purple;"></mark><mark style="background-color:purple;">14/02/2025</mark>

Initial version.

</details>