Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)



Google Developers Console

Use the Google Developers Console to perform simple storage management tasks on the Google Cloud Storage system. Some typical uses for Google Developers Console include:

  • Enabling the Google Cloud Storage API for a project
  • Creating and deleting buckets
  • Uploading, downloading, and deleting objects
  • Managing access control lists (ACLs) for objects and buckets

This guide discusses how to access Google Developers Console and how to use it to manage your data.

You can also accomplish all the tasks discussed here using the gsutil command line tool or any of the libraries that support Google Cloud Storage.

Contents

Accessing Google Developers Console

Google Developers Console requires no setup or installation and you can access it directly in a browser. Depending on your use case, you access Developers Console in slightly different ways. If you are:

A project member

Use: https://console.developers.google.com/

In order to use Google Developers Console as a project member, you must be added to the project’s member list. A current project owner can give you owner, editor, or viewer access to the project which applies to all buckets defined in the project. For more information, see Adding a member to a project .

A user granted read or write access to a bucket

Use: https://console.developers.google.com/storage/ <bucket-name> /

In this use case, a project owner or editor gives you read or write access to a bucket and then sends you the bucket name which you substitute into the URI above. You will be able to only work with objects in the specified bucket. This use case is useful for users who are not project members, but who need to access a bucket. This URL will prompt you to authenticate with a Google account if you are not already signed in.

A variation of this use case is when a project owner or editor grants Reader permission to the bucket entity All Users . This creates a bucket whose contents are publicly readable.

A user viewing or downloading a public object

Use: https://storage.cloud.google.com/ <bucket-name> / <object-name>

In this use case, a project owner or editor configures an object as publicly viewable and sends you the URL to access the object. This URL will prompt you to authenticate with a Google account if you are not already signed in.

Compare the form of the URL above ( storage.cloud.google.com ) with the one shown in the Sharing your data publicly instructions. When you share a link publicly, the URL is of the form: https://storage.googleapis.com/ <bucket-name> / <object-name> . This URL does not require a recipient to authenticate with Google and can be used for non-authenticated access to an object.

To access a storage project as a project member:

  1. Go to the Google Developers Console, https://console.developers.google.com/ .
  2. Select the name of the project to go to an overview of the project.
  3. If you haven't already, set up billing for a project by clicking Billing & Settings in the left sidebar, and then clicking Enable billing .
  4. In the left sidebar, expand the STORAGE section, click CLOUD STORAGE , and then click Storage browser to list the buckets for the project or create a new bucket.

Using Google Developers Console to Manage Your Data

Google Developers Console enables you to perform basic storage management tasks on your data through a simple interface, including:

Creating a bucket

Google Cloud Storage uses a flat namespace to store your data but you can use Google Developers Console to create folders and mimic a folder hierarchy. Your data isn't physically stored in a hierarchical structure, but is displayed like that in Developers Console.

Because Google Cloud Storage has no notion of folders, the folder suffix and object name delimiters are visible when you view your folders using gsutil or any other command-line tools that may work with Google Cloud Storage. You can use many tools to manage your data but there are some differences between Google Developers Console and command-line tools like gsutil that you should be aware of.

To create a bucket

  1. In the Developers Console , click New Bucket .

  2. In the New Bucket dialog, enter a name and click Create .

    For information about acceptable bucket names, see Bucket Name Requirements .

Back to top

Uploading data to a bucket

You can upload data to your bucket by uploading one or more files or a folder containing files. When you upload a folder, Google Developers Console maintains the same hierarchical structure of the folder, including all of the files and folders it contains. You can track the progress of uploads to Developers Console using the upload progress window. You can minimize the progress window and continue working with your bucket.

Before you upload objects to your bucket, review the Object Name Requirements .

To upload data to a bucket

  1. In the Developers Console , click New Bucket .

  2. In the New Bucket dialog, enter a name and click Create .

    For information about acceptable bucket names, see Bucket Name Requirements .

To upload data to a bucket by dragging and dropping files

  1. In Google Developers Console, navigate to the location in the bucket where you want to put the content.
  2. From your desktop or file manager tool, select one or more files to upload.
  3. Drag the selected items to the object list in Developers Console and release.

Back to top

Downloading data from a bucket

You can download data from your bucket, directly from your browser, by placing the cursor over the object's name, right clicking, and selecting the option to save the object. For example, the following example demonstrates downloading an image using the Google Chrome browser.

If you click an object's name, your browser will try to display the object if it can; otherwise, your browser will download the object or prompt you to download it.

Back to top

Creating and using folders

Because the Google Cloud Storage system has no notion of folders, folders created in Google Developers Console are a convenience to help you organize objects in a bucket. As a visual aid, Google Developers Console shows folders with a folder icon image to help you distinguish folders from objects.

To create a folder

  1. In the Developers Console , navigate to a bucket or existing folder in a bucket where you want to create a new folder.
  2. Click New Folder .

  3. In the New Folder dialog, provide a name for the folder.

  4. Click the folder icon to navigate into the folder.

  5. At this point, you can:
    • Upload data into the folder or create a new folder.
    • Navigate up to the container of the folder by clicking the container name in the breadcrumb trail. In the following example, the container of the folder is the bucket root.

Working with folders in gsutil

When you use other tools to work with your buckets and data, the presentation of folders may be different than in Google Developers Console. For example, when you list the same folder created in the preceding steps using gsutil , you see that the folder name is part of the object name.

$ gsutil ls gs://example-bucket
gs://example-bucket/archive

Back to top

Deleting objects, folders, and buckets

You can delete any folder or object in Google Developers Console by selecting the checkbox next to it and clicking the delete button. When you delete a folder, you also delete all objects inside it. Note that even objects marked as SHARED PUBLICLY are deleted without a prompt from Google Cloud Storage to confirm your choice.

To delete objects and folders.

Deleting buckets

In order to delete a bucket, you need to delete all folders and objects within that bucket. Google Developers Console prevents you from deleting a bucket with existing objects and displays a warning if you try to.

Note: You can also use gsutil to delete objects and buckets, but you must use Google Developers Console to remove folders.

Back to top

Sharing your data publicly

With Google Developers Console, you can share your objects easily with others by making it publicly accessible. You do this by selecting the checkbook in the SHARED PUBLICLY column for the object. When you share an object publicly, a link appears in the SHARED PUBLICLY column which is suitable for sharing. The sharable link references your objects using the storage.googleapis.com domain which is different than the domain used in Developers Console to navigate in a bucket. For example, for a bucket named example-bucket and an object named image1.JPG , the public link to share the object is http://storage.googleapis.com/example-bucket/image1.JPG .

Note: If you do not use the SHARED PUBLICLY link and instead right-click on an object and share the URL address to the object, then this URL will redirect users to sign in.

To share an object publicly

  1. In the Developers Console , click Upload and select Files or Folder .

  2. In the file dialog, select one or more files or a folder to upload, depending on your selection in the previous step.
  3. Click Open to start the upload process.
  4. A window showing the upload progress is displayed. You can minimize this window and the upload will continue.

To stop sharing an object publicly

You can stop publicly sharing an object in two ways: by deselecting the checkbox in the SHARED PUBLICLY column or by accessing the Objects Permissions dialog box. The latter approach is shown below to highlight what permissions are changed when you stop sharing an object.

  1. In Developers Console, select the object by selecting the checkbox next to the object's name.

  2. Click Object Permissions .
  3. In the permissions dialog, choose None for All Users .

  4. Click Save .

Back to top

Setting object permissions and metadata

You can control access to your Google Cloud Storage object data by using Access Control Lists (ACLs) and Signed URLs . In the Developers Console, you can view and configure an object's ACLs. In addition to ACLs, you can also configure an object's metadata in Developers Console. An object's metadata controls aspects of how requests are handled, including what type of content your data represents and how your data is encoded.

You can only set permissions and metadata on one object at a time. You cannot set permissions and metadata on a folder.

To view or change object permissions

  1. In Developers Console, select the object for which you want to set permissions by checking the box next to the object.
  2. To view or change object permissions, select the Object Permissions .

  3. In the permissions dialog, make changes to the permissions. For example, you can change an existing ACL by changing its permission or add a new permission.

  4. Click Save to save your permission changes.

To view or change object metadata

  1. In Developers Console, select the object for which you want to set metadata by checking the box next to the object.
  2. To view or change object metadata, select Metadata .

  3. In the metadata dialog, make changes to the metadata. For example, you can change values of existing metadata, add new metadata, or remove existing metadata.

  4. Click OK to save your metadata changes.

Back to top

Filtering objects to view

In the Google Developers Console, you can filter the objects you see by specifying a prefix that is used to match the names of objects to display. The prefix filters objects to display only for your current bucket view, that is, the prefix does not select for objects contained in folders.

To view or change object permissions

  1. In Developers Console, type a prefix value in the filter box.

  2. To remove the filter, clear the filter box.

Back to top

Adding a member to a project

If you are a not a project owner or a member of a project, you must be added to the project's member list in order to work with its associated buckets and objects. Once you have been added to the member list of the project, the project name appears in your list of projects. If you are an existing project owner, you can add a member to your project using the following steps.

To add a member to a project

  1. In a browser, navigate to https://console.developers.google.com/ .
  2. Select the project to which to add a member.
  3. In the left sidebar, click Permissions .

  4. Click Add Member .
  5. In the Add Member dialog specify the email address of the new team member.

  6. Set the appropriate permission for the team member.

    In general, set the minimum permission possible while still giving the team member the required access. For example, if the team member needs to only read from a project's bucket, then select the Can view permission. Similarly, if the team member needs to read and write to a project's bucket, then select Can edit . Select the Is owner permission only if the team member needs to change project settings and manage team members.

  7. Click Add .

Back to top

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.