Method: sharedAlbums.list

Lista todos os álbuns compartilhados disponíveis na guia "Compartilhamento" do aplicativo 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 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 listSharedAlbums.

excludeNonAppCreatedData

boolean

Se definido, os resultados vão excluir os itens de mídia que não foram criados por este app. O padrão é "false" (todos os álbuns são retornados). Este campo é 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 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 obter o próximo conjunto de álbuns compartilhados. Preenchido se houver mais álbuns compartilhados 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