Guida all'API Drive v2

Se utilizzi la versione 2 dell'API Google Drive, la maggior parte dei contenuti della Guida all'API di Google Drive v3 riguarda anche la versione 2. Questa sezione contiene tutte le informazioni specifiche della versione 2 e diverse da quelle mostrate in pagine specifiche della guida della versione 3. Per il contesto completo, ogni sottosezione contiene il link alla pagina della guida corrispondente.

Per un elenco completo delle differenze, consulta la documentazione di riferimento per il confronto tra API Drive v2 e v3.

Scaricare e pubblicare revisioni di file

Nella pagina Scarica e pubblica revisioni dei file, le seguenti informazioni sono specifiche per la versione 2 e sostituiscono le sezioni mostrate per la versione 3:

Elencare e scaricare le singole revisioni

Una volta ottenuto un elenco delle revisioni di un file, puoi scaricare i contenuti di qualsiasi revisione inviando una richiesta GET autorizzata alla relativa []downloadUrl](/drive/api/reference/rest/v2/revisions). Quando richiedi la revisione, Google Drive genera questo URL di breve durata. Non fare affidamento su questo prodotto per uso futuro.

Puoi anche esportare la revisione in uno dei formati supportati selezionando la proprietà exportLinks.

Proprietà file personalizzate

Oltre a quelle presenti nella pagina Aggiungi proprietà file personalizzate, le seguenti informazioni sono specifiche per la versione 2:

Le proprietà sono accessibili utilizzando la risorsa properties.

Questa è la struttura di una proprietà tipica che può essere utilizzata per archiviare l'ID del database di un file di Drive nel file.

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

Per saperne di più sui limiti, consulta properties nella documentazione di riferimento.

Attiva il supporto dei Drive condivisi

Oltre alle informazioni nella pagina Implementare il supporto dei Drive condivisi, sostituisci questo campo aggiuntivo trashedDate per la versione 2.

In Implementare il supporto dei Drive condivisi, i seguenti metodi richiedono supportsAllDrives=true quando si utilizzano i contenuti dei Drive condivisi:

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

I metodi changes.get e changes.list hanno diversi parametri specifici dei Drive condivisi. Per un elenco dei parametri, consulta la sezione Monitorare le modifiche su un Drive condiviso.

Carica i file

Nella pagina Carica i dati del file, tieni presente che queste informazioni sono specifiche per la versione 2:

Importa in Documenti Google

Quando crei un file su Google Drive, puoi convertire alcuni tipi di file in un documento di Documenti, Fogli o Presentazioni Google. Includi i parametri di query convert files.insert e imposta la proprietà mimeType (workspace_name) del file. Per ulteriori informazioni, consulta la sezione Caricare i dati dei file.

Condividere file, cartelle e Drive

Nota nella pagina Condivisione di file, cartelle e unità, nella v3, solo un campo, role, che specifica i ruoli effettivi per utente, gruppo o dominio. Nella versione v2, i campi role e additionalRoles di un'autorizzazione richiedono i ruoli effettivi dell'utente, del gruppo o del dominio per un determinato elemento.

Differenze nelle query di ricerca per la versione 2

Il campo title della versione 2 è name nella versione 3. Per alcuni esempi, vedi Cercare file e cartelle.

Il campo createdDate della versione 2 è createdTime nella versione 3. Per alcuni esempi, vedi Cercare Drive condivisi.

Il campo modifiedDate della versione 2 è modifiedTime nella versione 3. Il campo lastViewedByMeDate della versione 2 è viewedByMeTime nella versione 3. Per maggiori dettagli, consulta Termini e operatori delle query di ricerca.