Creare e gestire file

Questa guida spiega come creare e gestire i file su Google Drive.

Crea file

Per creare un file su Drive che non contenga metadati o contenuti, utilizza il metodo files.create() senza parametri. Al file viene assegnato un kind di drive.file, un id, un name di "Senza titolo" e un mimeType di application/octet-stream. uploadType è contrassegnato come obbligatorio, ma il valore predefinito è media, quindi non devi fornirlo.

Per ulteriori informazioni sui limiti dei file di Drive, consulta Limiti di file e cartelle.

Creare file solo di metadati

I file solo metadati non contengono contenuti. I metadati sono dati (ad esempio name, mimeType e createdTime) che descrivono il file. I campi come name sono indipendenti dall'utente e hanno lo stesso aspetto per ogni utente, mentre campi come viewedByMeTime contengono valori specifici per l'utente.

Un esempio di file solo metadati è una cartella con il tipo MIMEapplication/vnd.google-apps.folder. Per saperne di più, vedi Creare e compilare le cartelle. Un altro esempio è una scorciatoia che fa riferimento a un altro file su Drive con il tipo MIMEapplication/vnd.google-apps.shortcut. Per ulteriori informazioni, vedi Creare un collegamento a un file di Drive.

Gestire le immagini in miniatura

Le miniature aiutano gli utenti a identificare i file di Drive. Drive può generare automaticamente miniature per i tipi di file comuni oppure puoi fornire un'immagine miniatura generata dalla tua app. Per saperne di più, consulta Caricare miniature.

Copiare un file esistente

Per copiare un file e applicare gli eventuali aggiornamenti richiesti, utilizza il metodo files.copy(). Per trovare il fileId da copiare, utilizza il metodo files.list().

Tieni presente che devi utilizzare un ambito API Drive appropriato per autorizzare la chiamata. Per ulteriori informazioni sugli ambiti di Drive, vedi Scegliere gli ambiti dell'API Google Drive.

Limiti e considerazioni

Quando ti prepari a copiare i file, tieni presente questi limiti e considerazioni:

  • Autorizzazioni:

    • La limitazione dei file copyRequiresWriterPermission determina chi può copiare il file. Per saperne di più, vedi Impedire agli utenti di scaricare, stampare o copiare il file.
    • Il campo capabilities/canCopy di una risorsa files determina se l'utente può copiare un file. Per saperne di più, consulta Informazioni sulle funzionalità dei file.
    • Il file copiato è di proprietà dell'utente che ha creato la copia. Nessun'altra impostazione di condivisione del file di origine viene replicata. Se la copia viene creata in una cartella condivisa, eredita le autorizzazioni di quella cartella.
    • La proprietà di un file copiato potrebbe cambiare e la copia potrebbe non ereditare le impostazioni di condivisione del file originale. Potrebbe essere necessario reimpostare queste impostazioni.

  • Gestione dei file:

    • Alcuni file, come le scorciatoie di terze parti, non possono mai essere copiati.
    • Puoi copiare un file in una sola cartella principale. La specifica di più elementi principali non è supportata. Se il campo parents non è specificato, il file eredita tutti gli elementi principali rilevabili dal file di origine.
    • Anche se una cartella è un tipo di file, non puoi copiarla. Crea invece una cartella di destinazione e imposta il campo parents dei file esistenti sulla cartella di destinazione. A questo punto puoi eliminare la cartella di origine originale.
    • A meno che non venga specificato un nuovo nome file, il metodo files.copy() genera un file con lo stesso nome dell'originale.
    • L'uso eccessivo di files.copy() può comportare il superamento dei limiti di quota dell'API Drive. Per ulteriori informazioni, consulta Limiti di utilizzo.

Ecco alcuni passaggi successivi che puoi provare: