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.addEnrichmentalbums.batchAddMediaItemsalbums.batchRemoveMediaItems
Che cosa puoi fare:
- Se la tua app utilizza già questi metodi, ti consigliamo di adottare l'ambito
photoslibrary.edit.appcreatedataper 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.readonlyphotoslibrary.sharingphotoslibrary
I seguenti ambiti rimarranno invariati:
photoslibrary.appendonlyphotoslibrary.readonly.appcreateddataphotoslibrary.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. | Ambiti rimanenti:
|
|
Ambiti rimanenti:
|
||
| Questi metodi non saranno più disponibili. | Ambiti rimanenti:
|
|
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. |
Ambito rimanente:
|
|
Ambiti rimanenti:
|
||
| Questi metodi rimarranno invariati. | Ambiti rimanenti:
|
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.