Questa guida spiega come creare e gestire file su Google Drive.
Crea file
Per creare un file su Drive senza metadati o contenuti, utilizza il metodo files.create
senza parametri. Al file vengono assegnati kind
di drive.file
, id
, name
di
"Senza titolo" e mimeType
di application/octet-stream
. uploadType
è
contrassegnato come obbligatorio, ma il valore predefinito è media
, quindi non è necessario
fornirlo effettivamente.
Per ulteriori informazioni sui limiti dei file di Drive, vedi Limiti per file e cartelle.
Creare file solo di metadati
I file di soli metadati non includono contenuti. I metadati sono dati (come name
,
mimeType
e createdTime
) che descrivono il file. I campi come name
sono indipendenti dall'utente e vengono visualizzati nello stesso modo per ogni utente, mentre campi come viewedByMeTime
contengono valori specifici dell'utente.
Un esempio di file solo metadati è una cartella con il tipo MIME application/vnd.google-apps.folder
. Per ulteriori informazioni, consulta l'argomento 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 ulteriori informazioni, consulta 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 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 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 dell'API Drive appropriato per autorizzare la chiamata. Per ulteriori informazioni sugli ambiti di Drive, consulta l'articolo Scegliere gli ambiti API di Google Drive.
Limiti e considerazioni
Mentre ti prepari a copiare i file, tieni presente i seguenti limiti e considerazioni:
Autorizzazioni:
- La limitazione dei file
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 risorsafiles
determina se l'utente può copiare un file. Per ulteriori informazioni, consulta Funzionalità. - Il file copiato è di proprietà dell'utente che ha creato la copia. Nessun'altra impostazione di condivisione del file di origine viene replicata. Se viene creata in una cartella condivisa, la copia 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.
- La limitazione dei file
Gestione file:
- Alcuni file, ad esempio le scorciatoie di terze parti, non possono mai essere copiati.
- Puoi copiare un file solo in una cartella principale. La specifica di più
padri non è supportata. Se il campo
parents
non viene specificato, il file eredita tutti gli elementi principali rilevabili dal file di origine. - Non puoi copiare una cartella anche se è un tipo di file.
Crea invece una cartella di destinazione e imposta il campo
parents
dei file esistenti sulla cartella di destinazione. Puoi quindi 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'uso eccessivo di
files.copy
può comportare il superamento dei limiti di quota dell'API Drive. Per ulteriori informazioni, consulta Limiti di utilizzo.
Argomenti correlati
Ecco alcuni passaggi che potresti provare a eseguire:
Per caricare i dati del file quando crei o aggiorni un file, vedi Caricare i dati del file.
Per creare un file in una cartella specifica, consulta Creare un file in una cartella specifica.
Per lavorare con i metadati dei file, vedi Gestire i metadati dei file.
Per eliminare un file, vedi Cestino o eliminazioni di file e cartelle.