Inizia a utilizzare l'API Library

L'API Library ti consente di interagire con foto, video e album all'interno delle raccolte di Google Foto degli utenti, ma con un'attenzione importante: puoi accedere e gestire solo i contenuti creati dalla tua applicazione.

Prima di iniziare

• Dai un'occhiata alla panoramica: confronta l'API Picker e l'API Library per assicurarti che l'API Library sia adatta al tuo caso d'uso.
• Configura l'app: abilita l'API e configura l'autenticazione. Per la procedura dettagliata, consulta Configurare l'app.

Casi d'uso principali dell'API Library

L'API Library è la soluzione ideale per gli scenari in cui la tua app deve:

• Carica e archivia contenuti multimediali: importa in sicurezza foto e video (generati dalla tua app) nelle raccolte di Google Foto degli utenti.
• Organizza i contenuti: crea e gestisci album per aiutare gli utenti a organizzare i contenuti multimediali correlati all'app.
• Migliora foto e album: aggiungi contesto ad elementi multimediali e album tramite arricchimenti come titoli, descrizioni o informazioni sulla posizione.
• Accedere ai dati creati dall'app: recuperare e interagire con le foto, i video e gli album creati in precedenza dalla tua app.

Flusso di lavoro tipico dell'API Library

Sebbene l'API Library offra varie funzionalità, un flusso di lavoro comune potrebbe includere i seguenti passaggi:

1. Caricamento di contenuti multimediali: utilizza l'endpoint per il caricamento per caricare in modo sicuro byte di foto o video su Google Foto. Questo passaggio genera una uploadToken.

2. Crea elementi multimediali: utilizza il metodo mediaItems.batchCreate, fornendo uploadToken, per creare elementi multimediali nella raccolta dell'utente.

3. Crea album (facoltativo): utilizza il metodo albums.create per creare album all'interno della raccolta dell'utente per organizzare i contenuti multimediali.

4. Gestire gli album:

   • Aggiungi elementi multimediali (creati dalla tua app) agli album utilizzando albums.batchAddMediaItems.
   • Rimuovi gli elementi multimediali dagli album utilizzando albums.batchRemoveMediaItems.
   • Aggiungi arricchimenti agli album (ad esempio titoli o località) utilizzando albums.addEnrichment.
   • Recupera informazioni su album specifici utilizzando albums.get.
   • Elencare gli album creati dalla tua app utilizzando albums.list.

5. Accedere ai contenuti multimediali creati dall'app:

   • Recupera i dettagli su elementi multimediali specifici utilizzando mediaItems.get o mediaItems.batchGet.
   • Cerca elementi multimediali creati dalla tua app utilizzando mediaItems.search.
   • Elenca gli elementi multimediali all'interno di un album creato con un'app specifica utilizzando mediaItems.search con l'ID album.

Passaggi successivi

• Esamina la documentazione di riferimento: consulta la documentazione di riferimento dell'API Library per scoprire tutti i metodi e i parametri disponibili.
• Prova gli esempi: dai un'occhiata al nostro esempio per vedere l'API Library in azione e trovare ispirazione per la tua integrazione.