Method: sharedAlbums.list

Lista todos os álbuns compartilhados disponíveis na guia "Compartilhar" do app Google Fotos do usuário.

Solicitação HTTP

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

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 menos álbuns sejam retornados do que o número especificado. O pageSize padrão é 20, 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 listSharedAlbums.

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). Este campo será ignorado se o escopo photoslibrary.readonly.app createddata for usado.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Lista de álbuns compartilhados solicitados.

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

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

object (Album)

Apenas saída. Lista de álbuns compartilhados.

nextPageToken

string

Apenas saída. Token a ser usado para acessar o próximo conjunto de álbuns compartilhados. Preenchido se houver mais álbuns compartilhados para recuperar para a solicitação.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata