Creare e gestire file

Questa guida spiega come creare e gestire i file in 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 valore kind di drive.file, un id, un name di "Untitled" 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, vedi Limiti di file e cartelle.

Creare file di soli 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 vengono visualizzati nello stesso modo per tutti gli utenti, mentre campi come viewedByMeTime contengono valori specifici dell'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 una scorciatoia 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 più comuni, oppure puoi fornire un'immagine in miniatura generata dalla tua app. Per ulteriori informazioni, vedi 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 saperne di più sugli ambiti di Drive, vedi Scegliere gli ambiti API Google Drive.

Limiti e considerazioni

Mentre ti prepari a copiare i file, tieni presente i seguenti limiti e considerazioni:

  • Autorizzazioni:

    • La limitazione del file di copyRequiresWriterPermission determina chi può copiare il file. Per ulteriori informazioni, consulta 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 ulteriori informazioni, consulta Funzionalità.
    • L'utente che ha creato la copia è il proprietario del file copiato. 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 solo in una 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: