Updates metadata of the specified media item. This can only be used to update the Category of a media item, with the exception that the new category cannot be COVER or PROFILE.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



The name of the media item to be updated.

Query parameters


string (FieldMask format)

The specific fields to update. If no mask is specified, then this is treated as a full update and all editable fields are set to the values passed in.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Request body

The request body contains an instance of MediaItem.

Response body

If successful, the response body contains an instance of MediaItem.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the OAuth 2.0 Overview.