Updates an object's metadata. Try it now .
The authenticated user must have
OWNER
permissions on the object.
Request
HTTP request
PUT https://www.googleapis.com/storage/v1/b/bucket/o/object
Parameters
Parameter name | Value | Description |
---|---|---|
Path parameters | ||
bucket
|
string
|
Name of the bucket in which the object resides. |
object
|
string
|
Name of the object. |
Optional query parameters | ||
generation
|
long
|
If present, selects a specific revision of this object (as opposed to the latest version, the default). |
ifGenerationMatch
|
long
|
Makes the operation conditional on whether the object's current generation matches the given value. |
ifGenerationNotMatch
|
long
|
Makes the operation conditional on whether the object's current generation does not match the given value. |
ifMetagenerationMatch
|
long
|
Makes the operation conditional on whether the object's current metageneration matches the given value. |
ifMetagenerationNotMatch
|
long
|
Makes the operation conditional on whether the object's current metageneration does not match the given value. |
predefinedAcl
|
string
|
Apply a predefined set of access controls to this object.
Acceptable values are:
|
projection
|
string
|
Set of properties to return. Defaults to
full
.
Acceptable values are:
|
Request body
In the request body, supply an object resource with the following properties:
Property name | Value | Description | Notes |
---|---|---|---|
Required Properties | |||
acl[]
|
list
|
Access controls on the object. | writable |
contentType
|
string
|
Content-Type of the object data. | writable |
Optional Properties | |||
cacheControl
|
string
|
Cache-Control directive for the object data. | writable |
contentDisposition
|
string
|
Content-Disposition of the object data. | writable |
contentEncoding
|
string
|
Content-Encoding of the object data. | writable |
contentLanguage
|
string
|
Content-Language of the object data. | writable |
metadata
|
object
|
User-provided metadata, in key/value pairs. | writable |
metadata.
(key)
|
string
|
An individual metadata entry. | writable |
Response
By default, this responds with an
object resource
in the response body. If you provide the URL parameter
alt=media
, then it will respond with the object data in the response body.
Try it!
Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer .