Publicado en septiembre de 2024.
En esta página, se brindan detalles sobre los cambios específicos que se harán en Google Fotos APIs Revisa los detalles de esta página para comprender cómo los métodos y alcances que usas pueden verse afectados. Puedes obtener más información sobre el anuncio de estos cambios en la entrada de blog relacionada.
API de Library: Impacto en los casos de uso comunes
Las siguientes secciones detallan el impacto de los próximos cambios en el uso común diferentes.
Cómo subir elementos multimedia y crear álbumes
Qué cambiará: No hay cambios. Puedes seguir subiendo elementos multimedia y
Crea álbumes con el alcance 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. El
Se está quitando photoslibrary permiso.
Muestra, busca y recupera álbumes y elementos multimedia
Qué cambiará: Ahora solo podrás enumerar, buscar y recuperar álbumes y elementos multimedia que creó tu app.
Qué puedes hacer:
- Si tu app requiere que los usuarios seleccionen fotos o álbumes de toda su biblioteca, usa el nuevo Selector de Google Fotos de la API de Google Ads. Esto proporciona un entorno seguro y fácil de usar para que los usuarios otorguen acceso a contenido específico.
- Si tu app requiere el acceso a toda la biblioteca del usuario, es posible que debas vuelve a evaluar tu app o considera otros enfoques.
Uso compartido y álbumes compartidos
Qué cambiará: Álbumes compartidos y las funciones de API asociadas (compartir,
dejar de compartir, obtener, unirse, salir y hacer una lista) mostrará un 403 PERMISSION_DENIED después de
31 de marzo de 2025.
Qué puedes hacer:
Dirige a los usuarios a la app de Google Fotos para que administren el uso compartido. Puedes proporcionar instrucciones claras o vínculos directos dentro de tu aplicación para guiarlos.
Cómo administrar álbumes creados por apps: enriquecimientos y contenido de álbumes
Qué cambiará: Se agregará la photoslibrary.edit.appcreatedata a
los siguientes tres métodos para la coherencia conceptual:
albums.addEnrichmentalbums.batchAddMediaItemsalbums.batchRemoveMediaItems
Qué puedes hacer:
- Si tu app ya usa estos métodos, te recomendamos adoptar el
photoslibrary.edit.appcreatedatapermiso para simplificar tu autorización el proceso de administración de recursos.
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 página, los siguientes alcances se quitarán de la API de la Biblioteca 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 alcances específicos de la API de la Biblioteca afectados.
| Actualizaciones | Métodos | Permisos |
|---|---|---|
| Ahora estos métodos solo se pueden usar con álbumes y elementos multimedia creados por tu app. Esto incluye los elementos multimedia seleccionados con la API de Picker y agregados a la biblioteca del usuario con la API de la Biblioteca. | Alcances restantes:
|
|
Alcances restantes:
|
||
| Estos métodos ya no estarán disponibles. | Alcances restantes:
|
|
Estos métodos tendrán photoslibrary.edit.appcreatedata agregado. Ahora estos métodos solo se pueden usar con álbumes y elementos multimedia creados por tu app. Esto incluye los elementos multimedia seleccionados con la API de Picker y agregados a la biblioteca del usuario con la API de la Biblioteca. |
Alcances restantes:
|
|
Alcances restantes:
|
||
| Estos métodos no sufrirán modificaciones. | Alcances restantes:
|
Actualizaciones en la política de la API de Fotos
La Política de Uso Aceptable actual será se reemplazará después del 31 de marzo de 2025 por la nueva API de Fotos Datos del usuario y Desarrollador Política. La nueva política ya está disponible para vista previa.
Actualizaciones en la documentación de la API de Photos
Realizamos cambios significativos en la documentación de la API de Photos para reflejar sobre las próximas actualizaciones y respaldan tu experiencia de desarrollo:
- Sitio unificado de las APIs de Fotos: Consolidamos todos los recursos de la API de Fotos
en una única ubicación conveniente (este sitio), lo que brinda una
para desarrolladores. Aquí, 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 dedicados a la API: Sitios individuales con guías detalladas, documentación de referencia y muestras de código para el selector API y la biblioteca API
- Contenido actualizado de la API de Library: la documentación de la API de Library se revisó para reflejar sus capacidades después del período de desactivación. A lo largo de la documentación actualizada, encontrarás etiquetas que destacan cualquier contenido modificado o eliminado con vínculos al contenido heredado correspondiente como referencia durante la migración.
- Documentación heredada preservada: conservamos la API de la biblioteca original documentación para desarrolladores que necesitas migrar integraciones existentes. Si estás comenzando un proyecto nuevo, usa la documentación actualizada. Si que estás actualizando un proyecto existente, consulta tanto la versión heredada como la actualizada documentación según sea necesario durante la migración.
Preguntas frecuentes
¿Qué cambiará en 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. Alentamos a todos con integraciones existentes que usan la API de la biblioteca para la selección de fotos a las que migrar la API de Picker lo antes posible.
¿Cómo se verá afectada la API de la Biblioteca?
photoslibrary.readonly, photoslibrary.sharing y photoslibrary
se quitarán los permisos. Las llamadas a la API que solo dependen de estos permisos mostrarán un
403 PERMISSION_DENIED Muchas otras llamadas estarán restringidas para funcionar solo
con fotos y videos creados por tu app.
Puedes revisar el conjunto completo de cambios en la tabla ubicada en la parte superior de esta página.
¿Qué debo hacer si mi app actualmente usa los permisos o métodos afectados?
Si tu aplicación usa alguno de los alcances o métodos afectados, te recomendamos sigue estos pasos:
- Para seleccionar fotos, migra a la API del selector de Google Fotos.
- Para otras funcionalidades, revisa la documentación actualizada de la API de la Biblioteca para comprender los cambios e identificar funciones de la app que ya no estar disponible. Es posible que debas ajustar la funcionalidad de tu app o explorar soluciones alternativas para algunos casos de uso.
¿Qué es la API del selector de Google Fotos?
La API de Picker es una nueva forma segura para que los desarrolladores permitan que los usuarios seleccionen fotos y álbumes desde su biblioteca de Google Fotos, y enviarlos sin problemas a tu aplicación. La API de Picker ofrece capacidades sólidas de selección de fotos, que incluye la selección de elementos individuales, la selección de todos los elementos de un álbum y buscando la biblioteca de Google Fotos.
¿Dónde puedo encontrar más información sobre estos cambios?
La página que estás viendo en este momento proporciona 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 el que se anuncian los cambios.
¿Qué sucede si tengo más preguntas o necesito ayuda para migrar mi aplicación?
Si tienes preguntas acerca de la documentación para desarrolladores, consulta nuestro sitio de asistencia. para conocer más detalles sobre cómo obtener ayuda.