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)



ObjectAccessControls: patch

Updates an ACL entry on the specified object . This method supports patch semantics. Try it now or see an example .

The invoking user must have FULL_CONTROL of the object to use this method.

Request

HTTP request

PATCH https://www.googleapis.com/storage/v1beta2/b/bucket/o/object/acl/entity

Parameters

Parameter name Value Description
Path parameters
bucket string Name of a bucket.
entity string The entity holding the permission. Can be user- userId , user- emailAddress , group- groupId , group- emailAddress , allUsers , or allAuthenticatedUsers .
object string Name of the object.
Optional query parameters
generation unsigned long If present, selects a specific revision of this object (as opposed to the latest version, the default).

Request body

In the request body, supply the relevant portions of an ObjectAccessControls resource , according to the rules of patch semantics.

Response

If successful, this method returns an ObjectAccessControls resource in the response body.

Examples

Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).

Python

Uses the Python client library .

req = client.objectAccessControls().patch(
        bucket=bucket_name,
        object=object_name,
        entity='allAuthenticatedUsers',
        body={'role': 'OWNER'},
        fields='id,role')   # optional
resp = req.execute()
print json.dumps(resp, indent=2)

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer .

Authentication required

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

Signing you in...

Google Developers needs your permission to do that.