Aggiornamenti alle API di Google Foto

Pubblicato a settembre 2024.

Questa pagina fornisce dettagli su modifiche specifiche apportate alle API di Google Foto. Esamina i dettagli in questa pagina per capire in che modo i metodi e gli ambiti che utilizzi potrebbero essere interessati. Puoi scoprire di più sull'annuncio di queste modifiche nel post del blog correlato.

API Library: impatto sui casi d'uso comuni

Le sezioni seguenti descrivono in dettaglio l'impatto delle modifiche imminenti sui casi d'uso comuni.

Caricamento di elementi multimediali e creazione di album

Cosa cambia: nessuna modifica. Puoi continuare a caricare elementi multimediali e creare album utilizzando l'ambito photoslibrary.appendonly.

Che cosa puoi fare:

Se la tua app carica elementi multimediali o crea album, assicurati di utilizzare l'ambito photoslibrary.appendonly e non photoslibrary. L'ambito photoslibrary è in fase di rimozione.

Elenco, ricerca e recupero di elementi multimediali e album

Cosa cambia: ora puoi elencare, cercare e recuperare solo gli album e gli elementi multimediali creati dalla tua app.

Che cosa puoi fare:

• Se la tua app richiede agli utenti di selezionare foto o album dall'intera raccolta, utilizza la nuova API Picker di Google Foto. In questo modo, gli utenti possono concedere l'accesso a contenuti specifici in modo sicuro e intuitivo.
• Se la tua app si basa sull'accesso all'intera raccolta dell'utente, potresti dover rivalutare la tua app o prendere in considerazione approcci alternativi.

Condivisione e album condivisi

Cosa cambia: gli album condivisi e le funzioni dell'API associate (share, unshare, get, join, leave e list) restituiranno un 403 PERMISSION_DENIED dopo il 31 marzo 2025.

Che cosa puoi fare:

Indirizzare gli utenti all'app Google Foto per gestire la condivisione. Puoi fornire istruzioni chiare o link diretti all'interno della tua app per guidarli.

Gestione degli album creati dall'app: arricchimenti e contenuti degli album

Cosa cambia: il carattere photoslibrary.edit.appcreateddata viene aggiunto ai seguenti tre metodi per la coerenza concettuale:

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

Che cosa puoi fare:

• Se la tua app utilizza già questi metodi, ti consigliamo di adottare l'ambito photoslibrary.edit.appcreateddata per semplificare la procedura di autorizzazione.

API Library: ambiti e metodi interessati

Nell'ambito delle modifiche alle API di Google Foto, abbiamo apportato i seguenti aggiornamenti.

Come mostrato nella pagina di autorizzazione aggiornata, i seguenti ambiti verranno rimossi dall'API Library dopo il 31 marzo 2025:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

Rimarranno disponibili i seguenti ambiti:

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

Questa tabella illustra in dettaglio i metodi e gli ambiti specifici dell'API Library interessati.

Aggiornamenti	Metodi	Ambiti
Ora questi metodi possono essere utilizzati solo con gli album e gli elementi multimediali creati dalla tua app.	albums.create mediaItems.batchCreate	Ambito rimanente: photoslibrary.appendonly Ambiti rimossi: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Ambito rimanente: photoslibrary.readonly.appcreateddata Ambiti rimossi: photoslibrary photoslibrary.readonly
Questi metodi non saranno più disponibili.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	Ambito rimanente: Nessuno Ambiti rimossi: photoslibrary.sharing
A questi metodi verrà aggiunto photoslibrary.edit.appcreateddata. Ora questi metodi possono essere utilizzati solo con gli album e gli elementi multimediali creati dalla tua app.	albums.addEnrichment albums.batchAddMediaItems	Ambito rimanente: photoslibrary.appendonly photoslibrary.edit.appcreateddata Ambiti rimossi: photoslibrary
	albums.batchRemoveMediaItems	Ambito rimanente: photoslibrary.edit.appcreateddata Ambiti rimossi: photoslibrary
Questi metodi rimarranno invariati.	albums.patch mediaItems.patch	Ambito rimanente: photoslibrary.edit.appcreateddata Ambiti rimossi: Nessuno

Aggiornamenti alle norme dell'API di Foto

Le attuali norme relative all'utilizzo accettabile verranno sostituite dopo il 31 marzo 2025 con le nuove norme relative ai dati utente e agli sviluppatori dell'API di Foto. La nuova norma è ora disponibile per l'anteprima.

Aggiornamenti alla documentazione dell'API Photos

Abbiamo apportato modifiche significative alla documentazione dell'API di Foto per riflettere gli aggiornamenti imminenti e supportare la tua esperienza di sviluppo:

• Sito delle API di Foto unificate:abbiamo consolidato tutte le risorse dell'API di Foto in un'unica posizione (questo sito), offrendo un'esperienza semplificata per gli sviluppatori. Qui troverai:
  • Risorse centralizzate:istruzioni di configurazione e linee guida generali sull'utilizzo, nonché informazioni di assistenza e sulle norme sia per l'API Picker sia per l'API Library.
  • Siti API dedicati: singoli siti con guide dettagliate, documentazione di riferimento ed esempi di codice per l'API Picker e l'API Library
• Contenuti dell'API Library aggiornati: la documentazione dell'API Library è stata rivista in modo da riflettere le funzionalità dell'API Library dopo il periodo di ritiro.
• Documentazione precedente conservata: abbiamo mantenuto la documentazione dell'API Library originale per gli sviluppatori che devono eseguire la migrazione delle integrazioni esistenti. Se stai avviando un nuovo progetto, utilizza la documentazione aggiornata. Se stai aggiornando un progetto esistente, consulta la documentazione precedente e quella aggiornata in base alle esigenze durante la migrazione.

Domande frequenti

Cosa cambia con le API di Google Foto?

Stiamo introducendo la nuova API Picker di Google Foto per la selezione sicura delle foto e aggiornando l'API Library esistente per concentrarci sulla gestione di foto e video creati dalla tua app.

Quando entreranno in vigore queste modifiche?

Queste modifiche entreranno in vigore il 31 marzo 2025. Invitiamo tutti gli utenti con integrazioni esistenti che utilizzano l'API Library per la selezione delle foto a eseguire la migrazione all'API Picker il prima possibile.

In che modo l'API Library sarà interessata?

Gli ambiti photoslibrary.readonly, photoslibrary.sharing e photoslibrary verranno rimossi. Le chiamate API che si basano solo su questi ambiti restituiranno un valore 403 PERMISSION_DENIED dopo il 31 marzo 2025. Diverse altre chiamate saranno limitate a funzionare solo con foto e video creati dalla tua app.

Puoi esaminare l'insieme completo delle modifiche nella tabella degli ambiti e dei metodi interessati in questa pagina.

Che cosa devo fare se la mia app utilizza attualmente gli ambiti o i metodi interessati?

Se la tua app utilizza uno degli ambiti o dei metodi interessati, ti consigliamo di svolgere i seguenti passaggi:

• Per la selezione delle foto: esegui la migrazione all'API Picker di Google Foto.
• Per altre funzionalità: consulta la documentazione aggiornata dell'API Library per comprendere le modifiche e identificare le funzionalità della tua app che potrebbero non essere più disponibili. Potresti dover modificare la funzionalità della tua app o esplorare soluzioni alternative per alcuni casi d'uso.

Che cos'è l'API Picker di Google Foto?

L'API Picker è un nuovo modo sicuro per consentire agli sviluppatori di consentire agli utenti di selezionare foto e video dalla loro raccolta di Google Foto e di inviarli facilmente alla tua applicazione.

Dove posso trovare ulteriori informazioni su queste modifiche?

Questa pagina che stai visualizzando fornisce una panoramica e un riepilogo di tutte le modifiche.

Il resto della documentazione sul nostro sito è stato aggiornato in base alle API aggiornate.

Questo post del blog annuncia le modifiche.

Cosa succede se ho altre domande o ho bisogno di assistenza per la migrazione della mia applicazione?

Se hai domande sulla documentazione per gli sviluppatori, consulta la nostra pagina di assistenza per ulteriori dettagli su come ricevere aiuto.