Method: sharedAlbums.list

Se muestra una lista de todos los álbumes compartidos disponibles en la pestaña Compartir de la app de Google Fotos del usuario.

Solicitud HTTP

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

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

Parámetros de consulta

Parámetros
pageSize

integer

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 pageSize es 20 y el máximo es 50.

pageToken

string

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 pageToken. pageToken debe ser el valor que se muestra en el parámetro nextPageToken en la respuesta a la solicitud listSharedAlbums.

excludeNonAppCreatedData

boolean

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 compartidos solicitados.

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

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

object (Album)

Solo salida. Lista de álbumes compartidos.

nextPageToken

string

Solo salida. Es el token que se usa para obtener el siguiente conjunto de álbumes compartidos. Se propaga si hay más álbumes compartidos para recuperar en 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