REST Resource: mediaItems

{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}

string

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

string

Description of the media item. This is shown to the user in the item's info section in the Google Photos app. Must be shorter than 1000 characters. Only include text written by users. Descriptions should add context and help users understand media. Do not include any auto-generated strings such as filenames, tags, and other metadata.

string

Google Photos URL for the media item. This link is available to the user only if they're signed in. When retrieved from an album search, the URL points to the item inside the album.

string

A URL to the media item's bytes. This shouldn't be used as is. Parameters should be appended to this URL before use. See the developer documentation for a complete list of supported parameters. For example, '=w2048-h1024' will set the dimensions of a media item of type photo to have a width of 2048 px and height of 1024 px.

string

MIME type of the media item. For example, image/jpeg.

object (MediaMetadata)

Metadata related to the media item, such as, height, width, or creation time.

object (ContributorInfo)

Information about the user who added this media item. Note that this is only included when using mediaItems.search with the ID of a shared album. The album must be created by your app and you must have the sharing scope.

string

Filename of the media item. This is shown to the user in the item's info section in the Google Photos app.

{
  "creationTime": string,
  "width": string,
  "height": string,

  // Union field metadata can be only one of the following:
  "photo": {
    object (Photo)
  },
  "video": {
    object (Video)
  }
  // End of list of possible types for union field metadata.
}

string (Timestamp format)

Time when the media item was first created (not when it was uploaded to Google Photos).

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

string (int64 format)

Original width (in pixels) of the media item.

string (int64 format)

Original height (in pixels) of the media item.

object (Photo)

Metadata for a photo media type.

object (Video)

Metadata for a video media type.

{
  "cameraMake": string,
  "cameraModel": string,
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}

string

Brand of the camera with which the photo was taken.

string

Model of the camera with which the photo was taken.

number

Focal length of the camera lens with which the photo was taken.

number

Aperture f number of the camera lens with which the photo was taken.

integer

ISO of the camera with which the photo was taken.

string (Duration format)

Exposure time of the camera aperture when the photo was taken.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".

{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}

string

Brand of the camera with which the video was taken.

string

Model of the camera with which the video was taken.

number

Frame rate of the video.

enum (VideoProcessingStatus)

Processing status of the video.

{
  "profilePictureBaseUrl": string,
  "displayName": string
}

string

URL to the profile picture of the contributor.

string

Display name of the contributor.