Method: albums.get

AI-generated Key Takeaways

• This method retrieves a specific album using its albumId, provided the album is owned by the user or is a shared album they have joined.

• The request requires an albumId as a path parameter and an empty request body.

• A successful response returns an Album object containing the album's data.

• Authorization is necessary using one of the specified OAuth scopes, including options for read-only access and accessing app-created data.

• Functionality changes are coming in March 2025, limiting interactions to media from your app; see Photos APIs updates for details.

• HTTP request
• Path parameters
• Request body
• Response body
• Authorization scopes
• Try it!

Returns the app created album based on the specified albumId. The albumId must be the ID of an album created by your app.

HTTP request

GET https://photoslibrary.googleapis.com/v1/albums/{albumId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
albumId	string Required. Identifier of the album to be requested.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Album.

Authorization scopes

Requires one of the following OAuth scopes:

• https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata