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 per la versione 2 e diverse da quelle mostrate in pagine specifiche della guida per la versione 3. Ogni sottosezione contiene il link alla pagina della guida per ottenere un contesto completo.

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

Scaricare e pubblicare revisioni di file

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

Elencare e scaricare singole revisioni

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

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

Proprietà dei file personalizzati

Oltre alle informazioni presenti nella pagina Aggiungi proprietà del file personalizzato, 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 potrebbe essere utilizzata per archiviare l'ID del database di un file di Drive nel file.

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

Per ulteriori informazioni sui limiti, consulta properties nella documentazione di riferimento.

Attiva il supporto dei Drive condivisi

Oltre alle informazioni presenti nella pagina Implementare il supporto di un Drive condiviso, 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 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 per i Drive condivisi. Per un elenco dei parametri, vedi 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 nei tipi di Documenti Google

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

Condividere file, cartelle e Drive

Come noterai nella pagina Condividi file, cartelle e unità nella v3, un solo campo, role, specifica i ruoli effettivi per utente, gruppo o dominio. Nella versione 2, è necessario che entrambi i campi role e additionalRoles di un'autorizzazione riflettano i ruoli effettivi dell'utente, del gruppo o del dominio per un determinato elemento.

Differenze nelle query di ricerca per la v2

Il campo title v2 è name nella versione 3. Ad esempio, vedi Cercare file e cartelle.

Il campo createdDate v2 è createdTime nella versione 3. Ad esempio, vedi Cercare Drive condivisi.

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