Publicado en septiembre de 2024.
En esta página, se proporcionan detalles sobre los cambios específicos que se realizan en las APIs de Google Fotos. Revisa los detalles de esta página para comprender cómo pueden verse afectados los métodos y los alcances que usas. Puedes obtener más información sobre el anuncio de estos cambios en la entrada de blog relacionada.
API de la biblioteca: Impacto en casos de uso comunes
En las siguientes secciones, se detalla cómo los próximos cambios afectarán a los casos de uso comunes.
Subir elementos multimedia y crear álbumes
Qué cambiará: No habrá cambios. Puedes seguir subiendo elementos multimedia y creando álbumes con el permiso photoslibrary.appendonly.
Qué puedes hacer:
Si tu app sube elementos multimedia o crea álbumes, asegúrate de usar el permiso photoslibrary.appendonly y no el permiso photoslibrary. Se quitará el permiso photoslibrary.
Cómo enumerar, buscar y recuperar elementos y álbumes multimedia
Qué cambiará: Ahora solo puedes enumerar, buscar y recuperar los álbumes y los elementos multimedia que creó tu app.
Qué puedes hacer:
- Si tu app necesita que los usuarios seleccionen fotos o álbumes de toda su biblioteca, usa la nueva API de Google Photos Picker. Esto proporciona una forma segura y fácil de usar para que los usuarios otorguen acceso a contenido específico.
- Si tu app depende del acceso a toda la biblioteca del usuario, es posible que debas volver a evaluarla o considerar enfoques alternativos.
Compartir y álbumes compartidos
Qué cambiará: Los álbumes compartidos y las funciones de la API asociadas (compartir, dejar de compartir, obtener, unirse, salir y enumerar) mostrarán un 403 PERMISSION_DENIED después del 31 de marzo de 2025.
Qué puedes hacer:
Dirige a los usuarios a la app de Google Fotos para que administren el uso compartido por su cuenta. Puedes proporcionar instrucciones claras o vínculos directos dentro de tu app para guiarlos.
Administración de álbumes creados por apps: enriquecimientos y contenido de álbumes
Qué cambiará: Se agregará photoslibrary.edit.appcreateddata a los siguientes tres métodos para lograr coherencia conceptual:
albums.addEnrichmentalbums.batchAddMediaItemsalbums.batchRemoveMediaItems
Qué puedes hacer:
- Si tu app ya usa estos métodos, considera adoptar el permiso
photoslibrary.edit.appcreateddatapara simplificar el proceso de autorización.
API de la biblioteca: Alcances y métodos afectados
Como parte de los cambios en las APIs de Google Fotos, realizamos las siguientes actualizaciones.
Como se muestra en la página de autorización actualizada, los siguientes permisos se quitarán de la API de Library después del 31 de marzo de 2025:
photoslibrary.readonlyphotoslibrary.sharingphotoslibrary
Se conservarán los siguientes permisos:
photoslibrary.appendonlyphotoslibrary.readonly.appcreateddataphotoslibrary.edit.appcreateddata
En esta tabla, se detallan los métodos y los alcances específicos de la API de la biblioteca afectados.
| Actualizaciones | Métodos | Permisos |
|---|---|---|
| Estos métodos ahora solo se pueden usar con los álbumes y elementos multimedia que crea tu app. | Alcances restantes:
|
|
Alcances restantes:
|
||
| Estos métodos ya no estarán disponibles. | Alcances restantes:
|
|
A estos métodos se les agregará photoslibrary.edit.appcreateddata. Estos métodos ahora solo se pueden usar con los álbumes y elementos multimedia que creó tu app. |
Alcances restantes:
|
|
Alcances restantes:
|
||
| Estos métodos no sufrirán modificaciones. | Alcances restantes:
|
Actualizaciones de la política de la API de Fotos
La política de Uso Aceptable actual se reemplazará después del 31 de marzo de 2025 por la nueva Política de Datos del Usuario y Desarrollador de la API de Fotos. La nueva política ya está disponible para la versión preliminar.
Actualizaciones de la documentación de la API de Fotos
Realizamos cambios significativos en la documentación de la API de Fotos para reflejar las próximas actualizaciones y respaldar tu experiencia de desarrollo:
- Sitio unificado de las APIs de Fotos: Consolidamos todos los recursos de la API de Fotos en una sola ubicación (este sitio), lo que brinda una experiencia optimizada para los desarrolladores. Allí encontrarás lo siguiente:
- Recursos centralizados: Instrucciones de configuración y orientación general de uso combinadas, y información de asistencia y políticas combinadas para la API de Picker y la API de Library.
- Sitios de API dedicados: Son sitios individuales con guías detalladas, documentación de referencia y muestras de código para la API de Selector y la API de Biblioteca.
- Contenido actualizado de la API de la biblioteca: Se revisó la documentación de la API de la biblioteca para reflejar las capacidades de la API de la biblioteca después del período de desactivación.
- Documentación heredada preservada: Conservamos la documentación original de la API de la biblioteca para los desarrolladores que necesiten migrar integraciones existentes. Si estás comenzando un proyecto nuevo, usa la documentación actualizada. Si vas a actualizar un proyecto existente, consulta la documentación heredada y la actualizada según sea necesario durante la migración.
Preguntas frecuentes
¿Qué cambiará con las APIs de Google Fotos?
Presentamos la nueva API de Google Photos Picker para la selección de fotos segura y actualizamos la API de Library existente para enfocarnos en administrar las fotos y los videos que crea tu app.
¿Cuándo entrarán en vigencia estos cambios?
Estos cambios entrarán en vigencia el 31 de marzo de 2025. Recomendamos a todos los usuarios con integraciones existentes que usan la API de Library para la selección de fotos que migren a la API de Picker lo antes posible.
¿Cómo se verá afectada la API de Library?
Se quitarán los permisos photoslibrary.readonly, photoslibrary.sharing y photoslibrary. Las llamadas a la API que solo dependan de estos permisos mostrarán un 403 PERMISSION_DENIED después del 31 de marzo de 2025. Varias otras llamadas se restringirán para que funcionen solo con las fotos y los videos que creó tu app.
Puedes revisar el conjunto completo de cambios en la tabla de métodos y alcances afectados en esta página.
¿Qué debo hacer si mi app actualmente usa los permisos o métodos afectados?
Si tu app usa alguno de los permisos o métodos afectados, te recomendamos que sigas estos pasos:
- Para la selección de fotos, migra a la API de Selector de fotos de Google.
- Para otras funciones, revisa la documentación actualizada de la API de la biblioteca para comprender los cambios y, luego, identificar las funciones de tu app que es posible que ya no estén disponibles. Es posible que debas ajustar la funcionalidad de tu app o explorar soluciones alternativas para algunos casos de uso.
¿Qué es la API de Google Photos Picker?
La API de Picker es una forma nueva y segura para que los desarrolladores permitan que los usuarios seleccionen fotos y videos de su biblioteca de Google Fotos y los envíen sin problemas a tu aplicación.
¿Dónde puedo encontrar más información sobre estos cambios?
La página que estás viendo actualmente proporciona una descripción general y un resumen de todos los cambios.
El resto de la documentación de nuestro sitio se actualizó para reflejar las APIs actualizadas.
Esta entrada de blog en la que se anuncian los cambios.
¿Qué sucede si tengo más preguntas o necesito ayuda para migrar mi aplicación?
Si tienes preguntas sobre la documentación para desarrolladores, consulta nuestra página de asistencia para obtener más detalles sobre cómo obtener ayuda.