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 la API de la Biblioteca de Google Fotos. El registro de cambios enumera las versiones por fecha y, además, incluye funciones nuevas, correcciones de errores y otros cambios.

La documentación y las guías apuntan a la última versión para usar.

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 nuestras otras muestras y consulta el código de muestra dentro de nuestras guías.

1 de junio de 2022

Notas

• Se agregaron prácticas recomendadas para la carga a fin de ayudar a aclarar el proceso de carga, mencionar errores comunes y 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 búsquedas basadas en filtros por fecha. Se pueden ordenar los resultados más recientes primero o más antiguos primero. Esto facilita la búsqueda y mejora la eficiencia, ya que proporciona resultados de la búsqueda más orientados.

21 de julio de 2021

Funciones

• Se agregó el parámetro -no para las URLs base de video a fin de 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 ocultar el botón de reproducción en las miniaturas de los videos.

Problemas corregidos

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

25 de mayo de 2021

Problemas corregidos

• No se propagó la propiedad exposureTime para los metadatos photo de los elementos multimedia.

19 de mayo de 2021

Notas

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

11 de febrero de 2021

Notas

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

7 de julio de 2020

Funciones

• Se actualizó la API para admitir nuevos controles de uso compartido en Google Fotos. Ahora se muestra un nuevo campo, isJoinable, como parte de la propiedad shareInfo para los álbumes compartidos. La API puede unir usuarios a un álbum compartido cuando isJoinable es true. Si un propietario inhabilitó el uso compartido de vínculos de un álbum en Google Fotos, isJoinable será false y la API no podrá unir usuarios a ese álbum.
• Problemas 111405623, 116379853 y 117685011: Ahora puedes cambiar los títulos de los álbumes y las fotos de portada, 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 de actualización.

17 de febrero de 2020

Funciones

• El tamaño máximo de carga de una foto se incrementó de 75 MB a 200 MB.
• Cuando subes archivos, debes especificar un tipo de MIME en la etapa de carga de bytes.
• Ahora especificarás los nombres de archivo cuando crees un elemento multimedia, en lugar de hacerlo cuando subas bytes de contenido multimedia. La nueva propiedad fileName de simpleMediaItem admite cadenas UTF-8. Aún puedes especificar el nombre de archivo de un elemento multimedia cuando subes bytes de contenido multimedia. Sin embargo, 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

• Error 131874809: Se agregó una nueva propiedad isOwned en shareInfo para identificar si el usuario es el propietario del álbum compartido. Hay más detalles disponibles en la guía para desarrolladores sobre uso compartido de contenido multimedia.

Problemas corregidos

• Problema 131711405: faltaba la propiedad shareableUrl en la respuesta albums.list.
• Error 113870729: mediaItems.list a veces mostró elementos multimedia duplicados en los límites de la página.
• Error 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

• Error 110188560: Se agregó un filtro de búsqueda para seleccionar elementos multimedia que se marcaron como favoritos: FeatureFilter.
• Nuevas categorías de contenido para ContentFilter a fin de filtrar elementos multimedia que coincidan con categorías específicas: ARTS, CRAFTS, FASHION, HOUSES, GARDENS, FLOWERS, 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 realizaron llamadas nuevas para agregar y quitar elementos multimedia existentes en un álbum:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

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

• La llamada de REST para crear elementos multimedia mediaItems.batchCreate ahora muestra el estado HTTP 207 MULTI-STATUS para un éxito 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 trasladaron a un paquete dedicado nuevo. 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 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 base. Puedes supervisar esta cuota en la Consola de APIs de Google.

Problemas corregidos

• Error 124355983: Errores 500 cuando se llama a mediaItems.get para algunos elementos multimedia compartidos.

21 de enero de 2019

Problemas corregidos

• Problema 121998358: faltaba la propiedad isWriteable en la respuesta 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

• Nueva llamada a mediaItems.batchGet para recuperar varios elementos multimedia según sus identificadores
• Error 111279349: Se agregó una nueva llamada a sharedAlbums.leave para salir de un álbum que se unió.
• Error 111279347: Se agregó una nueva llamada a albums.unshare para marcar un álbum compartido como privado.

Problemas corregidos

• Error 113978705: Las descripciones establecidas en mediaItems.batchCreate se convirtieron en entidades HTML.
• Error 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: Errores 403 cuando se accede a las URL base.
• Problema 115932469: Cargas que fallan con error de cuota.

6 de septiembre de 2018

Funciones

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

Notas

• La API de la Biblioteca de Google Fotos ahora está disponible para el público en general. Gracias por tus comentarios y solicitudes de funciones durante el período de vista previa para desarrolladores de la API de Library.
• Consulta las guías nuevas para comenzar a usar las bibliotecas cliente de Java y PHP.
• Se agregaron ejemplos de fragmentos de código Java y PHP a las guías para demostrar el uso de las bibliotecas cliente.

5 de septiembre de 2018

Funciones

• Nueva llamada a sharedAlbums.get para obtener un álbum con shareToken
• 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 mediaItems.batchCreate.
• Problema 110237685: Se corrigió el error de carga de archivos relacionado con CORS.
• Error 79318118: No se mantuvo un orden coherente cuando se subían varios elementos a un álbum en la llamada mediaItems.batchCreate.

Notas

• Si almacenaste IDs (como IDs de álbumes, elementos multimedia o elementos de enriquecimiento) antes del 5 de septiembre de 2018, ya no funcionarán debido a los cambios de formato. Deberás obtener nuevos IDs para usar en tu solicitud.
• Se cambió el nombre de la propiedad totalMediaItems del recurso álbum por mediaItemsCount.
• Se cambió el valor máximo del parámetro pageSize en las llamadas mediaItems.list y mediaItems.search a 100. La cantidad predeterminada de elementos multimedia que se muestran cuando no se especifica el parámetro pageSize se cambió a 25.
• Las guías para enumerar el contenido de la biblioteca, Compartir contenido multimedia y Cómo acceder a los 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

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

Problemas corregidos

• Problema 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 sobre cargas reanudables para conocer el protocolo actualizado.
• Error 79497397: falta la propiedad isWriteable en la respuesta albums.list.
• Error 111143493: El filtro de categoría de contenido PEOPLE mostraba resultados imprecisos.
• Problema 111056278: El filtro de categoría de contenido BIRTHDAYS mostraba un error.

Versión preliminar: 8 de mayo de 2018

Versión inicial de la API de la Biblioteca.

Errores conocidos

• GET mediaItem arroja un error si el elemento multimedia id que recibe es para un elemento de un álbum compartido que 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 sube varios elementos.
• batchCreate no admite el orden (agregar un position) cuando se crean elementos multimedia en un álbum compartido como propietario del álbum compartido. La configuración predeterminada es el final del álbum.