Creare e gestire file

Questa guida spiega come creare e gestire i file in Google Drive utilizzando l'API Google Drive.

Crea file

Per creare un file in 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, vedi Limiti di file e cartelle.

Crea file solo metadati

I file solo metadati non contengono contenuti. I metadati sono dati (ad esempio name, mimeType e createdTime) che descrivono il file. Campi come name sono indipendenti dall'utente e appaiono uguali per tutti, mentre campi come viewedByMeTime contengono valori specifici per l'utente.

Un esempio di file solo con metadati è una cartella con il tipo MIME application/vnd.google-apps.folder. Per saperne di più, vedi Creare e compilare cartelle. Un altro esempio è una scorciatoia che rimanda a un altro file su Drive con il tipo MIME application/vnd.google-apps.shortcut. Per saperne di più, 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 comuni oppure puoi fornire un'immagine miniatura generata dalla tua app. Per ulteriori informazioni, consulta Caricare le miniature.

Copiare un file esistente

Per copiare un file e applicare gli aggiornamenti richiesti, utilizza il metodo files.copy. Per trovare l'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:

    • L'oggetto DownloadRestrictionsMetadata della risorsa files determina chi può copiare il file. Per saperne di più, vedi Impedire agli utenti di scaricare, stampare o copiare un file.
    • La risorsa del campo capabilities.canCopy determina se l'utente può copiare un file. Per saperne di più, vedi Informazioni sulle funzionalità dei file.
    • 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 in una sola cartella principale. La specifica di più genitori non è supportata. Se il campo parents non è specificato, il file eredita tutti i genitori 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 produce un file con lo stesso nome dell'originale.
    • L'utilizzo eccessivo di files.copy può comportare il superamento dei limiti della quota dell'API Drive. Per ulteriori informazioni, vedi Limiti di utilizzo.

Ecco alcuni passaggi successivi che puoi provare: