> ## Documentation Index
> Fetch the complete documentation index at: https://unstructured-53-docs-243-plugins.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Google Cloud Storage
If you're new to Unstructured, read this note first.
Before you can create a source connector, you must first [sign up for Unstructured](https://platform.unstructured.io) and get your
Unstructured API key. After you sign up, the [Unstructured user interface](/ui/overview) (UI) appears, which you use to get the key.
To learn how, watch this 40-second [how-to video](https://www.youtube.com/watch?v=FucugLkYB6M).
After you create the source connector, add it along with a
[destination connector](/api-reference/workflow/destinations/overview) to a [workflow](/api-reference/workflow/overview#workflows).
Then run the worklow as a [job](/api-reference/workflow/overview#jobs). To learn how, try out the
[hands-on Workflow Endpoint quickstart](/api-reference/workflow/overview#quickstart),
go directly to the [quickstart notebook](https://colab.research.google.com/drive/13f5C9WtUvIPjwJzxyOR3pNJ9K9vnF4ww),
or watch the two 4-minute video tutorials for the [Unstructured Python SDK](/api-reference/workflow/overview#unstructured-python-sdk).
You can also create source connectors with the Unstructured user interface (UI).
[Learn how](/ui/sources/overview).
If you need help, reach out to the [community](https://short.unstructured.io/pzw05l7) on Slack, or
[contact us](https://unstructured.io/contact) directly.
You are now ready to start creating a source connector! Keep reading to learn how.
Ingest your files into Unstructured from Google Cloud Storage.
The requirements are as follows.
* A Google Cloud service account. [Create a service account](https://cloud.google.com/iam/docs/service-accounts-create#console).
* A service account key for the service account. See [Create a service account key](https://cloud.google.com/iam/docs/keys-create-delete#creating) in
[Create and delete service account keys](https://cloud.google.com/iam/docs/keys-create-delete).
To ensure maximum compatibility across Unstructured service offerings, you should give the service account key information to Unstructured as
a single-line string that contains the contents of the downloaded service account key file (and not the service account key file itself).
To print this single-line string without line breaks, suitable for copying, you can run one of the following commands from your Terminal or Command Prompt.
In this command, replace `` with the path to the service account key file that you downloaded by following the preceding instructions.
* For macOS or Linux:
```text theme={null}
tr -d '\n' <
```
* For Windows:
```text theme={null}
(Get-Content -Path "" -Raw).Replace("`r`n", "").Replace("`n", "")
```
* The URI for a Google Cloud Storage bucket. This URI consists of the target bucket name, plus any target folder within the bucket, expressed as `gs://[/folder-name]`. [Create a bucket](https://cloud.google.com/storage/docs/creating-buckets#console).
This bucket must have, at minimum, one of the following roles applied to the target Google Cloud service account:
* `Storage Object Viewer` for bucket read access.
* `Storage Object Creator` for bucket write access.
* The `Storage Object Admin` role provides read and write access, plus access to additional bucket operations.
To apply one of these roles to a service account for a bucket, see [Add a principal to a bucket-level policy](https://cloud.google.com/storage/docs/access-control/using-iam-permissions#bucket-add)
in [Set and manage IAM policies on buckets](https://cloud.google.com/storage/docs/access-control/using-iam-permissions).
To create a Google Cloud Storage source connector, see the following examples.
```python Python SDK theme={null}
import os
from unstructured_client import UnstructuredClient
from unstructured_client.models.operations import CreateSourceRequest
from unstructured_client.models.shared import (
CreateSourceConnector,
SourceConnectorType,
GCSSourceConnectorConfigInput
)
with UnstructuredClient(api_key_auth=os.getenv("UNSTRUCTURED_API_KEY")) as client:
response = client.sources.create_source(
request=CreateSourceRequest(
create_source_connector=CreateSourceConnector(
name="",
type=SourceConnectorType.GCS,
config=GCSSourceConnectorConfigInput(
service_account_key="",
remote_url="",
recursive=
)
)
)
)
print(response.source_connector_information)
```
```bash curl theme={null}
curl --request 'POST' --location \
"$UNSTRUCTURED_API_URL/sources" \
--header 'accept: application/json' \
--header "unstructured-api-key: $UNSTRUCTURED_API_KEY" \
--header 'content-type: application/json' \
--data \
'{
"name": "",
"type": "gcs",
"config": {
"service_account_key": "",
"remote_url": "",
"recursive":
}
}'
```
Replace the preceding placeholders as follows:
* `` (*required*) - A unique name for this connector.
* `` (*required*) - The contents of a service account key file, expressed as a single string without line breaks, for a Google Cloud service account that has the required access permissions to the bucket.
* `` (*required*) - The URI for the Google Cloud Storage bucket and any target folder path within the bucket. This URI takes the format `gs://[/folder-name]`.
* For `recursive` (source connector only), set to `true` to ingest data recursively from any subfolders, starting from the path specified by ``. The default is `false` if not otherwise specified.