Guida al confronto tra API Drive v2 e v3

L'ultima versione dell'API Google Drive è la v3. Le prestazioni della v3 sono migliori perché le ricerche restituiscono solo un sottoinsieme di campi. Utilizza la versione attuale a meno che tu non abbia bisogno della v2. Se utilizzi la v2, valuta la migrazione alla v3. Per eseguire la migrazione, consulta Esegui la migrazione all'API Drive v3. Per un elenco completo delle differenze tra le versioni, consulta il riferimento di confronto tra l'API Drive v2 e v3.

Se vuoi continuare a utilizzare la v2, consulta la Guida alla modifica dell'API Drive v2 per scoprire come alcune istruzioni nelle guide della v3 devono essere modificate per gli sviluppatori della v2.

Per scoprire di più sui miglioramenti dell'API Drive v3, puoi guardare il seguente video in cui gli ingegneri di Google parlano della nuova progettazione dell'API.

Miglioramenti della v3

Per ottimizzare le prestazioni e ridurre la complessità del comportamento dell'API, la v3 offre i seguenti miglioramenti rispetto alla versione precedente dell'API:

  • Per impostazione predefinita, le ricerche di file e Drive condivisi non restituiscono risorse complete, ma solo un sottoinsieme di campi di uso comune. Per maggiori dettagli su fields, consulta il metodo files.liste il metodo drives.list.
  • Quasi tutti i metodi che restituiscono una risposta ora richiedono il parametro fields. Per un elenco di tutti i metodi che richiedono fields, consulta il Riferimento dell'API Drive.
  • Le risorse con funzionalità duplicate sono state rimosse. Ecco alcuni esempi:
    • Il metodo files.list svolge la stessa funzionalità delle raccolte Children e Parents, pertanto viene rimosso dalla v3.
    • I metodi Realtime.* sono stati rimossi.
  • Per impostazione predefinita, i dati delle app non vengono restituiti nelle ricerche. Nella v2, puoi impostare l'ambito drive.appdata e vengono restituiti i dati dell'applicazione dal files.list metodo e dal changes.list metodo, ma le prestazioni rallentano. Nella v3, imposta l'ambito drive.appdata e anche il parametro di query spaces=appDataFolder per richiedere i dati dell'applicazione.
  • Tutte le operazioni di aggiornamento utilizzano PATCH anziché PUT.
  • Per esportare i documenti Google, utilizza il files.export metodo.
  • Il comportamento del metodo changes.list è diverso. Invece degli ID di modifica, utilizza i token di pagina opachi. Per eseguire il polling della raccolta di modifiche, chiama prima il changes.getStartPageToken metodo per il valore iniziale. Per le query successive, il metodo changes.list restituisce il valore newStartPageToken.
  • I metodi di aggiornamento ora rifiutano le richieste che specificano campi non scrivibili.
  • I campi exportFormats e importFormats della v2 nella risorsa about sono elenchi di formati di importazione o esportazione consentiti. Nella v3, sono mappe di tipi MIME di possibili target per tutte le importazioni o esportazioni supportate.
  • Gli alias appdata e appfolder della v2 ora sono appDataFolder nella v3.
  • La risorsa properties viene rimossa dalla v3. La files risorsa ha il properties campo che contiene coppie chiave-valore vere. Il campo properties contiene proprietà pubbliche e il campo appProperties contiene proprietà private, quindi il campo di visibilità non è necessario.
  • Il campo modifiedTime nella risorsa files aggiorna l'ultima volta che qualcuno ha modificato il file. Nella v2, il campo modifiedDate era modificabile solo durante l'aggiornamento se impostavi il campo setModifiedDate.
  • Il campo viewedByMeTime nella risorsa files non viene aggiornato automaticamente.
  • Per importare i formati di Documenti Google, imposta il mimeType di destinazione appropriato nel corpo della risorsa. Nella v2, imposta ?convert=true.
  • Le operazioni di importazione restituiscono un errore 400 se il formato non è supportato.
  • I lettori e i commentatori non possono visualizzare le autorizzazioni.
  • L'alias me per le autorizzazioni viene rimosso.
  • Alcune funzionalità erano disponibili come parte della risorsa della richiesta, ma ora sono disponibili come parametro della richiesta. Ad esempio:
    • Nella v2, puoi utilizzare children.delete per rimuovere un file secondario da una cartella principale.
    • Nella v3, utilizza files.update sul file secondario con ?removeParents=parent_id nell'URL.

Altre differenze

I nomi dei campi e dei parametri sono diversi nella v3. Ecco alcuni esempi:

  • La proprietà name sostituisce title nella risorsa files.
  • Time è il suffisso per tutti i campi di data e ora anziché Date.
  • Le operazioni di elenco non utilizzano il campo items per contenere il set di risultati. Il tipo di risorsa fornisce un campo per i risultati (ad esempio files o changes).