Manipulate access control lists that Cloud Storage provides.

Bucket has a getting method that createsan ACL object under the hood, and you can interact with that usingacl:

.. literalinclude:: snippets.py :start-after: [START client_bucket_acl] :end-before: [END client_bucket_acl]

Adding and removing permissions can be done with the following methods(in increasing order of granularity):

• ACL.allcorresponds to access for all users.
• ACL.all_authenticated correspondsto access for all users that are signed into a Google account.
• ACL.domain corresponds to access on aper Google Apps domain (ie,example.com).
• ACL.group corresponds to access on aper group basis (either by ID or e-mail address).
• ACL.user corresponds to access on aper user basis (either by ID or e-mail address).

And you are able togrant andrevoke the following roles:

• Reading:_ACLEntity.grant_read and_ACLEntity.revoke_read
• Writing:_ACLEntity.grant_write and_ACLEntity.revoke_write
• Owning:_ACLEntity.grant_owner and_ACLEntity.revoke_owner

You can use any of these like any other factory method (these happen tobe_ACLEntity factories):

.. literalinclude:: snippets.py :start-after: [START acl_user_settings] :end-before: [END acl_user_settings]