Atualizações nas APIs do Google Fotos

Publicado em setembro de 2024.

Esta página fornece detalhes sobre mudanças específicas no Google Fotos APIs de terceiros. Leia os detalhes desta página para entender como os métodos e escopos que você usa podem ser afetados. Saiba mais sobre os anúncios na postagem do blog relacionada.

API Library: impacto em casos de uso comuns

As seções a seguir detalham o impacto das próximas mudanças em 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 criar á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, não se esqueça de usar o escopo photoslibrary.appendonly, e não o photoslibrary. O O escopo photoslibrary está sendo removido.

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

O que vai mudar: 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 biblioteca, use o novo seletor de fotos do Google API. Isso oferece uma forma segura e fácil de usar para que os usuários concedam acesso a conteúdo específico.
• Caso seu aplicativo precise acessar toda a biblioteca do usuário, pode ser necessário reavalie seu app ou considere abordagens alternativas.

Compartilhamento e álbuns compartilhados

O que muda:álbuns compartilhados e as funções da API associadas (compartilhamento, cancelar o compartilhamento, receber, participar, sair e listar) vai retornar uma 403 PERMISSION_DENIED depois 31 de março de 2025.

O que você pode fazer:

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

Como gerenciar álbuns criados por apps: melhorias e conteúdo do álbum

O que vai mudar:o photoslibrary.edit.appcreatedata está sendo adicionado ao os três métodos a seguir 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.appcreatedata 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 o seguinte: 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 app. Isso inclui itens de mídia selecionados com a API Picker e adicionados à biblioteca do usuário com a API Library.	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.appcreatedata 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 a photoslibrary.edit.appcreatedata adicionada. Esses métodos agora só podem ser usados com álbuns e itens de mídia criados pelo app. Isso inclui itens de mídia selecionados com a API Picker e adicionados à biblioteca do usuário com a API Library.	albums.addEnrichment albums.batchAddMediaItems	Escopos restantes: photoslibrary.appendonly photoslibrary.edit.appcreatedata Escopos removidos: photoslibrary
	albums.batchRemoveMediaItems	Escopos restantes: photoslibrary.edit.appcreatedata Escopos removidos: photoslibrary
Esses métodos permanecerão inalterados.	albums.patch mediaItems.patch	Escopos restantes: photoslibrary.edit.appcreatedata Escopos removidos: Nenhum

Atualizações na política da API Photos

A Política de Uso aceitável atual será Substituído após 31 de março de 2025 pelos novos dados do usuário e desenvolvedor da API Photos Política. A nova política já está disponível para prévia.

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

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

• Site das APIs unificadas do Photos:consolidamos todos os recursos da API Photos em um local único e conveniente (este site), oferecendo uma interface para desenvolvedores. Nela, você encontra o seguinte:
  • Recursos centralizados:instruções de configuração e informações gerais combinadas de uso do produto e controles informações de suporte e políticas para a API Picker e a API Library.
  • Sites dedicados à API:sites individuais com guias detalhados. documentação de referência e exemplos de código do Seletor a API e a biblioteca API
• Conteúdo atualizado da API Library:a documentação da API Library. foi revisada para refletir suas capacidades após o período de aposentadoria. Ao longo da documentação atualizada, você encontrará rótulos que destacam qualquer conteúdo alterado ou removido, com links para o conteúdo legado correspondente para referência durante a migração.
• Documentação legada preservada:a API Library original foi retida. do Google Cloud para desenvolvedores que migrar as integrações atuais. Se você estiver iniciando um novo projeto, use a documentação atualizada. Se atualizar um projeto atual, consulte as bibliotecas legadas e atualizadas conforme necessário durante a migração.

Perguntas frequentes

O que vai mudar nas APIs do Google Fotos?

Apresentamos a nova API Google Photos Picker para selecionar fotos com segurança e atualizando a API Library para se concentrar no gerenciamento de fotos e vídeos. criados pelo seu app.

Quando essas mudanças entrarão em vigor?

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

Como a API Library será afetada?

photoslibrary.readonly, photoslibrary.sharing e photoslibrary serão removidos. As chamadas de API que dependem apenas desses escopos retornarão uma 403 PERMISSION_DENIED: Várias outras chamadas serão restritas com fotos e vídeos criados pelo seu app.

Confira o conjunto completo de mudanças na tabela na parte de cima desta 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 a entender as mudanças e identificar os recursos do app que talvez não disponíveis. Talvez seja necessário ajustar a funcionalidade ou explorar o app 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 álbuns da biblioteca do Google Fotos para enviar de volta para seu aplicativo. A API Picker oferece recursos robustos de seleção de fotos, incluindo selecionar itens individuais, selecionar todos os itens de um álbum e pesquisando a biblioteca do Google Fotos.

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

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

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

Esta postagem do blog para anunciar as mudanças.

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

Se você tiver dúvidas sobre a documentação do desenvolvedor, consulte nossa seção de suporte para mais detalhes sobre como receber ajuda.