- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- Pruébala
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 |
Cantidad máxima de álbumes que se muestran en la respuesta. Es posible que se devuelvan menos álbumes que la cantidad especificada. El valor predeterminado de |
pageToken |
Un token de continuación para obtener la siguiente página de los resultados. Si agregas esto a la solicitud, se muestran las filas después de |
excludeNonAppCreatedData |
Si se establece esta configuración, los resultados excluirán los elementos multimedia que esta app no creó. El valor predeterminado es falso (se muestran todos los álbumes). Este campo se ignora si se usa el permiso photoslibrary.readonly.app createddata. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Lista de álbumes solicitados.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"albums": [
{
object ( |
Campos | |
---|---|
albums[] |
Solo salida. Lista de álbumes que se muestran en la pestaña Álbumes de la app de Google Fotos del usuario. |
nextPageToken |
Solo salida. Es el token que se usará para obtener el siguiente conjunto de álbumes. Se propaga si hay más álbumes que se deben recuperar para esta solicitud. |
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.readonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata