> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-data-file/google-cloud-storage.md).

# Google Cloud Storage

You can import an XML, CSV, TXT, or JSON file directly from your Google Cloud Storage (GCS).

{% stepper %}
{% step %}

### Your data source and Import settings

* In Channable, go to **Setup > Import** and click **+ Choose import method** (or <i class="fa-plus">:plus:</i> **Combine imports** if you added an import in this project).
* Select the file type you need: XML, CSV, TXT, or JSON.
  {% endstep %}

{% step %}

* At **Name**, add a name for your import.
* At **\[type of] file url**, paste your GCS file URL from Google Cloud.
  * Make sure your URL starts with “`https://storage.cloud.google.com`”.
* At **Authentication**, select "Google Cloud Storage (GCS)".
* For **Upload GCS Service Account Key file**, create and download a Service Account key file [using Google Cloud](https://cloud.google.com/iam/docs/keys-create-delete#iam-service-account-keys-create-console). Once you have created the file, upload it.
* For **Encoding**, **Quoting** and **Delimiter**, select "Automatically detect".
* Click **Run import**.&#x20;

{% hint style="warning" %}
For security reasons, make sure that your Google Service Account has as few permissions as necessary. For example, make sure the account only allows read access for the files you want to import.
{% endhint %}

<figure><img src="/files/6LDTuPfwmtjNHeuDAQKP" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If a file in GCS is available publicly, you do not need to set up authentication (Check **Public URL** in Google Cloud). You can select “No authentication” at **Authentication**.
{% endhint %}

<figure><img src="/files/e656d22ae5cf90a9d36bb93db71241c929af7bac" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Import mapping

This page displays fields retrieved from your data feed (e.g. price, description, title).

* **Imported data field:** Fields from your import data.
* **Project field:** Corresponding project fields in Channable. Our system will automatically detect and link most fields to standardized fields.

Match (map) your imported fields to a corresponding project field. Channable does most mapping automatically, but it's important to review and adjust before importing.

{% hint style="info" %}
Note: We create new project fields if we can't assign your import field to a standardized field. These fields will have a project field with the same name as your import field.
{% endhint %}

#### Before you continue

{% hint style="info" %}

* Compare and adjust mapping:

  Review your **Imported data fields** against Channable's matched **Project fields**. If a field was matched incorrectly, click on the field to select a different field.
* Check and correct field types:

  Check that the right field type is assigned to your project fields. If a field has the wrong type, click **Edit** next to the field, select the correct type in the dropdown, and click **Save & Import**.
* Exclude fields (optional):

  To exclude a field from being included in your product data, click the checkbox in the **Select** column for that field and click **Do not import selected fields**.
  {% endhint %}

Once you've finished mapping, click **Save & Import** to start importing your product data. Depending on how much data you're importing, it can take a while to finish.

{% hint style="info" %}
**Note:** Check the **Status** column in **Setup** to check your import progress. Your product data is fully imported when the Status is **Finished**.
{% endhint %}

Your data will start importing from Google Cloud Storage.
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-data-file/google-cloud-storage.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.