Method: albums.list

Muestra una lista de todos los álbumes que se muestran a un usuario en la pestaña Álbumes de la app de Google Fotos.

Solicitud HTTP

GET https://photoslibrary.googleapis.com/v1/albums

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
pageSize

integer

Es la cantidad máxima de álbumes que se mostrarán en la respuesta. Es posible que se devuelvan menos álbumes que el número especificado. El valor predeterminado de pageSize es 20 y el máximo es 50.
pageToken

string

Un token de Continuation para obtener la siguiente página de resultados. Cuando se agrega esto a la solicitud, se muestran las filas después de pageToken. pageToken debe ser el valor que se muestra en el parámetro nextPageToken en la respuesta a la solicitud listAlbums.
excludeNonAppCreatedData

boolean

Si se establece, los resultados excluyen los elementos multimedia que no se crearon en esta app. El valor predeterminado es "false" (se muestran todos los álbumes). Este campo se ignora si se usa el permiso photoslibrary.readonly.appcreateddata.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la lista de álbumes solicitados.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "albums": [
    {
      object (Album)
    }
  ],
  "nextPageToken": string
}
Campos
albums[]

object (Album)

Solo salida. Es la lista de álbumes que se muestra en la pestaña Álbumes de la app de Google Fotos del usuario.
nextPageToken

string

Solo salida. Es el token que se debe usar para obtener el siguiente conjunto de álbumes. Se propaga si hay más álbumes para recuperar para esta solicitud.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • 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