Google Photos Media Item

A media item resource from the Google Photos Library API representing a photo or video.

AlbumsGoogleImagesMediaPhotosSharingStorage

Properties

Name	Type	Description
id	string	Identifier for the media item.
description	string	Description of the media item.
productUrl	string	A URL to the media item in Google Photos.
baseUrl	string	A URL to the bytes of the media item.
mimeType	string	MIME type of the media item.
mediaMetadata	object	Metadata related to the media item.
filename	string	Filename of the media item.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/google-photos/refs/heads/main/json-schema/photos.json",
  "title": "Google Photos Media Item",
  "description": "A media item resource from the Google Photos Library API representing a photo or video.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Identifier for the media item."
    },
    "description": {
      "type": "string",
      "description": "Description of the media item."
    },
    "productUrl": {
      "type": "string",
      "format": "uri",
      "description": "A URL to the media item in Google Photos."
    },
    "baseUrl": {
      "type": "string",
      "format": "uri",
      "description": "A URL to the bytes of the media item."
    },
    "mimeType": {
      "type": "string",
      "description": "MIME type of the media item."
    },
    "mediaMetadata": {
      "type": "object",
      "description": "Metadata related to the media item.",
      "properties": {
        "creationTime": {
          "type": "string",
          "format": "date-time",
          "description": "Time when the media item was first created."
        },
        "width": {
          "type": "string",
          "description": "Original width in pixels of the media item."
        },
        "height": {
          "type": "string",
          "description": "Original height in pixels of the media item."
        },
        "photo": {
          "type": "object",
          "description": "Metadata for a photo media type.",
          "properties": {
            "cameraMake": {
              "type": "string"
            },
            "cameraModel": {
              "type": "string"
            },
            "focalLength": {
              "type": "number"
            },
            "apertureFNumber": {
              "type": "number"
            },
            "isoEquivalent": {
              "type": "integer"
            },
            "exposureTime": {
              "type": "string"
            }
          }
        },
        "video": {
          "type": "object",
          "description": "Metadata for a video media type.",
          "properties": {
            "cameraMake": {
              "type": "string"
            },
            "cameraModel": {
              "type": "string"
            },
            "fps": {
              "type": "number"
            },
            "status": {
              "type": "string",
              "enum": ["UNSPECIFIED", "PROCESSING", "READY", "FAILED"]
            }
          }
        }
      }
    },
    "filename": {
      "type": "string",
      "description": "Filename of the media item."
    }
  },
  "required": ["id"]
}