Representation of an album in Google Photos. Albums are containers for media items. If an album has been shared by the application, it contains an extra shareInfo property.
Identifier for the album. This is a persistent identifier that can be used between sessions to identify this album.
title
string
Name of the album displayed to the user in their Google Photos account. This string shouldn't be more than 500 characters.
productUrl
string
[Output only] Google Photos URL for the album. The user needs to be signed in to their Google Photos account to access this link.
isWriteable
boolean
[Output only] True if you can create media items in this album. This field is based on the scopes granted and permissions of the album. If the scopes are changed or permissions of the album are changed, this field is updated.
[Output only] Information related to shared albums. This field is only populated if the album is a shared album, the developer created the album and the user has granted the photoslibrary.sharing scope.
[Output only] The number of media items in the album.
coverPhotoBaseUrl
string
[Output only] A URL to the cover photo'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' sets the dimensions of the cover photo to have a width of 2048 px and height of 1024 px.
coverPhotoMediaItemId
string
Identifier for the media item associated with the cover photo.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-09 UTC."],[[["Albums in Google Photos are containers for media items and may include share information if shared."],["The `Album` resource provides details like title, URL, media item count, and cover photo information."],["Developers can interact with Shared Albums using the provided methods, but these methods will be deprecated beginning March 31, 2025."],["The `Album` resource representation is detailed with a JSON structure and a table outlining field definitions and types."]]],["Albums in Google Photos are containers for media items, identified by a unique `id` and a user-facing `title`. Key properties include `productUrl` (a direct link), `isWriteable` (indicating content creation capability), and `mediaItemsCount`. Shared albums have `shareInfo`. A `coverPhotoBaseUrl` provides the cover photo's URL, and the `coverPhotoMediaItemId` links to the cover photo's media item. Methods like get, join, leave and list shared albums will no longer work after March 31, 2025.\n"]]