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 comprendere come metodi e ambiti 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 seguenti sezioni illustrano in dettaglio l'impatto delle modifiche imminenti sull'uso comune d'uso diversi.

Caricamento di elementi multimediali e creazione di album

Che 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 l'ambito photoslibrary. L'ambito photoslibrary è in fase di rimozione.

Elenco, ricerca e recupero di elementi multimediali e album

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

Che cosa puoi fare:

• Se la tua app richiede che gli utenti selezionino foto o album dall'intera app libreria, utilizza il nuovo selettore di Google Foto tramite Google Cloud. Questo fornisce una protezione un modo semplice per consentire agli utenti di concedere l'accesso a contenuti specifici.
• Se la tua app si basa sull'accesso all'intera raccolta dell'utente, potrebbe essere necessario rivalutare l'app o prendere in considerazione approcci alternativi.

Condivisione e album condivisi

Che cosa cambia: album condivisi e funzioni API associate (condivisione, annulla condivisione, get, join, uscita ed elenca) restituirà un 403 PERMISSION_DENIED dopo 31 marzo 2025.

Che cosa puoi fare:

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

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

Cosa cambia: il carattere photoslibrary.edit.appcreatedata viene aggiunto ai seguenti tre metodi per 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.appcreatedata per semplificare la procedura di autorizzazione.

API Library: ambiti e metodi interessati

Nell'ambito delle nostre modifiche alle API di Google Foto, abbiamo apportato le seguenti modifiche 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

I seguenti ambiti rimarranno invariati:

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

Questa tabella descrive in dettaglio gli ambiti e i metodi 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. Sono inclusi gli elementi multimediali selezionati con l'API Picker e aggiunti alla libreria dell'utente con l'API Library.	albums.create mediaItems.batchCreate	Ambiti rimanenti: photoslibrary.appendonly Ambiti rimossi: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Ambiti rimanenti: photoslibrary.readonly.appcreatedata Ambiti rimossi: photoslibrary photoslibrary.readonly
Questi metodi non saranno più disponibili.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	Ambiti rimanenti: Nessuno Ambiti rimossi: photoslibrary.sharing
A questi metodi verrà aggiunto il metodo photoslibrary.edit.appcreatedata. Ora questi metodi possono essere utilizzati solo con album e elementi multimediali creati dalla tua app. Sono inclusi gli elementi multimediali selezionati con l'API Picker e aggiunti alla raccolta dell'utente con l'API Library.	albums.addEnrichment albums.batchAddMediaItems	Ambito rimanente: photoslibrary.appendonly photoslibrary.edit.appcreatedata Ambiti rimossi: photoslibrary
	albums.batchRemoveMediaItems	Ambiti rimanenti: photoslibrary.edit.appcreatedata Ambiti rimossi: photoslibrary
Questi metodi rimarranno invariati.	albums.patch mediaItems.patch	Ambiti rimanenti: photoslibrary.edit.appcreatedata Ambiti rimossi: Nessuno

Aggiornamenti alle norme dell'API Foto

Le attuali Norme di utilizzo accettabile saranno sostituiti dopo il 31 marzo 2025 con i nuovi dati utente e sviluppatori dell'API Foto Norme. Le nuove norme sono ora disponibili per l'anteprima.

Aggiornamenti alla documentazione dell'API Photos

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

• Sito delle API Unified Photos: abbiamo consolidato tutte le risorse dell'API Photos in un'unica posizione conveniente (questo sito), fornendo una per gli sviluppatori. Qui troverai:
  • Risorse centralizzate: istruzioni per la configurazione combinate e informazioni generali indicazioni sull'uso e il funzionamento combinato informazioni su norme e assistenza per sia l'API Picker sia l'API Library.
  • Siti dedicati alle API: singoli siti con guide dettagliate, documentazione di riferimento ed esempi di codice per il selettore API e la libreria API
• Contenuti aggiornati dell'API Library: la documentazione dell'API Library sia stata modificata per riflettere le sue funzionalità dopo il periodo di ritiro. In tutta la documentazione aggiornata, troverai etichette che evidenziano contenuti modificati o rimossi, con link ai contenuti precedenti corrispondenti come riferimento durante la migrazione.
• Documentazione legacy conservata: abbiamo conservato l'API Library originale documentazione per gli sviluppatori devi eseguire la migrazione delle integrazioni esistenti. Se stai iniziando un nuovo progetto, utilizza la documentazione aggiornata. Se stai aggiornando un progetto esistente, fai riferimento sia alla versione precedente necessaria durante la migrazione.

Domande frequenti

Che cosa cambia per 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. Incoraggiamo tutti con integrazioni esistenti che utilizzano l'API Library per la migrazione della scelta delle foto l'API Picker il prima possibile.

Quali saranno le conseguenze per l'API Library?

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. Molte altre chiamate saranno limitate al solo funzionamento. con foto e video creati dalla tua app.

Puoi esaminare l'insieme completo delle modifiche nella tabella nella parte superiore di 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: segui questi passaggi:

• Per la selezione delle foto: esegui la migrazione all'API Google Foto Selecter.
• Per altre funzionalità: rivedi 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 Google Foto Picker?

L'API Picker è un modo nuovo e sicuro a disposizione degli sviluppatori per consentire agli utenti di selezionare le foto e album dalla raccolta di Google Foto per poi inviarli senza problemi la tua applicazione. L'API Picker offre solide funzionalità di selezione di foto, tra cui la selezione di singoli elementi, la selezione di tutti gli elementi di un album e la ricerca nella raccolta di Google Foto.

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 per riflettere le API aggiornate.

Questo post del blog annunciando le modifiche.

Che cosa posso fare se ho altre domande o ho bisogno di assistenza per la migrazione della mia applicazione?

Se hai domande sulla documentazione per sviluppatori, consulta la nostra assistenza per ulteriori informazioni su come richiedere assistenza.