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 Platform 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

  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/[BUCKET_NAME]/

For example, for the Google public bucket uspto-pair, you can access the bucket as:

https://console.cloud.google.com/storage/uspto-pair/

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, for the Google public bucket uspto-pair, you can list files with the prefix 0800401 with the command:

    gsutil ls gs://uspto-pair/applications/0800401*

  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 uspto-pair to your local directory:

    gsutil cp gs://uspto-pair/applications/05900002.zip .

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:

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

For example, from the uspto-pair bucket, you can link to the publicly shared object, applications/05900002.zip, with the link:

http://storage.googleapis.com/uspto-pair/applications/05900002.zip

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.

For information about how to publicly share an object, see Making Your Data Public.

Send feedback about...

Cloud Storage Documentation