Accessing public data

Which method you choose to access public data depends on how you want to work with the data. When accessing public data via the Google Cloud Console, you must authenticate with Google. You can authenticate with any Google account; the account does not have to be associated with the project that contains the public data, nor does it need to be signed up for the Cloud Storage service.

By contrast, accessing public data with gsutil or a Cloud Storage API link does not require authentication. These methods are suited for general-purpose links to publicly shared data. For example, an API link can be used in a web page, with client libraries, or with a command-line tool such as cURL.

To access public data:

Console

Note: If only individual objects in a bucket are public, and not the entire bucket, you should generally use the method described in the API link tab. You can only access public objects via the Cloud Console if you have storage.objects.list permission for the bucket that contains the objects.

1. Get the name of the public bucket.

2. Using a web browser, access the bucket with the following URI (you will be asked to sign in if necessary):

   https://console.cloud.google.com/storage/browser/[BUCKET_NAME]

For example, the Google public bucket gcp-public-data-landsat contains the Landsat public dataset. You can access the bucket with:

https://console.cloud.google.com/storage/browser/gcp-public-data-landsat

gsutil

1. If you don't have gsutil, follow these instructions to install gsutil.

2. Get the name of the bucket containing the public data.

3. If the bucket is public (and not just some of the data within it), you can list some or all of the data (objects) contained in the bucket by using the ls command.

   For example, the Google public bucket gcp-public-data-landsat contains the Landsat public dataset. You can list files with the prefix LC08/PRE/063/046/LC80630462016 with the command:

   gsutil ls -r gs://gcp-public-data-landsat/LC08/PRE/063/046/LC80630462016*

4. Get specific public objects contained in the bucket by using the cp command.

   For example, the following command downloads a file from the bucket gcp-public-data-landsat to your local directory:

   gsutil cp gs://gcp-public-data-landsat/LC08/PRE/063/046/LC80630462016136LGN00/LC80630462016136LGN00_B11.TIF .

API Link

1. Get the name of the bucket containing the public data.

2. Use the following URI to access an object in the bucket:

   https://storage.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]

For example, the Google public bucket gcp-public-data-landsat contains the Landsat public dataset. You can link to the publicly shared object LC08/PRE/063/046/LC80630462016136LGN00/LC80630462016136LGN00_B11.TIF with the link:

https://storage.googleapis.com/gcp-public-data-landsat/LC08/PRE/063/046/LC80630462016136LGN00/LC80630462016136LGN00_B11.TIF

This link does not require authentication in order to use. It is suitable, for example, as a link in a web page, or for downloading with a command-line tool such as cURL.

What's next

• Learn how to publicly share an object.
• Learn about options to control access to your data.
• Control access to your data using Cloud IAM permissions.
• Download objects from a bucket.