Method: mediaItems.patch

Update the media item with the specified id. Only the id and description fields of the media item are read. The media item must have been created by the developer via the API and must be owned by the user.

HTTP request

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/{mediaItem.id}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
mediaItem.id

string

Identifier for the media item. This is a persistent identifier that can be used between sessions to identify this media item.

Query parameters

Parameters
updateMask

string (FieldMask format)

Required. Indicate what fields in the provided media item to update. The only valid value is description.

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 the following OAuth scope:

  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata