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.addEnrichmentalbums.batchAddMediaItemsalbums.batchRemoveMediaItems
O que você pode fazer:
- Se o app já usa esses métodos, considere adotar o
escopo
photoslibrary.edit.appcreatedatapara 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.readonlyphotoslibrary.sharingphotoslibrary
Os seguintes escopos vão permanecer:
photoslibrary.appendonlyphotoslibrary.readonly.appcreateddataphotoslibrary.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. | Escopos restantes:
|
|
Escopos restantes:
|
||
| Esses métodos não estarão mais disponíveis. | Escopos restantes:
|
|
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. |
Escopos restantes:
|
|
Escopos restantes:
|
||
| Esses métodos permanecerão inalterados. | Escopos restantes:
|
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.