Notas da versão

Inscreva-se nessas notas da versão.

Esta página é atualizada a cada nova versão da API Google Photos Library. O log de mudanças lista as versões por data e inclui todos os novos recursos, correções de bugs e outras mudanças.

A documentação e os guias apontam para a versão mais recente a ser usada.

16 de setembro de 2024

Recursos

• Introduzimos a nova API Picker para APIs fácil de usar.

Observações

Nesta versão, anunciamos mudanças importantes na API Library (em vigor a partir de 31 de março de 2025).

• A API Library gerencia apenas fotos e vídeos criados pelo seu app.
• Remoção de photoslibrary.readonly, photoslibrary.sharing e photoslibrary escopos.
• Restrição de vários métodos somente para conteúdo criado em apps.

Os detalhes completos estão disponíveis em Atualizações nas APIs Google Photos (em inglês). página.

27 de outubro de 2022

Observações

• "Crie um app de compartilhamento de fotos com o Google Fotos e o Flutter" o codelab não é mais disponível. Confira nossos outros exemplos e consulte ao exemplo de código em nossos guias.

1º de junho de 2022

Observações

• Adição de práticas recomendadas para envio para ajudar a esclarecer o processo de envio, apontar erros comuns e como evitar e fornecer dicas para melhorar a eficiência dos envios.

27 de outubro de 2021

Recursos

• Programa de Parceiros do Google Fotos: lançamento do nível Premier. O nível Premier é um pacote de recursos avançados de API que usam a poderosa inteligência de máquina do Google Fotos.

29 de setembro de 2021

Recursos

• Nova opção para classificar as pesquisas com base em filtros de data , Os resultados podem ser classificados primeiro ou mais antigos. Isso facilita a pesquisa e melhora a eficiência, fornecendo melhores resultados de pesquisa segmentados.

21 de julho de 2021

Recursos

• Novo parâmetro -no para URLs de vídeo de base para carregar miniaturas sem sobreposição do botão de reprodução. Por padrão as miniaturas carregam com uma sobreposição do botão de reprodução. Com esse novo parâmetro, para ocultar o botão de reprodução nas miniaturas do vídeo.

Problemas resolvidos

• Problema 181282432: sempre as miniaturas de vídeo exibido com uma sobreposição do botão de reprodução.

25 de maio de 2021

Problemas resolvidos

• A propriedade exposureTime não foi preenchida para Metadados photo em itens de mídia.

19 de Maio de 2019

Observações

• A documentação do URL base para movimento fotos foi Atualizada para esclarecer o comportamento do parâmetro =dv para o movimento do Android. fotos e Live Photos do iOS.

11 de fevereiro de 2021

Observações

• A Política de Uso Aceitável foi atualizadas, adicionando conteúdo sobre publicidade e minimizando o uso de dados.

7 de julho de 2020

Recursos

• A API foi atualizada para oferecer suporte novos controles de compartilhamento no Google Fotos. Um novo campo, isJoinable, é agora retornado como parte da propriedade shareInfo para álbuns compartilhados. A API podem unir usuários a um álbum compartilhado quando isJoinable for true. Se um proprietário tiver desativado o compartilhamento de links em um álbum no Google Fotos, isJoinable será false, e a API não poderá juntar usuários a esse álbum.
• Problemas 111405623 116379853, 117685011: agora você pode mudar o título de álbuns e as fotos de capa, e descrições de mudanças para itens de mídia que seu app criou. Solicitar o novo photoslibrary.edit.appcreateddata escopo de autorização para acesso de atualização.

17 de fevereiro de 2020

Recursos

• O tamanho máximo do arquivo para upload foto foi passou de 75 MB para 200 MB.
• Ao fazer upload de arquivos, um tipo MIME agora deve ser especificado no estágio de upload de bytes.
• Agora, você especifica nomes de arquivos ao criar um objeto de mídia item, em vez de ao fazer upload de bytes de mídia. A nova propriedade fileName em simpleMediaItem oferece suporte a strings UTF-8. Ainda é possível especificar o nome de arquivo de um item de mídia quando o upload de bytes de mídia. No entanto, recomendamos atualizar sua implementação.

Observações

• A Política de Uso aceitável foi atualizada com alguns detalhes extras focados em minimizar o uso e o armazenamento de dados.
• O URL base documentação foi atualizado para incluir fotos com movimento.

16 de agosto de 2019

Recursos

• Problema 131874809: nova propriedade isOwned em shareInfo para identificar se o usuário é o proprietário do álbum compartilhado. Mais detalhes são disponíveis no sistema de mídia guia para desenvolvedores.

Problemas resolvidos

• Problema 131711405 (link em inglês): a propriedade shareableUrl era ausente no albums.list resposta.
• Problema 113870729 (link em inglês): mediaItems.list às vezes retornavam itens de mídia duplicados nos limites da página.
• Problema 93428763 (link em inglês): o campo status para vídeo metadados agora retorna corretamente o VideoProcessingStatus com a melhor qualidade disponível.

12 de junho de 2019

Recursos

• Problema 110188560: novo filtro de pesquisa para selecionar itens de mídia marcados como favoritos: FeatureFilter
• Novas categorias de conteúdo para o ContentFilter para filtrar itens de mídia que correspondem a categorias específicas: ARTS, CRAFTS, FASHION, HOUSES, GARDENS, FLOWERS, HOLIDAYS.

Observações

• Atualização das diretrizes de UX, que oferecem orientações adicionais para nomear projetos e álbuns.

7 de maio de 2019

Codelabs

• Novo Codelab: Criar um app de compartilhamento de fotos com o Google Fotos e Flutter. Aprenda a criar um app de compartilhamento de fotos usando a API Google Photos Library no Flutter. Consulte o guia de amostras para mais detalhes.

29 de abril de 2019

Recursos

• Problema 109505022 (link em inglês): novas chamadas para adicionar e remover itens de mídia existentes de um álbum:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  Essas chamadas oferecem suporte a itens de mídia e álbuns criados pelo seu aplicativo. Mais detalhes estão disponíveis na página Gerenciar como álbuns (em inglês).

• A chamada REST para criar itens de mídia mediaItems.batchCreate agora retorna o status HTTP 207 MULTI-STATUS para sucesso parcial se alguma Não foi possível criar itens. Confira mais detalhes no guia para desenvolvedores Fazer upload de mídia.

Observações

• As versões mais recentes das bibliotecas de cliente incluem uma mudança interruptiva. As classes relacionadas a MediaItem, Album e DateRange foram movidas para uma nova pacote dedicado. A funcionalidade dele não mudou, apenas a localização dele a biblioteca de cliente. Consulte as notas da versão para a biblioteca cliente Java (1.2.0) e biblioteca do cliente PHP (1.2.0).

14 de fevereiro de 2019

Observações

• Um novo limite de cota para acessar bytes de mídia de URLs base foi implementado. É possível monitorar essa cota no Console de APIs do Google.

Problemas resolvidos

• Problema 124355983: erros 500 ao chamar mediaItems.get para alguns itens de mídia compartilhados.

21 de janeiro de 2019

Problemas resolvidos

• Problema 121998358 (link em inglês): a propriedade isWriteable era que faltam no albums.create.

7 de janeiro de 2019

Problemas resolvidos

• Problema 118464845 (link em inglês): mediaItems.list é retornado. muitas páginas vazias.
• Problema 111714379: mediaItems.search retornava metade do pageSize.

30 de novembro de 2018

Recursos

• Nova chamada mediaItems.batchGet para recuperar vários itens de mídia pelos identificadores.
• Problema 111279349: nova chamada sharedAlbums.leave para sair de um álbum combinado.
• Problema 111279347 (link em inglês): nova chamada albums.unshare para marcar um álbum compartilhado como particular.

Problemas resolvidos

• Problema 113978705: descrições definidas em mediaItems.batchCreate foram convertidos em entidades HTML.
• Problema 114462217: não foi possível definir o nome de arquivo para arquivos de vídeo em mediaItems.batchCreate.
• Problema 118475587: os URLs de produtos inválidos eram retornados para itens de mídia.
• Problema 111862704: erros 403 ao acessar e URLs de base.
• Problema 115932469 (link em inglês): falha nos uploads com cota erro.

6 de setembro de 2018

Recursos

• As bibliotecas de cliente Java e PHP são já disponível.

Observações

• A API Google Photos Library entrou em disponibilidade geral. Agradecemos seu feedback e solicitações de recursos durante o período de visualização para desenvolvedores da API Library.
• Confira os novos guias para começar a usar as bibliotecas de cliente Java e PHP.
• Exemplos de snippets de código Java e PHP foram adicionados aos guias para demonstrar o uso de bibliotecas de cliente.

5 de setembro de 2018

Recursos

• Nova chamada sharedAlbums.get para receber um álbum usando shareToken.
• Nova propriedade isJoined em shareInfo para identificar se o usuário está participando do álbum compartilhado.

Problemas resolvidos

• Problema 79321120 (link em inglês): a propriedade mimeType estava ausente no mediaItems.batchCreate para itens de mídia de vídeo.
• Problema 79319272 (link em inglês): propriedades como mediaMetadata e contributorInfo estavam ausentes na mediaItems.batchCreate resposta.
• Problema 110237685 (link em inglês): correção do arquivo relacionado ao CORS problema de upload.
• Problema 79318118: a ordem consistente não era mantida ao fazer upload de vários itens para um álbum na chamada mediaItems.batchCreate.

Observações

• Se você armazenou IDs (como IDs de álbuns, itens de mídia ou itens de enriquecimento) antes de 5 de setembro de 2018, eles deixarão de funcionar, já que o formato mudou. Você vai precisar de novos IDs para usar no seu app.
• A propriedade totalMediaItems do recurso álbum foi renomeada como mediaItemsCount.
• O valor máximo do parâmetro pageSize nas chamadas mediaItems.list e mediaItems.search foi alterado para 100. O número padrão de itens de mídia retornados quando o O parâmetro pageSize não especificado foi alterado para 25.
• Listar o conteúdo da biblioteca, Compartilhar mídia e Guias atualizados para acessar itens de mídia com o excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) recurso de filtro lançado em 31 de julho de 2018.

31 de julho de 2018

Recursos

• Nova chamada mediaItems.list para listar itens de mídia.
• Novo filtro excludeNonAppCreatedData para pesquisar itens ou listar álbuns criados pelo seu app.
• Novos parâmetros para acessar imagens:
  • Problema 79871479: parâmetro de corte c para cortar a imagem nas dimensões exatas.
  • Problema 110343547, Problema 111228390 (link em inglês): parâmetro de download d. para fazer download da imagem original.
• O sharedAlbums.join chamada agora retorna uma álbum.
• Problema 109655786: album agora contém o ID do item de mídia da foto da capa, coverPhotoMediaItemId.
• Problema 79656863 (link em inglês): mediaItem agora contém o nome de arquivo do item de mídia, filename.

Problemas resolvidos

• Problema 79757390 (link em inglês): o nome do arquivo não estava sendo definido durante solicitações de upload. Consulte X-Goog-Upload-File-Namefile e X-Goog-Upload-Protocol no campo Carregar de mídia digital.
• Problema 80182372 (link em inglês): os uploads retomáveis retornaram uma erro. Consulte a nova seção Recuperável de uploads para a versão atualizada protocolo.
• Problema 79497397 (link em inglês): a propriedade isWriteable está ausente na resposta albums.list.
• Problema 111143493 (link em inglês): categoria de conteúdo PEOPLE filtro estava retornando resultados imprecisos.
• Problema 111056278 (link em inglês): categoria de conteúdo BIRTHDAYS filtro estava retornando um erro.

Versão de pré-lançamento: 8 de maio de 2018

Versão inicial da API Library.

Problemas conhecidos

• GET mediaItem gera um erro se o item de mídia id recebido for de um álbum compartilhado e não for de propriedade do usuário.
• A resposta da chamada batchCreate não vai retornar mediaMetadata nem contributorInfo
• Se o item de mídia for um vídeo, a chamada batchCreate não vai retornar uma mimeType.
• O batchCreate não mantém a ordem consistente ao fazer upload de vários itens.
• O batchCreate não oferece suporte a ordenação (adição de um position) ao criar itens de mídia em um álbum compartilhado como proprietário. Ela o padrão é o fim do álbum.