Note di rilascio

Iscriviti a queste note di rilascio.

Questa pagina viene aggiornata a ogni nuova release delle API di Google Foto. Il changelog elenca le release per data e include eventuali nuove funzionalità, correzioni di bug e altre modifiche.

La documentazione e le guide rimandano all'ultima versione da utilizzare.

1° aprile 2025

Note

Questa release implementa le modifiche annunciate in precedenza alle API di Foto.

• Rimozione di alcuni ambiti dall'API Library.
• Limitazione di diversi metodi per funzionare solo con i contenuti creati dall'app.
• Le nuove norme per gli sviluppatori e per i dati degli utenti delle API di Foto entrano in vigore al posto delle vecchie Norme di utilizzo accettabile.

Per informazioni complete, leggi l'articolo Aggiornamenti delle API di Google Foto.

16 settembre 2024

Funzionalità

• È stata introdotta la nuova API Picker per la selezione di foto sicura e intuitiva.

Note

In questa release abbiamo annunciato modifiche importanti all'API Library (in vigore dal 31 marzo 2025).

• L'API Library gestirà solo le foto e i video creati dalla tua app.
• Rimozione degli ambiti photoslibrary.readonly, photoslibrary.sharing e photoslibrary.
• Limitazione di diversi metodi solo ai contenuti creati dalle app.

I dettagli completi sono riportati nella pagina Aggiornamenti delle API di Google Foto.

27 ottobre 2022

Note

• Il codelab "Crea un'app di condivisione di foto con Google Foto e Flutter" non è più disponibile. Consulta i nostri altri esempi e fai riferimento al codice di esempio nelle nostre guide.

1 giugno 2022

Note

• Sono state aggiunte best practice per il caricamento per aiutare a chiarire la procedura di caricamento, segnalare gli errori comuni e come evitarli e fornire suggerimenti per migliorare l'efficienza del caricamento.

27 ottobre 2021

Funzionalità

• Programma partner di Google Foto: lancio del livello Premier. Il livello Premier è una suite di funzionalità API avanzate che sfruttano la potente intelligenza artificiale di Google Foto.

29 settembre 2021

Funzionalità

• Nuova opzione per ordinare le ricerche in base al filtro delle date. I risultati possono essere ordinati dal più recente al meno recente o viceversa. In questo modo, la ricerca è più facile e le efficienze migliorano grazie a risultati di ricerca più mirati.

21 luglio 2021

Funzionalità

• Nuovo parametro -no per gli URL di base dei video per caricare le miniature senza l'overlay del pulsante di riproduzione. Per impostazione predefinita, le miniature dei video vengono caricate con un overlay del pulsante di riproduzione. Questo nuovo parametro ti consente di nascondere il pulsante di riproduzione nelle miniature dei video.

Problemi risolti

• Problema 181282432: le miniature dei video vengono sempre visualizzate con un pulsante di riproduzione sovrapposto.

25 maggio 2021

Problemi risolti

• La proprietà exposureTime non è stata compilata per i metadati photo negli elementi multimediali.

19 maggio 2021

Note

• La documentazione relativa all'URL di base per le foto dinamiche è stata aggiornata per chiarire il comportamento del parametro =dv per le foto dinamiche di Android e le Live Photo di iOS.

11 febbraio 2021

Note

• Le Norme di utilizzo accettabile sono state aggiornate con l'aggiunta di contenuti sulla pubblicità e sulla riduzione al minimo dell'utilizzo dei dati.

7 luglio 2020

Funzionalità

• L'API è stata aggiornata per supportare i nuovi controlli della condivisione in Google Foto. Un nuovo campo, isJoinable, viene ora restituito come parte della proprietà shareInfo per gli album condivisi. L'API può aggiungere utenti a un album condiviso quando isJoinable è true. Se un proprietario ha disattivato la condivisione tramite link per un album in Google Foto, isJoinable sarà false e l'API non potrà invitare gli utenti a quel determinato album.
• Problemi 111405623, 116379853, 117685011: ora puoi modificare i titoli e le foto di copertina degli album, e modificare le descrizioni degli elementi multimediali creati dalla tua app. Richiedi il nuovo ambito di autorizzazione photoslibrary.edit.appcreateddata per l'accesso in aggiornamento.

17 febbraio 2020

Funzionalità

• La dimensione massima del file di caricamento di una fotografia è stata aumentata da 75 MB a 200 MB.
• Quando carichi i file, ora devi specificare un tipo MIME nella fase di caricamento dei byte.
• Ora puoi specificare i nomi file durante la creazione di un elemento media, anziché durante il caricamento dei byte multimediali. La nuova proprietà fileName in simpleMediaItem supporta le stringhe UTF-8. Puoi comunque specificare il nome file di un elemento multimediale durante il caricamento dei byte multimediali, ma ti consigliamo vivamente di aggiornare l'implementazione.

Note

• Le Norme di utilizzo accettabile sono state aggiornate con alcuni dettagli aggiuntivi incentrati sulla riduzione al minimo dell'utilizzo e dell'archiviazione dei dati.
• La documentazione sull'URL di base è stata aggiornata per includere le foto in movimento.

16 agosto 2019

Funzionalità

• Issue 131874809: nuova proprietà isOwned in shareInfo per identificare se l'utente è il proprietario dell'album condiviso. Maggiori dettagli sono disponibili nella guida per gli sviluppatori relativa alla condivisione di contenuti multimediali.

Problemi risolti

• Problema 131711405: la proprietà shareableUrl non era presente nella risposta albums.list.
• Problema 113870729: mediaItems.list a volte restituiva elementi multimediali duplicati ai confini delle pagine.
• Problema 93428763: il campo status per i metadati dei video ora restituisce correttamente il valore VideoProcessingStatus della qualità video più alta disponibile.

12 giugno 2019

Funzionalità

• Issue 110188560: nuovo filtro di ricerca per selezionare gli elementi multimediali contrassegnati come preferiti: FeatureFilter.
• Nuove categorie di contenuti per ContentFilter per filtrare gli elementi multimediali corrispondenti a categorie specifiche: ARTS, CRAFTS, FASHION, HOUSES, GARDENS, FLOWERS, HOLIDAYS.

Note

• Linee guida per l'esperienza utente aggiornate che forniscono ulteriori indicazioni per la denominazione di progetti e album.

7 maggio 2019

Codelab

• Nuovo codelab: crea un'app di condivisione di foto con Google Foto e Flutter. Scopri come creare un'app di condivisione di foto utilizzando l'API Libreria di Google Foto in Flutter. Per maggiori dettagli, consulta la guida ai sample.

29 aprile 2019

Funzionalità

• Problema 109505022: nuove chiamate per aggiungere e rimuovere elementi multimediali esistenti da un album:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  Queste chiamate supportano gli elementi multimediali e gli album creati dalla tua applicazione. Ulteriori dettagli sono disponibili nella guida per gli sviluppatori sulla gestione degli album.

• La chiamata REST per la creazione di elementi multimediali mediaItems.batchCreate ora restituisce lo stato HTTP 207 MULTI-STATUS per un buon esito parziale se non è stato possibile creare alcuni elementi media. Ulteriori dettagli sono disponibili nella guida per gli sviluppatori sul caricamento di contenuti multimediali.

Note

• Le versioni più recenti delle librerie client includono una modifica che provoca un errore. I corsi relativi a MediaItem, Album e DateRange sono stati spostati in un nuovo pacchetto dedicato. La loro funzionalità non è cambiata, ma solo la loro posizione nella biblioteca client. Consulta le note di rilascio della libreria client Java (1.2.0) e della libreria client PHP (1.2.0).

14 febbraio 2019

Note

• Si applica un nuovo limite di quota per l'accesso ai byte dei contenuti multimediali dagli URL di base. Puoi monitorare questa quota nella console API di Google.

Problemi risolti

• Problema 124355983: errori 500 durante la chiamata a mediaItems.get per alcuni elementi multimediali condivisi.

21 gennaio 2019

Problemi risolti

• Problema 121998358: la proprietà isWriteable era mancante nella risposta albums.create.

7 gennaio 2019

Problemi risolti

• Problema 118464845: mediaItems.list ha restituito troppe pagine vuote.
• Problema 111714379: mediaItems.search ha restituito la metà di pageSize.

30 novembre 2018

Funzionalità

• Nuova chiamata mediaItems.batchGet per recuperare più elementi multimediali in base ai relativi identificatori.
• Issue 111279349: nuova chiamata sharedAlbums.leave per uscire da un album a cui hai aderito.
• Issue 111279347: nuova chiamata albums.unshare per contrassegnare un album condiviso come privato.

Problemi risolti

• Problema 113978705: le descrizioni impostate in mediaItems.batchCreate sono state convertite in entità HTML.
• Problema 114462217: non è stato possibile impostare il nome dei file video in mediaItems.batchCreate.
• Problema 118475587: sono stati restituiti URL dei prodotti non validi per gli elementi multimediali.
• Problema 111862704: errori 403 durante l'accesso agli URL di base.
• Issue 115932469: i caricamenti non riescono con un errore di quota.

6 settembre 2018

Funzionalità

• Ora sono disponibili le librerie client Java e PHP.

Note

• L'API Google Photos Library è diventata disponibile a livello generale. Grazie per i feedback e le richieste di funzionalità durante il periodo di anteprima per sviluppatori dell'API Library.
• Consulta le nuove guide per iniziare a utilizzare le librerie client Java e PHP.
• Alle guide sono stati aggiunti snippet di codice Java e PHP di esempio per dimostrare l'utilizzo delle librerie client.

5 settembre 2018

Funzionalità

• Nuova chiamata sharedAlbums.get per ricevere un album utilizzando shareToken.
• Nuova proprietà isJoined in shareInfo per identificare se l'utente ha aderito all'album condiviso.

Problemi risolti

• Problema 79321120: la proprietà mimeType non era presente nella risposta di mediaItems.batchCreate per gli elementi multimediali video.
• Problema 79319272: proprietà come mediaMetadata, contributorInfo non erano presenti nella risposta mediaItems.batchCreate.
• Problema 110237685: è stato risolto il problema di caricamento dei file correlato a CORS.
• Problema 79318118: non veniva mantenuto un ordine coerente quando si caricavano più elementi in un album nella chiamata mediaItems.batchCreate.

Note

• Se hai archiviato ID (ad esempio ID di album, elementi multimediali o elementi di arricchimento) prima del 5 settembre 2018, questi non funzioneranno più perché il formato è cambiato. Dovrai ottenere nuovi ID da utilizzare nella tua applicazione.
• La proprietà totalMediaItems della risorsa album è stata rinominata in mediaItemsCount.
• Il valore massimo del parametro pageSize nelle chiamate mediaItems.list e mediaItems.search è stato modificato in 100. Il numero predefinito di elementi multimediali restituiti quando il parametro pageSize non è specificato è stato modificato in 25.
• Le guide Elenca i contenuti della raccolta, Condividi contenuti multimediali e Accedi agli elementi multimediali aggiornate con la excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) funzionalità di filtro rilasciata il 31 luglio 2018.

31 luglio 2018

Funzionalità

• Nuova chiamata mediaItems.list per elencare gli elementi multimediali.
• Nuovo filtro excludeNonAppCreatedData per cercare elementi o elencare gli album creati dalla tua app.
• Nuovi parametri per accedere alle immagini:
  • Problema 79871479: parametro di ritaglio c per ritagliare l'immagine in base a dimensioni esatte.
  • Issue 110343547, Issue 111228390: d parametro di download, per scaricare l'immagine originale.
• La chiamata sharedAlbums.join ora restituisce un album.
• Problema 109655786: album ora contiene l'ID elemento multimediale della foto di copertina, coverPhotoMediaItemId.
• Problema 79656863: mediaItem ora contiene il nome file dell'elemento multimediale, filename.

Problemi risolti

• Problema 79757390: il nome del file non veniva impostato durante le richieste di caricamento. Consulta i campi X-Goog-Upload-File-Namefile e X-Goog-Upload-Protocol nella guida Caricare contenuti multimediali.
• Problema 80182372: i caricamenti ripristinabili hanno restituito un errore. Per il protocollo aggiornato, consulta la nuova guida ai caricamenti riprendebili.
• Problema 79497397: proprietà isWriteable mancante nella risposta albums.list.
• Problema 111143493: il filtro della categoria di contenuti PEOPLE restituiva risultati inaccurati.
• Problema 111056278: il filtro della categoria di contenuti BIRTHDAYS restituiva un errore.

Versione di anteprima - 8 maggio 2018

Versione iniziale dell'API Library.

Problemi noti

• GET mediaItem genera un errore se l'elemento multimediale id che riceve è di un elemento multimediale di un album condiviso e non è di proprietà dell'utente.
• La risposta alla chiamata batchCreate non restituirà mediaMetadata o contributorInfo.
• Se l'elemento multimediale è un video, la chiamata batchCreate non restituirà un mimeType.
• batchCreate non mantiene un ordine coerente durante il caricamento di più elementi.
• batchCreate non supporta l'ordinamento (aggiunta di un position) quando crei elementi multimediali in un album condiviso come proprietario dell'album. Per impostazione predefinita, viene visualizzata la fine dell'album.