Guida all'API Drive v2

Se utilizzi la versione 2 dell'API Google Drive, la maggior parte dei contenuti della Guida all'API 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 alla versione 3. 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 sul confronto tra API Drive v2 e v3.

Scaricare e pubblicare le revisioni dei file

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

Elencare e scaricare 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 proprietà []downloadUrl](/drive/api/reference/rest/v2/revisions). Google Drive genera questo URL di breve durata quando richiedi la revisione. Non fare affidamento su di essa per un uso successivo.

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

Proprietà file personalizzate

Oltre alle informazioni riportate nella pagina Aggiungi proprietà file personalizzate, le seguenti informazioni sono specifiche per la versione 2:

Per accedere alle proprietà viene utilizzata la risorsa properties.

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

{
  '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 viaggi 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 per le unità condivise. Per un elenco dei parametri, consulta la sezione Monitorare le modifiche su un Drive condiviso.

Carica file

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

Tipi di importazione in Documenti Google

Quando crei un file in 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 maggiori informazioni, consulta Caricare i dati dei file.

Condividere file, cartelle e unità

Avviso nella pagina Condividi file, cartelle e unità: nella versione 3 solo un 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 versione 2

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

Il campo createdDate della versione 2 è createdTime nella versione 3. Per alcuni esempi, consulta Cercare unità condivise.

Il campo modifiedDate della versione 2 è modifiedTime nella versione 3. Il campo lastViewedByMeDate v2 è viewedByMeTime in v3. Per maggiori dettagli, vedi Termini e operatori di query di ricerca.