Skip to content

Google Photos Source Provider

The Google Photos Source feeds media from Google Photos supporting Album, Albums and Album Media queries.

Settings

Source Instance Common Settings

SettingDescriptionDefault
NameThe name that will identify this source instance.
Default Cache TimeThe default duration in seconds before the cache is renewed, set to 0 to disable caching. This setting can be overriden in each query configuration.3600

Google Photos Configuration

SettingDescription
AccountThe Google account which to authenticate with.

Album Query

Fetches a single album resolving to a Album Type.

SettingDescriptionDefaultDynamic
Album IDThe ID of the album to query.
CacheThe duration in seconds before the cache is invalidated and the query re-executed.3600

Album Media Query

Fetches media from a single album resolving to a list of Media Type.

SettingDescriptionDefaultDynamic
Album IDThe ID of the album to query.
TypeThe media type which to query, All, Images or Videos.All
Order ByThe order by which to query the media Date (desc) or Date (asc).Date (desc)
StartThe offset applied to the query.1
QuantityThe limit applied to the query.20
CacheThe duration in seconds before the cache is invalidated and the query re-executed.3600

Albums Query

Fetches all albums from the library resolving to a list of Album Type.

SettingDescriptionDefault
CacheThe duration in seconds before the cache is invalidated and the query re-executed.3600

Album Type

Defines the mapping options of a Google Photos Album object.

OptionDescriptionTypeFilters
IDUnique identifier of the album.String
TitleTitle of the album.StringLimit
Cover Photo URLThe album cover photo URL.String
Total Media CountThe album total amount of media.Int

Media Type

Defines the mapping options of a Google Photos Media object.

OptionDescriptionTypeFilters
IDOpaque identifier of the media.String
URLThe path to the locally cached media file, with optionall arguments Width and Height .String
DescriptionDescription of the media. This is shown to the user in the item's info section in the Google Photos app.StringLimit
FilenameFilename of the media. This is shown to the user in the item's info section in the Google Photos app.String
MIME TypeMIME type of the media. For example, image/jpeg.String

Metadata Type

Defines the mapping options of a Google Photos Metadata object.

OptionDescriptionType
WidthOriginal width (in pixels) of the media.Int
HeightOriginal height (in pixels) of the media.Int
Creation TimeTime when the media was first created (not when it was uploaded to Google Photos).String
Camera BrandBrand of the camera with which the photo was taken.String
Camera ModelModel of the camera with which the photo was taken.String
Frame RateFrame rate of the media in case is a video.Int
Camera ISOISO of the camera with which the photo was taken.Int
Focal LengthFocal length of the camera lens with which the photo was taken.Int
Aperture FAperture f number of the camera lens with which the photo was taken.Int
Exposure TimeExposure time of the camera aperture in seconds when the photo was taken.String