# Google Cloud Storage

{% content-ref url="/pages/JLXUpZth4snbz5bN2rmy" %}
[GCS Metadata Extracted](/integrations/data-lakes/google-cloud-storage/gcs-metadata-extracted.md)
{% endcontent-ref %}

## Getting started with Google Cloud Storage

There are 3 steps to connect Google Cloud Storage with Secoda

1. Create a service account for Secoda
2. Create access key
3. Connect Google Cloud Storage to Secoda

### Create a service account for Secoda <a href="#h_f7ed2acb85" id="h_f7ed2acb85"></a>

To provide [least privilege](https://en.wikipedia.org/wiki/Principle_of_least_privilege) to Secoda for extracting Google Cloud Storage metadata, you can create a new service account following the steps below.

Refer to [Google Cloud’s documentation about service accounts](https://cloud.google.com/iam/docs/creating-managing-service-accounts) for more information.

1. From the Navigation panel on the left, go to **IAM & admin** > **Service accounts**
2. Click **Create Service Account** along the top
3. Enter a name (for example: “secoda”) and click **Create**
4. When assigning permissions, make sure to grant the following permission:

a) If you're creating the service account via the GCP console add the following role:

```
Storage Object Viewer
```

b) If you're programatically creating the service account add the following role:

```
roles/storage.objectViewer
```

### Create access key

On the GCP console, goto **Cloud Storage** and navigate to **Settings** on the panel on the left. Click on the **Interoperability** tab.

Generate HMAC keys for the newly created service account. Access key and the secret will be used to connect GCS to Secoda.

<figure><img src="https://secoda-public-media-assets.s3.amazonaws.com/d4c613ef-314d-4b74-860a-14b96da148da.png" alt=""><figcaption></figcaption></figure>

### Connect Google Cloud Storage to Secoda

1. In Secoda, head to the **Integrations** page and click **New Integration**
2. Find **Google Cloud Storage** under **Data Storage**
3. Fill in the connection form with the Access Key and the Secret that were previously generated. Also, provide the name of the GCS bucket from which metadata is extracted
4. Click **Test Connection** to make sure everything is correct
5. Head to the **Sync History** tab on the side bar and click **Run sync**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.secoda.co/integrations/data-lakes/google-cloud-storage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.