Method: albums.get

  • This endpoint retrieves a specific album using its unique identifier (albumId).

  • The request must include the albumId of an album the user owns or has joined as a path parameter.

  • An empty request body is required, and a successful response returns the album details.

  • Authorization is necessary using one of the specified OAuth scopes for Photos Library access.

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