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 create sulla risorsa files senza parametri.

Quando crei il file, il metodo restituisce una risorsa files. Al file viene assegnato un kind di drive.file, un id, un name "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.

Utilizzare il parametro fields

Se vuoi specificare i campi da restituire nella risposta, puoi impostare il fields parametro di sistema con qualsiasi metodo della risorsa files. Se ometti il parametro fields, il server restituisce un insieme predefinito di campi specifici per il metodo. Ad esempio, il metodo list restituisce solo i campi kind, id, name, mimeType e resourceKey per ogni file. Per restituire campi diversi, vedi Restituire campi specifici.

Generare ID da utilizzare con i file

Il metodo generateIds nella risorsa files consente di pregenerare ID file unici che possono essere utilizzati durante la creazione o la copia di file e cartelle in Drive. Ciò può essere utile quando devi controllare gli ID file dalla tua app, anziché lasciare che Drive li assegni automaticamente.

Puoi impostare il numero di ID generati utilizzando il parametro di query count. Se count non è impostato, per impostazione predefinita vengono restituiti 10 risultati. Il numero massimo di ID che puoi richiedere è limitato a 1000.

Puoi anche specificare il space in cui possono essere utilizzati gli ID e il type degli articoli per cui possono essere utilizzati gli ID.

Una volta generato, l'ID può essere passato al metodo create o copy tramite il campo id. In questo modo, il file creato o copiato utilizza l'ID predeterminato.

Se il file viene creato o copiato correttamente, i tentativi successivi restituiscono un codice di stato HTTP 409 Conflict e non vengono creati file duplicati.

Tieni presente che gli ID pregenerati non sono supportati per la creazione di file Google Workspace, ad eccezione dei application/vnd.google-apps.drive-sdk e application/vnd.google-apps.folder tipi MIME. Analogamente, i caricamenti che fanno riferimento a una conversione in un formato di file Google Workspace non sono supportati.

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. I campi come name sono indipendenti dall'utente e vengono visualizzati allo stesso modo per ogni utente, mentre i campi come viewedByMeTime contengono valori specifici per l'utente.

Un esempio di file solo 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 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 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 copy sulla risorsa files. Per trovare l'fileId da copiare, utilizza il metodo list.

Puoi applicare gli aggiornamenti tramite la semantica delle patch, il che significa che puoi apportare modifiche parziali a una risorsa. Nella richiesta devi impostare in modo esplicito i campi che intendi modificare. I campi non inclusi nella richiesta mantengono i valori esistenti. Per ulteriori informazioni, vedi Utilizzo di risorse parziali.

Puoi preimpostare l'ID file del file copiato utilizzando il metodo generateIds. Per ulteriori informazioni, vedi Generare ID da utilizzare con i file.

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 campo capabilities.canCopy determina se l'utente può copiare un file. Per saperne di più, consulta la sezione 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 ripristinare 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 copy produce un file con lo stesso nome dell'originale.
    • Un utilizzo eccessivo di 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: