Guida all'API Drive v2

Se utilizzi l'API Google Drive versione 2, la maggior parte dei contenuti della Guida all'API Google Drive v3 si applica anche alla v2. Questa sezione contiene tutte le informazioni specifiche della v2 e diverse da quelle mostrate nelle pagine specifiche della guida v3. Per avere 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 l'API Drive v2 e v3.

Scaricare e pubblicare le revisioni dei file

Nella pagina Scaricare e pubblicare le revisioni dei file , le seguenti informazioni sono specifiche della v2 e sostituiscono queste sezioni mostrate per la v3:

Elencare e scaricare le singole revisioni

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

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

Proprietà dei file personalizzate

Oltre alle informazioni riportate nella pagina Aggiungere proprietà dei file personalizzate, le seguenti informazioni sono specifiche della v2:

Si accede alle proprietà utilizzando la properties risorsa.

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.

Attivare il supporto dei Drive condivisi

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

In Implementare il supporto dei Drive condivisi, i seguenti metodi richiedono supportsAllDrives=true quando si lavora con 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 per i Drive condivisi. Per un elenco dei parametri, consulta la sezione Monitorare le modifiche in un Drive condiviso.

Caricare file

Nella pagina Caricare i dati dei file, tieni presente che queste informazioni sono specifiche della v2:

Tipi di importazione in Documenti Google

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

Condividere file, cartelle e Drive

Tieni presente che nella pagina Condividere file, cartelle e Drive, nella v3 solo un campo, role, specifica i ruoli effettivi per utente, gruppo, o dominio. Nella v2, devi avere sia i campi role sia additionalRoles di un'autorizzazione che riflettano i ruoli effettivi che l'utente, il gruppo o il dominio hanno per un determinato elemento.

Differenze nelle query di ricerca per la v2

Il campo title della v2 è name nella v3. Per esempi, consulta Cercare file & cartelle.

Il campo createdDate della v2 è createdTime nella v3. Per esempi, consulta Cercare Drive condivisi.

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