Atualizações nas APIs do Google Fotos

Publicado em setembro de 2024.

Esta página fornece detalhes sobre mudanças específicas feitas nas APIs do Google Photos. Leia os detalhes nesta página para entender como os métodos e escopos que você usa podem ser afetados. Leia mais sobre o anúncio dessas mudanças na postagem do blog relacionada.

API Library: impacto em casos de uso comuns

As seções a seguir detalham como as próximas mudanças vão afetar casos de uso comuns.

Fazer upload de itens de mídia e criar álbuns

O que vai mudar:nenhuma mudança. Você pode continuar fazendo upload de itens de mídia e criando álbuns usando o escopo photoslibrary.appendonly.

O que você pode fazer:

Se o app estiver fazendo upload de itens de mídia ou criando álbuns, use o escopo photoslibrary.appendonly, não o photoslibrary. O escopo photoslibrary está sendo removido.

Como listar, pesquisar e recuperar itens de mídia e álbuns

O que está mudando:agora você só pode listar, pesquisar e recuperar álbuns e itens de mídia criados pelo seu app.

O que você pode fazer:

• Se o app precisar que os usuários selecionem fotos ou álbuns de toda a biblioteca, use a nova API Picker do Google Fotos. Isso oferece uma maneira segura e fácil de conceder acesso a conteúdo específico.
• Se o app depende do acesso à biblioteca inteira do usuário, talvez seja necessário reavaliar o app ou considerar abordagens alternativas.

Compartilhamento e álbuns compartilhados

O que está mudando:os álbuns compartilhados e as funções da API associadas (compartilhar, cancelar compartilhamento, receber, participar, sair e listar) vão retornar um 403 PERMISSION_DENIED após 31 de março de 2025.

O que você pode fazer:

Direcione os usuários ao app Google Fotos para que eles mesmos gerenciem o compartilhamento. Você pode fornecer instruções claras ou links diretos no app para orientar os usuários.

Gerenciar álbuns criados por apps: enriquecimentos e conteúdo

O que está mudando:o photoslibrary.edit.appcreateddata está sendo adicionado aos seguintes três métodos para consistência conceitual:

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

O que você pode fazer:

• Se o app já usa esses métodos, considere adotar o escopo photoslibrary.edit.appcreateddata para simplificar o processo de autorização.

API Library: escopos e métodos afetados

Como parte das mudanças nas APIs do Google Fotos, fizemos as seguintes atualizações.

Conforme mostrado na página de autorização atualizada, os seguintes escopos serão removidos da API Library após 31 de março de 2025:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

Os seguintes escopos vão permanecer:

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

Esta tabela detalha os métodos e escopos específicos da API Library afetados.

Atualizações	Métodos	Escopos
Agora, esses métodos só podem ser usados com álbuns e itens de mídia criados pelo seu app.	albums.create mediaItems.batchCreate	Escopos restantes: photoslibrary.appendonly Escopos removidos: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Escopos restantes: photoslibrary.readonly.appcreateddata Escopos removidos: photoslibrary photoslibrary.readonly
Esses métodos não estarão mais disponíveis.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	Escopos restantes: Nenhum Escopos removidos: photoslibrary.sharing
Esses métodos terão o photoslibrary.edit.appcreateddata adicionado. Agora, esses métodos só podem ser usados com álbuns e itens de mídia criados pelo app.	albums.addEnrichment albums.batchAddMediaItems	Escopos restantes: photoslibrary.appendonly photoslibrary.edit.appcreateddata Escopos removidos: photoslibrary
	albums.batchRemoveMediaItems	Escopos restantes: photoslibrary.edit.appcreateddata Escopos removidos: photoslibrary
Esses métodos vão permanecer inalterados.	albums.patch mediaItems.patch	Escopos restantes: photoslibrary.edit.appcreateddata Escopos removidos: Nenhum

Atualizações na política da API Photos

A Política de uso aceitável atual será substituída após 31 de março de 2025 pela nova Política de dados do usuário e do desenvolvedor da API Photos. A nova política já está disponível para pré-visualização.

Atualizações na documentação da API Photos

Fizemos mudanças significativas na documentação da API Photos para refletir as próximas atualizações e oferecer suporte à sua experiência de desenvolvimento:

• Site das APIs Unified Photos:consolidamos todos os recursos da API Photos em um único local (este site), oferecendo uma experiência simplificada para os desenvolvedores. Nele, você encontra:
  • Recursos centralizados:instruções de configuração e orientações gerais de uso combinadas e informações de suporte e política combinadas para a API Picker e a API Library.
  • Sites dedicados a APIs:sites individuais com guias detalhados, documentação de referência e exemplos de código para a API Picker e a API Library.
• Conteúdo atualizado da API Library:a documentação da API Library foi revisada para refletir os recursos da API Library após o período de desativação.
• Documentação legada preservada:mantivemos a documentação original da API da biblioteca para desenvolvedores que precisam migrar as integrações atuais. Se você estiver iniciando um novo projeto, use a documentação atualizada. Se você estiver atualizando um projeto, consulte a documentação legada e atualizada conforme necessário durante a migração.

Perguntas frequentes

O que está mudando nas APIs do Google Fotos?

Estamos lançando a nova API Google Photos Picker para seleção segura de fotos e atualizando a API Library para focar no gerenciamento de fotos e vídeos criados pelo seu app.

Quando essas mudanças vão entrar em vigor?

Essas mudanças vão entrar em vigor em 31 de março de 2025. Recomendamos que todos com integrações que usam a API Library para seleção de fotos migrem para a API Picker assim que possível.

Como a API Library será afetada?

Os escopos photoslibrary.readonly, photoslibrary.sharing e photoslibrary serão removidos. As chamadas de API que dependem apenas desses escopos vão retornar um 403 PERMISSION_DENIED após 31 de março de 2025. Várias outras chamadas serão restringidas para funcionar apenas com fotos e vídeos criados pelo seu app.

Confira o conjunto completo de mudanças na tabela de escopos e métodos afetados nesta página.

O que devo fazer se meu app usar os escopos ou métodos afetados?

Se o app usar qualquer um dos escopos ou métodos afetados, siga estas etapas:

• Para a seleção de fotos: migre para a API Google Photos Picker.
• Para outras funcionalidades: revise a documentação atualizada da API Library para entender as mudanças e identificar recursos no app que podem não estar mais disponíveis. Talvez seja necessário ajustar a funcionalidade do app ou procurar soluções alternativas para alguns casos de uso.

O que é a API Google Photos Picker?

A API Picker é uma maneira nova e segura para os desenvolvedores permitirem que os usuários selecionem fotos e vídeos da biblioteca do Google Fotos e os enviem de volta ao app.

Onde encontro mais informações sobre essas mudanças?

Esta página que você está visualizando mostra uma visão geral e um resumo de todas as mudanças.

O resto da documentação no nosso site foi atualizado para refletir as APIs atualizadas.

Esta postagem do blog anuncia as mudanças.

E se eu tiver outras dúvidas ou precisar de ajuda para migrar meu app?

Se você tiver dúvidas sobre a documentação para desenvolvedores, confira nossa página de suporte para mais detalhes sobre como receber ajuda.