Depois que um usuário seleciona itens de mídia usando a API Picker, você pode extrair informações sobre eles e acessar o conteúdo. Este guia descreve o processo de listar e recuperar itens de mídia.
Antes de começar
- Entenda o fluxo:revise como começar a usar a API Picker para ter uma visão geral de todo o processo de seleção de fotos.
- Concluir a seleção de item de mídia:confira se o usuário selecionou itens de mídia na sessão. Consulte o guia sobre sessões para mais detalhes.
- Revisar os escopos de autorização necessários: trabalhar com sessões requer o escopo
photospicker.mediaitems.readonly
. Para mais informações sobre escopos, consulte Escapos de autorização.
Listar itens de mídia selecionados
Use o endpoint
mediaItems.list
: faça uma solicitação GET para https://photospicker.googleapis.com/v1/mediaItems, fornecendo osessionId
como um parâmetro de consulta.Processar a paginação (se necessário):
Se o usuário selecionar um grande número de itens, a resposta poderá ser paginada. Use o
nextPageToken
na resposta para recuperar páginas de resultados subsequentes.Processar os itens de mídia: a resposta vai conter uma matriz de objetos
PickedMediaItem
, cada um representando um item de mídia selecionado. Esses objetos incluem detalhes essenciais, como:id
: o identificador exclusivo do item de mídia.baseUrl
: o URL base a partir do qual você pode criar URLs para acessar o conteúdo do item de mídia em várias resoluções.mimeType
: o tipo MIME do item de mídia (por exemplo, image/jpeg, video/mp4).
Recuperar itens de mídia selecionados
Verifique se você tem um token de acesso do OAuth 2.0 válido com o escopo https://www.googleapis.com/auth/photospicker.mediaitems.readonly
para autorizar suas solicitações.
Criar o URL do conteúdo:use o
baseUrl
do objetoPickedMediaItem
. Anexe a resolução ou o formato de arquivo ao baseUrl. Consulte a seção sobre URLs base para mais detalhes.Buscar o conteúdo:faça uma solicitação GET para o URL base do item de mídia. A resposta conterá os bytes do item de mídia (imagem ou vídeo). Há várias opções de baseURL disponíveis.
URLs base
Os URLs de base nas APIs do Google Fotos fornecem acesso aos bytes brutos de itens de mídia, permitindo que seu app faça o download ou os exiba. Esses URLs são incluídos nas respostas ao listar álbuns (API Library) ou acessar itens de mídia (APIs Library e Picker). Lembre-se de que os URLs base exigem parâmetros adicionais para funcionar corretamente.
Para a API Picker:
Todos os objetos PickedMediaItem.mediaFile
incluem um baseUrl
.
Os URLs de base permanecem ativos por 60 minutos, mas podem expirar antes se o usuário revogar as permissões do app nas configurações da Conta do Google.
Para a API Library:
Os URLs de base permanecem ativos por 60 minutos.
Os vários URLs base são:
baseUrl
: acessa diretamente a foto, a miniatura de um vídeo ou faz o download de bytes de vídeo.coverPhotoBaseUrl
: acessar diretamente a foto da capa do álbum.profilePictureBaseUrl
: acessa diretamente a foto do perfil do proprietário de umamediaItem
.
URLs de base de imagens
Esta é a lista de opções que podem ser usadas com os URLs de base de imagem:
Parâmetro | |
---|---|
w , h |
Descrição Os parâmetros de largura, Para acessar um item de mídia de imagem, como uma foto ou a miniatura de um vídeo, é preciso especificar as dimensões que você planeja exibir no aplicativo para que a imagem possa ser redimensionada para essas dimensões, preservando a proporção. Para fazer isso, concatene o URL de base com as dimensões necessárias, conforme mostrado nos exemplos. Exemplos: base-url=wmax-width-hmax-height Confira um exemplo de como mostrar um item de mídia com largura máxima de 2.048 px e altura máxima de 1.024 px: https://lh3.googleusercontent.com/p/AF....VnnY=w2048-h1024 |
c |
Descrição O parâmetro Se você quiser cortar a imagem para as dimensões exatas de largura e altura especificadas, concatenar o URL de base com o parâmetro opcional O tamanho (em pixels) deve estar no intervalo [1, 16383]. Se a largura ou a altura da imagem exceder o tamanho solicitado, ela será reduzida e cortada (mantendo a proporção). Exemplos: base-url=wmax-width-hmax-height-c Neste exemplo, o aplicativo mostra um item de mídia com exatamente 256 px de largura por 256 px de altura, como uma miniatura: https://lh3.googleusercontent.com/p/AF....VnnY=w256-h256-c |
d |
Descrição O download, parâmetro Se você quiser fazer o download da imagem mantendo todos os metadados do Exif,
exceto os metadados de local, concatenar o URL base com o
parâmetro Exemplos: base-url=d Neste exemplo, o aplicativo faz o download de uma imagem com todos os metadados, exceto os de local: https://lh3.googleusercontent.com/p/Az....XabC=d |
URLs de base dos vídeos
Confira a lista de opções que você pode usar com os URLs de base de vídeo:
Parâmetro | |
---|---|
dv |
Descrição Para acessar os bytes de um vídeo O parâmetro dv solicita uma versão transcodificada de alta qualidade do vídeo original. O parâmetro não é compatível com os parâmetros w e h. Os URLs de base para downloads de vídeo podem levar alguns segundos para retornar bytes. Antes de usar esse parâmetro, verifique se o campo
Exemplos: base-url=dv O exemplo a seguir mostra como fazer o download dos bytes de um vídeo: https://lh3.googleusercontent.com/p/AF....BsdZ=dv |
w , h , c e
d |
Descrição Para acessar a miniatura do vídeo, use qualquer um dos parâmetros de URL base da imagem. Por padrão, todas as miniaturas de vídeo incluem uma sobreposição de um botão de reprodução. Consulte o parâmetro -no para remover essa sobreposição. Exemplos: Consulte a tabela de URLs de imagem de base para conferir exemplos. |
no |
Descrição A sobreposição de miniaturas a ser removida, parâmetro Se você quiser recuperar a miniatura de um vídeo sem a sobreposição de um botão de reprodução, concatenar o URL base com o parâmetro no. O parâmetro no precisa ser usado com pelo menos um dos parâmetros de URL de base da imagem. Exemplos: base-url=wmax-width-hmax-height-no O exemplo a seguir mostra uma miniatura de vídeo com exatamente 1.280 px de largura por 720 px de altura e sem uma sobreposição de botão de reprodução: https://lh3.googleusercontent.com/p/AF....VnnY=w1280-h720-no |
URLs base de fotos com movimento
As fotos com movimento contêm elementos de fotos e vídeos. É possível usar parâmetros de
URLs de base de imagem ou URLs de base
de vídeo para solicitações baseUrl
de fotos em movimento.
Parâmetro | |
---|---|
dv |
Descrição Para recuperar o elemento de vídeo de um item de mídia de foto com movimento, use
o parâmetro |
w , h , c e
d |
Descrição Para recuperar o elemento de foto de um item de mídia de foto com movimento, use o formato para URLs de base de imagem. |