[[TOC()]]

= [wiki:help/en Cyberduck Help] / [wiki:help/en/howto Howto] / Google Storage =

[http://code.google.com/apis/storage/ Google Storage for Developers] is a S3 compatible service currently in development and open by invitation only. Support must be enabled first using a [wiki:help/en/howto/preferences#Hiddenconfigurationoptions hidden configuration] option using `defaults write ch.sudo.cyberduck protocol.gstorage.tls.enable true` using the latest [http://update.cyberduck.ch/nightly/ snapshot build].

Refer also to [wiki:help/en/howto/s3 S3] in general.

== Connecting to Google Storage ==

You must obtain the login credentials (''Access Key'' and ''Secret'') of your Google Storage [https://sandbox.google.com/storage Account] from the ''Key Management'' [https://sandbox.google.com/storage/m/ page]. In the login prompt of Cyberduck upon connecting to Google Storage you enter the ''Access Key'' for the username and ''Secret'' for the password.

== Folders ==

Creating a folder inside a bucket will create a placeholder object named after the directory, has no data content and the mimetype `application/x-directory`. 

== Files ==

=== Metadata ===

You can edit standard HTTP headers [wiki:help/en/howto/info#MetadataHTTPheaders add] custom HTTP headers to files to store [http://docs.amazonwebservices.com/AmazonS3/latest/index.html?UsingMetadata.html metadata]. Choose ''File → Info → Google Storage'' to edit headers.

== ACLs ==

=== Granting access to selected users ===

You can give access to a specific user to a document by granting `READ` access to the email address registered with Google. The ''Signed URL'' from the ''Google Storage'' tab in the ''Info'' window with the format `https://sandbox.google.com/storage/<container>/<file>` will verify access to the resource using the Google Account login credentials.

Refer also to [http://sudo.ch/2010/08/09/sharing-files-using-google-storage/ Sharing files using Google Storage].

== Limitations ==

 * Storage class options are [http://code.google.com/apis/storage/docs/faq.html#policy not available]. Currently, data is stored in U.S. data centers only.
 * No content distribution ([wiki:help/en/howto/cdn CDN]) configuration.
 * No bucket logging configuration.
 * Storage class options are not available.
 * Torrent URLs are not supported.

== Issues ==

 * ~~Editing metadata is currently giving service errors.~~

'''Please [http://trac.cyberduck.ch/newticket report] any incompatibilities you encounter and provide [mailto:feedback@cyberduck.ch feedback] if you have access to the service.'''

== References ==

 * [http://code.google.com/apis/storage/docs/faq.html Google Storage for Developers Frequently Asked Questions]