Notas da versão

Inscreva-se nessas notas da versão.

Esta página é atualizada a cada nova versão das APIs Google Photos. O registro de alterações lista as versões por data e inclui 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.

1º de abril de 2025

Observações

Esta versão implementa as mudanças anunciadas anteriormente nas APIs do Google Fotos.

• Remoção de alguns escopos da API Library.
• Restrição de vários métodos para funcionar apenas com conteúdo criado pelo app.
• A nova Política para desenvolvedores e dados dos usuários da API Photos entra em vigor no lugar da antiga Política de uso aceitável.

Para mais detalhes, leia Atualizações nas APIs Google Photos.

16 de setembro de 2024

Recursos

• Introdução da nova API Picker para seleção de fotos segura e 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 só vai gerenciar fotos e vídeos criados pelo seu app.
• Remoção dos escopos photoslibrary.readonly, photoslibrary.sharing e photoslibrary.
• Restrição de vários métodos apenas ao conteúdo criado pelo app.

Confira todos os detalhes na página Atualizações nas APIs Google Photos.

27 de outubro de 2022

Observações

• O codelab "Criar um app de compartilhamento de fotos com o Google Fotos e o Flutter" não está mais disponível. Analise nossas outras amostras e consulte o exemplo de código nos nossos guias.

1º de junho de 2022

Observações

• Adicionamos práticas recomendadas para upload para ajudar a esclarecer o processo de upload, apontar erros comuns e como evitá-los e dar dicas para melhorar a eficiência do upload.

27 de outubro de 2021

Recursos

• Programa de Parcerias do Google Fotos: lançamento do nível Premier. O nível Premier é um pacote de recursos de API aprimorados que aproveitam a inteligente artificial do Google Fotos.

29 de setembro de 2021

Recursos

• Nova opção para ordenar pesquisas com base no filtro de data. Os resultados podem ser ordenados do mais recente para o mais antigo ou vice-versa. 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 base de vídeos para carregar miniaturas sem uma sobreposição do botão de reprodução. Por padrão, as miniaturas de vídeo são carregadas com uma sobreposição do botão de reprodução. Esse novo parâmetro permite ocultar o botão de reprodução nas miniaturas de vídeo.

Problemas resolvidos

• Problema 181282432: as miniaturas de vídeo sempre são mostradas 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 de base para fotos em movimento foi atualizada para esclarecer o comportamento do parâmetro =dv para fotos em movimento do Android e fotos em movimento do iOS.

11 de fevereiro de 2021

Observações

• A Política de Uso aceitável foi atualizada com a adição de conteúdo sobre publicidade e a redução do uso de dados.

7 de julho de 2020

Recursos

• A API foi atualizada para oferecer suporte aos novos controles de compartilhamento no Google Fotos. Um novo campo, isJoinable, é retornado como parte da propriedade shareInfo para álbuns compartilhados. A API pode associar usuários a um álbum compartilhado quando isJoinable é 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 e 117685011: agora é possível mudar títulos e capas de álbuns e mudar descrições de itens de mídia criados pelo app. Solicite o novo escopo de autorização photoslibrary.edit.appcreateddata para ter acesso à atualização.

17 de fevereiro de 2020

Recursos

• O tamanho máximo de upload de uma foto foi aumentado de 75 MB para 200 MB.
• Ao fazer upload de arquivos, agora é necessário especificar um tipo MIME na etapa de upload de bytes.
• Agora é possível especificar nomes de arquivos ao criar um item de mídia, em vez de fazer o 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 ao fazer 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.
• A documentação do URL de base foi atualizada para incluir fotos em 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. Confira mais detalhes no guia para desenvolvedores sobre compartilhar mídia.

Problemas resolvidos

• Problema 131711405: a propriedade shareableUrl estava ausente na resposta albums.list.
• Problema 113870729: mediaItems.list às vezes, itens de mídia duplicados eram retornados nos limites da página.
• Problema 93428763: o campo status para metadados de vídeo agora retorna corretamente o VideoProcessingStatus do vídeo de maior 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 o 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: novas chamadas para adicionar e remover itens de mídia de um álbum:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  Essas chamadas oferecem suporte a itens de mídia e álbuns criados pelo seu aplicativo. Confira mais detalhes no guia para desenvolvedores sobre como gerenciar álbuns.

• A chamada REST para criar itens de mídia mediaItems.batchCreate agora retorna o status HTTP 207 MULTI-STATUS para sucesso parcial se alguns itens de mídia não puderem ser criados. 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 um novo pacote dedicado. A funcionalidade não mudou, apenas a localização na biblioteca de cliente. Consulte as notas da versão da biblioteca de cliente Java (1.2.0) e da biblioteca de cliente do 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: a propriedade isWriteable estava ausente na resposta albums.create.

7 de janeiro de 2019

Problemas resolvidos

• Problema 118464845: o mediaItems.list retornava 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: nova chamada albums.unshare para marcar um álbum compartilhado como particular.

Problemas resolvidos

• Problema 113978705: as descrições definidas em mediaItems.batchCreate foram convertidas 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: URLs de produtos inválidos foram retornados para itens de mídia.
• Problema 111862704: erros 403 ao acessar URLs base.
• Problema 115932469: os uploads falham com um erro de cota.

6 de setembro de 2018

Recursos

• As bibliotecas de cliente Java e PHP já estão disponíveis.

Observações

• A API Google Photos Library entrou na 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 entrou no álbum compartilhado.

Problemas resolvidos

• Problema 79321120: a propriedade mimeType estava ausente na resposta mediaItems.batchCreate para itens de mídia de vídeo.
• Problema 79319272: propriedades como mediaMetadata e contributorInfo estavam ausentes na resposta mediaItems.batchCreate.
• Problema 110237685: correção de um problema de upload de arquivos relacionado ao CORS.
• 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 não vão mais funcionar porque o formato mudou. Você vai precisar de novos IDs para usar no seu app.
• A propriedade totalMediaItems do recurso album foi renomeada para 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 parâmetro pageSize não é especificado foi alterado para 25.
• Os guias Listar conteúdo da biblioteca, Compartilhar mídia e Acessar itens de mídia foram atualizados com o recurso de filtro excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) 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: parâmetro de download d, para fazer o download da imagem original.
• A chamada sharedAlbums.join agora retorna um álbum.
• Problema 109655786: album agora contém o ID do item de mídia da foto de capa, coverPhotoMediaItemId.
• Problema 79656863: mediaItem agora contém o nome de arquivo do item de mídia, filename.

Problemas resolvidos

• Problema 79757390: o nome do arquivo não estava sendo definido durante os pedidos de upload. Consulte os campos X-Goog-Upload-File-Namefile e X-Goog-Upload-Protocol no guia Fazer upload de mídia.
• Problema 80182372: os uploads retomáveis retornaram um erro. Consulte o novo guia de uploads retomáveis para conferir o protocolo atualizado.
• Problema 79497397: a propriedade isWriteable está ausente na resposta albums.list.
• Problema 111143493: o filtro de categoria de conteúdo PEOPLE estava retornando resultados imprecisos.
• Problema 111056278: o filtro de categoria de conteúdo BIRTHDAYS 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 ou contributorInfo.
• Se o item de mídia for um vídeo, a chamada batchCreate não vai retornar um 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. Ele é definido como o fim do álbum por padrão.