Method: mediaItems.list

Listar todos os itens de mídia da biblioteca do Google Fotos de um usuário.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
pageSize

integer

Número máximo de itens de mídia para retornar na resposta. É possível que menos itens de mídia sejam retornados do que o número especificado. O pageSize padrão é 25, e o máximo é 100.
pageToken

string

Um token de continuação para ter acesso à próxima página de resultados. Adicionar isso à solicitação retorna as linhas após o pageToken. O pageToken precisa ser o valor retornado no parâmetro nextPageToken na resposta à solicitação listMediaItems.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Lista de todos os itens de mídia da biblioteca do Google Fotos do usuário.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "mediaItems": [
    {
      object (MediaItem)
    }
  ],
  "nextPageToken": string
}
Campos
mediaItems[]

object (MediaItem)

Apenas saída. Lista de itens de mídia na biblioteca do usuário.
nextPageToken

string

Apenas saída. Token a ser usado para receber o próximo conjunto de itens de mídia. A presença dele é o único indicador confiável de que mais itens de mídia estão disponíveis na próxima solicitação.

Escopos de autorização

Requer um dos seguintes escopos do 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