REST Resource: mediaItems

    • This content describes the structure and metadata of media items, specifically photos, used in Google Photos for ambient display.

    • AmbientMediaItem represents a photo in Google Photos, with fields for its ID, creation time, and associated MediaFile .

    • MediaFile provides access to the media bytes via a base URL, along with its MIME type and associated MediaFileMetadata .

    • MediaFileMetadata details the media file's properties, such as dimensions, camera information, and includes a union field metadata that contains specific metadata like PhotoMetadata .

    • PhotoMetadata contains detailed information about photos, including focal length, aperture, ISO, and exposure time.

    Resource: AmbientMediaItem

    Representation of a photo in Google Photos being used for ambient display.

    JSON representation 
     { 
 "id" 
 : 
 string 
 , 
 "createTime" 
 : 
 string 
 , 
 "mediaFile" 
 : 
 { 
 object (  MediaFile 
 
) 
 } 
 }
    Fields
    id

    string

    Identifier for the media item.

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

    string ( Timestamp format)

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

    Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .
    mediaFile

    object ( MediaFile )

    The media file that constitutes this media item.

    MediaFile

    Representation of an individual file of media bytes.

    JSON representation 
     { 
 "baseUrl" 
 : 
 string 
 , 
 "mimeType" 
 : 
 string 
 , 
 "mediaFileMetadata" 
 : 
 { 
 object (  MediaFileMetadata 
 
) 
 } 
 }
    Fields
    baseUrl

    string

    A URL to fetch the media file's bytes.

    To download a media file, the API client must add the parameters specified in the developer documentation to this URL.
    mimeType

    string

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

    object ( MediaFileMetadata )

    Metadata related to the media file, such as height and width.

    MediaFileMetadata

    Metadata about a media file.

    JSON representation 
     { 
 "width" 
 : 
 integer 
 , 
 "height" 
 : 
 integer 
 }
    Fields
    width

    integer

    Original width (in pixels) of the media file.
    height

    integer

    Original height (in pixels) of the media file.

    Methods

    list

    		Returns a list of ambient media items from user-configured media sources for the specified device.
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: