Drive Service

Drive

Questo servizio consente agli script di creare, trovare e modificare file e cartelle in Google Drive.

Se lo script utilizza un parametro progetto Cloud standard anziché un progetto Cloud predefinito, devi attivare manualmente l'API Drive. Nel tuo progetto Cloud standard, attiva l'API Drive:

Attivare l'API Drive

Il seguente esempio di codice mostra come registrare i nomi di ogni file nel file Cartella Il mio Drive:
// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Corsi

NomeBreve descrizione
AccessUn'enumerazione che rappresenta le classi di utenti che possono accedere a un file o a una cartella, oltre a qualsiasi agli utenti a cui è stato concesso esplicitamente l'accesso.
DriveAppConsente agli script di creare, trovare e modificare file e cartelle su Google Drive.
FileUn file su Google Drive.
FileIteratorUn iteratore che consente l'iterazione degli script su una raccolta potenzialmente grande di file.
FolderUna cartella su Google Drive.
FolderIteratorUn oggetto che consente l'iterazione degli script su una raccolta potenzialmente grande di cartelle.
PermissionUn'enumerazione che rappresenta le autorizzazioni concesse agli utenti che possono accedere a un file o a una cartella, oltre a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
UserUn utente associato a un file su Google Drive.

Access

Proprietà

ProprietàTipoDescrizione
ANYONEEnumChiunque abbia accesso a internet può trovare e accedere.
ANYONE_WITH_LINKEnumPuò accedere chiunque abbia il link.
DOMAINEnumLe persone nel tuo dominio possono trovare questo elemento e accedervi.
DOMAIN_WITH_LINKEnumGli utenti del tuo dominio che hanno il link possono accedere.
PRIVATEEnumL'accesso è riservato a utenti che hanno esplicitamente ricevuto un'autorizzazione.

DriveApp

Proprietà

ProprietàTipoDescrizione
AccessAccessUn'enumerazione che rappresenta le classi di utenti che possono accedere a un file o a una cartella, oltre a qualsiasi agli utenti a cui è stato concesso esplicitamente l'accesso.
PermissionPermissionUn'enumerazione che rappresenta le autorizzazioni concesse agli utenti che possono accedere a un file o a una cartella, oltre a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.

Metodi

MetodoTipo restituitoBreve descrizione
continueFileIterator(continuationToken)FileIteratorRiprende un'iterazione di file utilizzando un token di continuazione di un iteratore precedente.
continueFolderIterator(continuationToken)FolderIteratorRiprende l'iterazione di una cartella utilizzando un token di continuazione di un iteratore precedente.
createFile(blob)FileCrea un file nella directory principale del Drive dell'utente a partire da un determinato Blob di dati arbitrari.
createFile(name, content)FileCrea un file di testo nella directory radice del Drive dell'utente con il nome e i contenuti specificati.
createFile(name, content, mimeType)FileCrea un file nella directory principale del Drive dell'utente con il nome, i contenuti e il tipo MIME specificati.
createFolder(name)FolderCrea una cartella nella directory principale del Drive dell'utente con il nome specificato.
createShortcut(targetId)FileCrea una scorciatoia all'ID elemento di Drive fornito e la restituisce.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileCrea una scorciatoia all'ID elemento di Drive e alla chiave della risorsa forniti e la restituisce.
enforceSingleParent(value)voidAttiva o disattiva il comportamento forzato singolo per tutte le chiamate che interessano elementi padre.
getFileById(id)FileRecupera il file con l'ID specificato.
getFileByIdAndResourceKey(id, resourceKey)FileRecupera il file con l'ID e la chiave della risorsa specificati.
getFiles()FileIteratorRecupera una raccolta di tutti i file presenti nel Drive dell'utente.
getFilesByName(name)FileIteratorRecupera una raccolta di tutti i file con lo stesso nome presenti nel Drive dell'utente.
getFilesByType(mimeType)FileIteratorRecupera una raccolta di tutti i file con il tipo MIME specificato nel Drive dell'utente.
getFolderById(id)FolderRecupera la cartella con l'ID specificato.
getFolderByIdAndResourceKey(id, resourceKey)FolderRecupera la cartella con l'ID e la chiave della risorsa specificati.
getFolders()FolderIteratorOttiene una raccolta di tutte le cartelle nel Drive dell'utente.
getFoldersByName(name)FolderIteratorRecupera una raccolta di tutte le cartelle che hanno il nome specificato nel Drive dell'utente.
getRootFolder()FolderRecupera la cartella nella directory principale del Drive dell'utente.
getStorageLimit()IntegerRecupera il numero di byte che l'utente può archiviare su Drive.
getStorageUsed()IntegerRestituisce il numero di byte attualmente archiviati dall'utente su Drive.
getTrashedFiles()FileIteratorRecupera una raccolta di tutti i file nel cestino del Drive dell'utente.
getTrashedFolders()FolderIteratorRecupera una raccolta di tutte le cartelle nel cestino del Drive dell'utente.
searchFiles(params)FileIteratorRecupera una raccolta di tutti i file nel Drive dell'utente che corrispondono alla ricerca specificata criteri.
searchFolders(params)FolderIteratorRestituisce una raccolta di tutte le cartelle nel Drive dell'utente che corrispondono alla ricerca specificata criteri.

File

Metodi

MetodoTipo restituitoBreve descrizione
addCommenter(emailAddress)FileAggiungi l'utente specificato all'elenco di commentatori per File.
addCommenter(user)FileAggiungi l'utente specificato all'elenco di commentatori per File.
addCommenters(emailAddresses)FileAggiungi l'array di utenti specificato all'elenco dei commentatori per File.
addEditor(emailAddress)FileAggiunge l'utente specificato all'elenco di editor per File.
addEditor(user)FileAggiunge l'utente specificato all'elenco di editor per File.
addEditors(emailAddresses)FileAggiunge l'array di utenti specificato all'elenco di editor per File.
addViewer(emailAddress)FileAggiunge l'utente specificato all'elenco di visualizzatori per File.
addViewer(user)FileAggiunge l'utente specificato all'elenco di visualizzatori per File.
addViewers(emailAddresses)FileAggiunge l'array specificato di utenti all'elenco di visualizzatori per File.
getAccess(email)PermissionConsente di ottenere l'autorizzazione concessa all'utente specificato.
getAccess(user)PermissionConsente di ottenere l'autorizzazione concessa all'utente specificato.
getAs(contentType)BlobRestituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato.
getBlob()BlobRestituisce i dati all'interno dell'oggetto sotto forma di blob.
getDateCreated()DateRecupera la data di creazione di File.
getDescription()StringRecupera la descrizione del File.
getDownloadUrl()StringRecupera l'URL che può essere utilizzato per scaricare il file.
getEditors()User[]Ottiene l'elenco degli editor per questo File.
getId()StringRecupera l'ID di File.
getLastUpdated()DateOttiene la data dell'ultimo aggiornamento di File.
getMimeType()StringRecupera il tipo MIME del file.
getName()StringOttiene il nome del File.
getOwner()UserRecupera il proprietario del file.
getParents()FolderIteratorRecupera una raccolta di cartelle padre immediate di File.
getResourceKey()StringRecupera la chiave risorsa di File necessaria per accedere agli elementi che sono stati condivisi tramite link.
getSecurityUpdateEligible()BooleanRiconosce se il File è idoneo per applicare l'aggiornamento della sicurezza che richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link.
getSecurityUpdateEnabled()BooleanRiconosce se questo File richiede una chiave risorsa per l'accesso quando condiviso tramite link.
getSharingAccess()AccessTrova la classe di utenti che può accedere all'File, oltre a qualsiasi individuo agli utenti a cui è stato concesso esplicitamente l'accesso.
getSharingPermission()PermissionConsente di concedere l'autorizzazione agli utenti che possono accedere a File, accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
getSize()IntegerRecupera il numero di byte utilizzati per archiviare File su Drive.
getTargetId()StringSe si tratta di una scorciatoia, restituisce l'ID dell'elemento a cui rimanda.
getTargetMimeType()StringSe si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui rimanda.
getTargetResourceKey()StringSe il file è una scorciatoia, restituisce la chiave risorsa dell'elemento a cui rimanda.
getThumbnail()BlobRecupera un'immagine in miniatura per il file o null se non esiste una miniatura.
getUrl()StringRecupera l'URL che può essere utilizzato per aprire File in un'app Google come Drive o Documenti.
getViewers()User[]Consente di acquisire l'elenco di visualizzatori e commentatori di File.
isShareableByEditors()BooleanConsente di stabilire se gli utenti con autorizzazioni di modifica per File possono condividere con altri utenti o modificare le autorizzazioni.
isStarred()BooleanDetermina se File è stato aggiunto a Speciali nel Drive dell'utente.
isTrashed()BooleanDetermina se l'elemento File si trova nel cestino del Drive dell'utente.
makeCopy()FileCrea una copia del file.
makeCopy(destination)FileCrea una copia del file nella directory di destinazione.
makeCopy(name)FileCrea una copia del file e gli assegna il nome fornito.
makeCopy(name, destination)FileCrea una copia del file nella directory di destinazione e le assegna il nome fornito.
moveTo(destination)FileSposta questo elemento nella cartella di destinazione fornita.
removeCommenter(emailAddress)FileRimuove l'utente specificato dall'elenco degli autori di commenti per File.
removeCommenter(user)FileRimuove l'utente specificato dall'elenco degli autori di commenti per File.
removeEditor(emailAddress)FileRimuove l'utente specificato dall'elenco degli editor per File.
removeEditor(user)FileRimuove l'utente specificato dall'elenco degli editor per File.
removeViewer(emailAddress)FileRimuove l'utente specificato dall'elenco di visualizzatori e commentatori per File.
removeViewer(user)FileRimuove l'utente specificato dall'elenco di visualizzatori e commentatori per File.
revokePermissions(emailAddress)FileRevoca l'accesso al File concesso all'utente specificato.
revokePermissions(user)FileRevoca l'accesso al File concesso all'utente specificato.
setContent(content)FileSovrascrive i contenuti del file con una determinata sostituzione.
setDescription(description)FileConsente di impostare la descrizione per File.
setName(name)FileConsente di impostare il nome dell'elemento File.
setOwner(emailAddress)FileModifica il proprietario di File.
setOwner(user)FileModifica il proprietario di File.
setSecurityUpdateEnabled(enabled)FileConsente di impostare se File richiede una chiave risorsa per l'accesso quando condiviso tramite link.
setShareableByEditors(shareable)FileConsente di stabilire se gli utenti con autorizzazioni di modifica per File possono condividere con altri utenti o modificare le autorizzazioni.
setSharing(accessType, permissionType)FileImposta la classe di utenti che può accedere all'File e le autorizzazioni a questi utenti, oltre a quelli individuali a cui è stato esplicitamente concesso l'accesso.
setStarred(starred)FileConsente di impostare se File viene aggiunto a Speciali nel Drive dell'utente.
setTrashed(trashed)FileConsente di impostare se l'elemento File si trova nel cestino del Drive dell'utente.

FileIterator

Metodi

MetodoTipo restituitoBreve descrizione
getContinuationToken()StringOttiene un token che può essere utilizzato per riprendere questa iterazione in un secondo momento.
hasNext()BooleanDetermina se la chiamata a next() restituirà un elemento.
next()FileRecupera l'elemento successivo nella raccolta di file o cartelle.

Folder

Metodi

MetodoTipo restituitoBreve descrizione
addEditor(emailAddress)FolderAggiunge l'utente specificato all'elenco di editor per Folder.
addEditor(user)FolderAggiunge l'utente specificato all'elenco di editor per Folder.
addEditors(emailAddresses)FolderAggiunge l'array di utenti specificato all'elenco di editor per Folder.
addViewer(emailAddress)FolderAggiunge l'utente specificato all'elenco di visualizzatori per Folder.
addViewer(user)FolderAggiunge l'utente specificato all'elenco di visualizzatori per Folder.
addViewers(emailAddresses)FolderAggiunge l'array specificato di utenti all'elenco di visualizzatori per Folder.
createFile(blob)FileCrea un file nella cartella corrente a partire da un determinato Blob di dati arbitrari.
createFile(name, content)FileCrea un file di testo nella cartella corrente con il nome e i contenuti specificati.
createFile(name, content, mimeType)FileCrea un file nella cartella corrente con il nome, i contenuti e il tipo MIME specificati.
createFolder(name)FolderCrea una cartella nella cartella corrente con il nome specificato.
createShortcut(targetId)FileCrea una scorciatoia all'ID elemento di Drive fornito e la restituisce.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileCrea una scorciatoia all'ID elemento di Drive e alla chiave della risorsa forniti e la restituisce.
getAccess(email)PermissionConsente di ottenere l'autorizzazione concessa all'utente specificato.
getAccess(user)PermissionConsente di ottenere l'autorizzazione concessa all'utente specificato.
getDateCreated()DateRecupera la data di creazione di Folder.
getDescription()StringRecupera la descrizione del Folder.
getEditors()User[]Ottiene l'elenco degli editor per questo Folder.
getFiles()FileIteratorRecupera una raccolta di tutti i file secondari della cartella corrente.
getFilesByName(name)FileIteratorRestituisce una raccolta di tutti i file secondari della cartella corrente e con il nome specificato.
getFilesByType(mimeType)FileIteratorRecupera una raccolta di tutti i file secondari della cartella corrente e con il tipo MIME specificato.
getFolders()FolderIteratorRecupera una raccolta di tutte le cartelle secondarie della cartella corrente.
getFoldersByName(name)FolderIteratorRestituisce una raccolta di tutte le cartelle secondarie della cartella corrente e con il nome specificato.
getId()StringRecupera l'ID di Folder.
getLastUpdated()DateOttiene la data dell'ultimo aggiornamento di Folder.
getName()StringOttiene il nome del Folder.
getOwner()UserRecupera il proprietario di questo Folder.
getParents()FolderIteratorRecupera una raccolta di cartelle padre immediate di Folder.
getResourceKey()StringRecupera la chiave risorsa di Folder necessaria per accedere agli elementi che sono stati condivisi tramite link.
getSecurityUpdateEligible()BooleanRiconosce se il Folder è idoneo per applicare l'aggiornamento della sicurezza che richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link.
getSecurityUpdateEnabled()BooleanRiconosce se questo Folder richiede una chiave risorsa per l'accesso quando condiviso tramite link.
getSharingAccess()AccessTrova la classe di utenti che può accedere all'Folder, oltre a qualsiasi individuo agli utenti a cui è stato concesso esplicitamente l'accesso.
getSharingPermission()PermissionConsente di concedere l'autorizzazione agli utenti che possono accedere a Folder, accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
getSize()IntegerRecupera il numero di byte utilizzati per archiviare Folder su Drive.
getUrl()StringRecupera l'URL che può essere utilizzato per aprire Folder in un'app Google come Drive o Documenti.
getViewers()User[]Consente di acquisire l'elenco di visualizzatori e commentatori di Folder.
isShareableByEditors()BooleanConsente di stabilire se gli utenti con autorizzazioni di modifica per Folder possono condividere con altri utenti o modificare le autorizzazioni.
isStarred()BooleanDetermina se Folder è stato aggiunto a Speciali nel Drive dell'utente.
isTrashed()BooleanDetermina se l'elemento Folder si trova nel cestino del Drive dell'utente.
moveTo(destination)FolderSposta questo elemento nella cartella di destinazione fornita.
removeEditor(emailAddress)FolderRimuove l'utente specificato dall'elenco degli editor per Folder.
removeEditor(user)FolderRimuove l'utente specificato dall'elenco degli editor per Folder.
removeViewer(emailAddress)FolderRimuove l'utente specificato dall'elenco di visualizzatori e commentatori per Folder.
removeViewer(user)FolderRimuove l'utente specificato dall'elenco di visualizzatori e commentatori per Folder.
revokePermissions(emailAddress)FolderRevoca l'accesso al Folder concesso all'utente specificato.
revokePermissions(user)FolderRevoca l'accesso al Folder concesso all'utente specificato.
searchFiles(params)FileIteratorRestituisce una raccolta di tutti i file secondari della cartella corrente e corrispondenti alla ricerca specificata criteri.
searchFolders(params)FolderIteratorRestituisce una raccolta di tutte le cartelle secondarie della cartella corrente e corrispondenti alla ricerca specificata criteri.
setDescription(description)FolderConsente di impostare la descrizione per Folder.
setName(name)FolderConsente di impostare il nome dell'elemento Folder.
setOwner(emailAddress)FolderModifica il proprietario di Folder.
setOwner(user)FolderModifica il proprietario di Folder.
setSecurityUpdateEnabled(enabled)FolderConsente di impostare se Folder richiede una chiave risorsa per l'accesso quando condiviso tramite link.
setShareableByEditors(shareable)FolderConsente di stabilire se gli utenti con autorizzazioni di modifica per Folder possono condividere con altri utenti o modificare le autorizzazioni.
setSharing(accessType, permissionType)FolderImposta la classe di utenti che può accedere all'Folder e le autorizzazioni a questi utenti, oltre a quelli individuali a cui è stato esplicitamente concesso l'accesso.
setStarred(starred)FolderConsente di impostare se Folder viene aggiunto a Speciali nel Drive dell'utente.
setTrashed(trashed)FolderConsente di impostare se l'elemento Folder si trova nel cestino del Drive dell'utente.

FolderIterator

Metodi

MetodoTipo restituitoBreve descrizione
getContinuationToken()StringOttiene un token che può essere utilizzato per riprendere questa iterazione in un secondo momento.
hasNext()BooleanDetermina se la chiamata a next() restituirà un elemento.
next()FolderRecupera l'elemento successivo nella raccolta di file o cartelle.

Permission

Proprietà

ProprietàTipoDescrizione
VIEWEnumGli utenti che possono accedere al file o alla cartella possono solo visualizzarlo o copiarlo.
EDITEnumGli utenti che possono accedere al file o alla cartella possono modificarlo.
COMMENTEnumGli utenti che possono accedere al file o alla cartella possono solo visualizzarli, copiarli o commentarli.
OWNEREnumIl file o la cartella sono di proprietà dell'utente.
ORGANIZEREnumUtenti che possono organizzare file e cartelle all'interno di un Drive condiviso.
FILE_ORGANIZEREnumUtenti che possono modificare, spostare nel cestino e spostare i contenuti all'interno di un Drive condiviso.
NONEEnumL'utente non dispone di alcuna autorizzazione per il file o la cartella.

User

Metodi

MetodoTipo restituitoBreve descrizione
getDomain()StringOttiene il nome di dominio associato all'account dell'utente.
getEmail()StringRecupera l'indirizzo email dell'utente.
getName()StringOttiene il nome dell'utente.
getPhotoUrl()StringRecupera l'URL della foto dell'utente.