Method: albums.get

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

Some scopes previously used for this method are being removed or changed. Beginning March 31, 2025, functionality will be limited to interacting with media items created by your app. Please see Photos APIs updates for more details.

Returns the album based on the specified albumId. The albumId must be the ID of an album owned by the user or a shared album that the user has joined.

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
• https://www.googleapis.com/auth/photoslibrary.readonly
• https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
• https://www.googleapis.com/auth/photoslibrary.readonly.originals