Method: albums.list

Lista todos os álbuns mostrados a um usuário na guia "Álbuns" do app Google Fotos.

Solicitação HTTP

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

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

Parâmetros de consulta

Parâmetros
pageSize

integer

Número máximo de álbuns a serem retornados na resposta. É possível que sejam retornados menos álbuns do que o número especificado. O pageSize padrão é 20, e o máximo é 50.

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 pageToken. O pageToken precisa ser o valor retornado no parâmetro nextPageToken na resposta à solicitação listAlbums.

excludeNonAppCreatedData

boolean

Se definido, os resultados excluem itens de mídia que não foram criados por esse app. O padrão é "false" (todos os álbuns são retornados). Esse campo será ignorado se o escopo photoslibrary.readonly.appcreateddata for usado.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Lista de álbuns solicitados.

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

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

object (Album)

Apenas saída. Lista de álbuns exibidos na guia "Álbuns" do app Google Fotos do usuário.

nextPageToken

string

Apenas saída. Token a ser usado para obter o próximo conjunto de álbuns. Será preenchido se houver mais álbuns para recuperar para essa 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