Notas de la versión

Suscríbete a estas notas de la versión.

Esta página se actualiza con cada versión nueva de las APIs de Google Fotos. En el registro de cambios, se enumeran las versiones por fecha y se incluyen las funciones nuevas, las correcciones de errores y otros cambios.

La documentación y las guías indican la versión más reciente que se debe usar.

1 de abril de 2025

Notas

Esta versión implementa los cambios anunciados anteriormente en las APIs de Fotos.

• Se quitaron algunos permisos de la API de Library.
• Se restringieron varios métodos para que solo funcionen con contenido creado por la app.
• La nueva Política de Datos del Usuario y del Desarrollador de la API de Fotos entrará en vigencia en lugar de la antigua Política de Uso Aceptable.

Para obtener todos los detalles, consulta Actualizaciones de las APIs de Google Fotos.

16 de septiembre de 2024

Funciones

• Se presentó la nueva API de Picker para una selección de fotos segura y fácil de usar.

Notas

En esta versión, anunciamos cambios clave en la API de Library (vigentes a partir del 31 de marzo de 2025).

• La API de Library solo administrará las fotos y los videos que creó tu app.
• Se quitaron los permisos photoslibrary.readonly, photoslibrary.sharing y photoslibrary.
• Restringir varios métodos solo al contenido creado por apps

Los detalles completos se encuentran en la página Actualizaciones de las APIs de Google Fotos.

27 de octubre de 2022

Notas

• El codelab "Cómo compilar una app para compartir fotos con Google Fotos y Flutter" ya no está disponible. Revisa nuestros otros ejemplos y consulta el código de muestra en nuestras guías.

1 de junio de 2022

Notas

• Se agregaron prácticas recomendadas para subir archivos para aclarar el proceso de carga, señalar los errores comunes y cómo evitarlos, y proporcionar sugerencias para mejorar la eficiencia de la carga.

27 de octubre de 2021

Funciones

• Programa de socios de Google Fotos: lanzamiento del nivel Premier. El nivel Premier es un paquete de funciones de API mejoradas que aprovechan la potente inteligencia artificial de Google Fotos.

29 de septiembre de 2021

Funciones

• Nueva opción para ordenar las búsquedas basadas en el filtro de fecha. Los resultados se pueden ordenar de los más recientes a los más antiguos o viceversa. Esto permite realizar búsquedas más fáciles y mejorar la eficiencia, ya que proporciona mejores resultados de la búsqueda segmentada.

21 de julio de 2021

Funciones

• Nuevo parámetro -no para las URLs base de los videos para cargar miniaturas sin una superposición de botones de reproducción. De forma predeterminada, las miniaturas de video se cargan con una superposición de botones de reproducción. Este nuevo parámetro te permite controlar la ocultación del botón de reproducción en las miniaturas de los videos.

Problemas corregidos

• Problema 181282432: Las miniaturas de video siempre se muestran con una superposición de botones de reproducción.

25 de mayo de 2021

Problemas corregidos

• La propiedad exposureTime no se propagó para los metadatos photo en los elementos multimedia.

19 de mayo de 2021

Notas

• Se actualizó la documentación de la URL base para las fotos en movimiento para aclarar el comportamiento del parámetro =dv para las fotos en movimiento de Android y las fotos en vivo de iOS.

11 de febrero de 2021

Notas

• Se actualizó la Política de Uso Aceptable, y se agregó contenido sobre publicidad y se minimizó el uso de datos.

7 de julio de 2020

Funciones

• Se actualizó la API para admitir los nuevos controles de uso compartido en Google Fotos. Ahora se muestra un campo nuevo, isJoinable, como parte de la propiedad shareInfo para los álbumes compartidos. La API puede unir a los usuarios a un álbum compartido cuando isJoinable es true. Si un propietario inhabilitó el uso compartido de vínculos en un álbum de Google Fotos, isJoinable será false y la API no podrá unir a los usuarios a ese álbum.
• Problemas 111405623, 116379853 y 117685011: Ahora puedes cambiar los títulos y las fotos de portada de los álbumes, y cambiar las descripciones de los elementos multimedia que creó tu app. Solicita el nuevo permiso de autorización photoslibrary.edit.appcreateddata para el acceso a actualizaciones.

17 de febrero de 2020

Funciones

• Se incrementó el tamaño máximo de carga de un archivo de foto de 75 MB a 200 MB.
• Cuando subas archivos, ahora se debe especificar un tipo de MIME en la etapa de carga de bytes.
• Ahora especificas los nombres de archivo cuando creas un elemento multimedia, en lugar de cuando subes bytes multimedia. La nueva propiedad fileName en simpleMediaItem admite cadenas UTF-8. Puedes especificar el nombre de archivo de un elemento multimedia cuando subas bytes multimedia, pero te recomendamos que actualices tu implementación.

Notas

• Se actualizó la Política de Uso Aceptable con algunos detalles adicionales que se enfocan en minimizar el uso y el almacenamiento de datos.
• Se actualizó la documentación de la URL base para incluir fotos en movimiento.

16 de agosto de 2019

Funciones

• Problema 131874809: Se agregó la nueva propiedad isOwned en shareInfo para identificar si el usuario es el propietario del álbum compartido. Puedes encontrar más detalles en la guía para desarrolladores sobre cómo compartir contenido multimedia.

Problemas corregidos

• Problema 131711405: Faltaba la propiedad shareableUrl en la respuesta albums.list.
• Error 113870729: mediaItems.list a veces mostraba elementos multimedia duplicados en los límites de las páginas.
• Problema 93428763: El campo status para los metadatos de video ahora muestra correctamente el VideoProcessingStatus del video de mayor calidad disponible.

12 de junio de 2019

Funciones

• Problema 110188560: Se agregó un nuevo filtro de búsqueda para seleccionar elementos multimedia marcados como favoritos: FeatureFilter.
• Categorías de contenido nuevo para que ContentFilter filtre elementos multimedia que coincidan con categorías específicas: ARTS, CRAFTS, FASHION, HOUSES, GARDENS, FLOWERS y HOLIDAYS.

Notas

• Se actualizaron los Lineamientos de UX que proporcionan orientación adicional para nombrar proyectos y álbumes.

7 de mayo de 2019

Codelabs

• Nuevo codelab: Cómo compilar una app para compartir fotos con Google Fotos y Flutter. Aprende a compilar una app para compartir fotos con la API de la Biblioteca de Google Fotos en Flutter. Consulta la guía de muestras para obtener más detalles.

29 de abril de 2019

Funciones

• Error 109505022: Se agregaron nuevas llamadas para agregar y quitar elementos multimedia existentes a un álbum:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  Estas llamadas admiten elementos multimedia y álbumes que creó tu aplicación. Puedes encontrar más detalles en la guía para desarrolladores sobre cómo administrar álbumes.

• La llamada REST para crear elementos multimedia mediaItems.batchCreate ahora muestra el estado HTTP 207 MULTI-STATUS para un procesamiento correcto parcial si no se pudieron crear algunos elementos multimedia. Puedes encontrar más detalles en la guía para desarrolladores sobre cómo subir contenido multimedia.

Notas

• Las versiones más recientes de las bibliotecas cliente incluyen un cambio rotundo. Las clases relacionadas con MediaItem, Album y DateRange se movieron a un nuevo paquete dedicado. Su funcionalidad no cambió, solo su ubicación en la biblioteca cliente. Consulta las notas de la versión de la biblioteca cliente de Java (1.2.0) y de la biblioteca cliente de PHP (1.2.0).

14 de febrero de 2019

Notas

• Se aplica un nuevo límite de cuota para acceder a bytes de contenido multimedia desde URLs básicas. Puedes supervisar esta cuota en la Console de la API de Google.

Problemas corregidos

• Problema 124355983: Se producían errores 500 cuando se llamaba a mediaItems.get para algunos elementos multimedia compartidos.

21 de enero de 2019

Problemas corregidos

• Problema 121998358: Faltaba la propiedad isWriteable en la respuesta de albums.create.

7 de enero de 2019

Problemas corregidos

• Error 118464845: mediaItems.list mostró demasiadas páginas vacías.
• Error 111714379: mediaItems.search mostró la mitad de pageSize.

30 de noviembre de 2018

Funciones

• Llamada nueva mediaItems.batchGet para recuperar varios elementos multimedia por sus identificadores.
• Problema 111279349: Se agregó una nueva llamada sharedAlbums.leave para abandonar un álbum compartido.
• Error 111279347: Se agregó una nueva llamada albums.unshare para marcar un álbum compartido como privado.

Problemas corregidos

• Problema 113978705: Las descripciones configuradas en mediaItems.batchCreate se convirtieron en entidades HTML.
• Problema 114462217: No se pudo establecer el nombre de archivo para los archivos de video en mediaItems.batchCreate.
• Problema 118475587: Se mostraron URLs de productos no válidas para los elementos multimedia.
• Problema 111862704: Se producen errores 403 cuando se accede a las URLs base.
• Problema 115932469: Las cargas fallan con un error de cuota.

6 de septiembre de 2018

Funciones

• Las bibliotecas cliente de Java y PHP ya están disponibles.

Notas

• La API de la Biblioteca de Google Fotos entró en disponibilidad general. Gracias por tus comentarios y solicitudes de funciones durante el período de la versión preliminar para desarrolladores de la API de Library.
• Consulta las nuevas guías para comenzar a usar las bibliotecas cliente de Java y PHP.
• Se agregaron fragmentos de código de Java y PHP de muestra a las guías para demostrar el uso de las bibliotecas cliente.

5 de septiembre de 2018

Funciones

• Llamada nueva sharedAlbums.get para obtener un álbum con shareToken.
• Se agregó la nueva propiedad isJoined en shareInfo para identificar si el usuario se unió al álbum compartido.

Problemas corregidos

• Problema 79321120: Faltaba la propiedad mimeType en la respuesta mediaItems.batchCreate para los elementos multimedia de video.
• Problema 79319272: Faltaban propiedades como mediaMetadata y contributorInfo en la respuesta de mediaItems.batchCreate.
• Problema 110237685: Se solucionó el problema de carga de archivos relacionado con CORS.
• Problema 79318118: No se mantenía un orden coherente cuando se subían varios elementos a un álbum en la llamada mediaItems.batchCreate.

Notas

• Si almacenaste IDs (como los de álbumes, elementos multimedia o elementos de enriquecimiento) antes del 5 de septiembre de 2018, ya no funcionarán, ya que cambió el formato. Deberás obtener IDs nuevos para usarlos en tu aplicación.
• Se cambió el nombre de la propiedad totalMediaItems del recurso album a mediaItemsCount.
• El valor máximo del parámetro pageSize en las llamadas mediaItems.list y mediaItems.search cambió a 100. La cantidad predeterminada de elementos multimedia que se muestra cuando no se especifica el parámetro pageSize se cambió a 25.
• Las guías Lista el contenido de la biblioteca, Cómo compartir contenido multimedia y Cómo acceder a elementos multimedia se actualizaron con la función de filtro excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) que se lanzó el 31 de julio de 2018.

31 de julio de 2018

Funciones

• Llamada nueva mediaItems.list para enumerar elementos multimedia.
• Nuevo filtro excludeNonAppCreatedData para buscar elementos o álbumes de listas creados por tu app.
• Nuevos parámetros para acceder a imágenes:
  • Error 79871479: Se agregó el parámetro de recorte c para recortar la imagen a dimensiones exactas.
  • Error 110343547 y error 111228390: Parámetro de descarga d para descargar la imagen original.
• La llamada a sharedAlbums.join ahora muestra un álbum.
• Problema 109655786: album ahora contiene el ID del elemento multimedia de la foto de portada, coverPhotoMediaItemId.
• Error 79656863: mediaItem ahora contiene el nombre de archivo del elemento multimedia, filename.

Problemas corregidos

• Error 79757390: No se configuraba el nombre del archivo durante las solicitudes de carga. Consulta los campos X-Goog-Upload-File-Namefile y X-Goog-Upload-Protocol en la guía para subir contenido multimedia.
• Problema 80182372: Las cargas reanudables mostraron un error. Consulta la nueva guía de cargas reanudables para ver el protocolo actualizado.
• Error 79497397: Falta la propiedad isWriteable en la respuesta albums.list.
• Error 111143493: El filtro de categorías de contenido PEOPLE mostraba resultados imprecisos.
• Problema 111056278: El filtro de categorías de contenido BIRTHDAYS mostraba un error.

Versión preliminar: 8 de mayo de 2018

Lanzamiento inicial de la API de Library.

Problemas conocidos

• GET mediaItem arroja un error si el elemento multimedia id que recibe es de un álbum compartido y no es propiedad del usuario.
• La respuesta de la llamada a batchCreate no mostrará mediaMetadata ni contributorInfo.
• Si el elemento multimedia es un video, la llamada a batchCreate no mostrará un mimeType.
• batchCreate no mantiene un orden coherente cuando se suben varios elementos.
• batchCreate no admite el orden (agregar un position) cuando se crean elementos multimedia en un álbum compartido como propietario del álbum. De forma predeterminada, se reproduce el final del álbum.