Questo servizio consente agli script di creare, trovare e modificare file e cartelle su Google Drive.
Se lo script utilizza un progetto Cloud standard anziché un progetto Cloud predefinito, devi attivare manualmente l'API Drive. Nel tuo progetto cloud standard, attiva l'API Drive:
Il seguente esempio di codice mostra come registrare i nomi di ciascun file nella cartella Il mio Drive dell'utente:// 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
Nome | Breve descrizione |
---|---|
Access | Un'enumerazione che rappresenta le classi di utenti che possono accedere a un file o a una cartella, oltre ai singoli utenti a cui è stato esplicitamente concesso l'accesso. |
DriveApp | Consente agli script di creare, trovare e modificare file e cartelle su Google Drive. |
File | Un file su Google Drive. |
FileIterator | Un iteratore che consente agli script di eseguire l'iterazione su una raccolta potenzialmente di grandi dimensioni di file. |
Folder | Una cartella su Google Drive. |
FolderIterator | Un oggetto che consente agli script di eseguire l'iterazione su una raccolta potenzialmente estesa di cartelle. |
Permission | Un'enumerazione che rappresenta le autorizzazioni concesse agli utenti che possono accedere a un file o a una cartella, oltre ai singoli utenti a cui è stato esplicitamente concesso l'accesso. |
User | Un utente associato a un file su Google Drive. |
Access
Proprietà
Proprietà | Tipo | Descrizione |
---|---|---|
ANYONE | Enum | Chiunque abbia accesso a internet può trovare e accedere. |
ANYONE_WITH_LINK | Enum | Chiunque abbia il link può accedere. |
DOMAIN | Enum | Le persone nel tuo dominio possono trovare questo elemento e accedervi. |
DOMAIN_WITH_LINK | Enum | Gli utenti del tuo dominio che hanno il link possono accedere. |
PRIVATE | Enum | L'accesso è riservato a utenti che hanno esplicitamente ricevuto un'autorizzazione. |
DriveApp
Proprietà
Proprietà | Tipo | Descrizione |
---|---|---|
Access | Access | Un'enumerazione che rappresenta le classi di utenti che possono accedere a un file o a una cartella, oltre ai singoli utenti a cui è stato esplicitamente concesso l'accesso. |
Permission | Permission | Un'enumerazione che rappresenta le autorizzazioni concesse agli utenti che possono accedere a un file o a una cartella, oltre ai singoli utenti a cui è stato esplicitamente concesso l'accesso. |
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
continueFileIterator(continuationToken) | FileIterator | Riprende un'iterazione del file utilizzando un token di continuazione di un iteratore precedente. |
continueFolderIterator(continuationToken) | FolderIterator | Riprende l'iterazione di una cartella utilizzando un token di continuazione di un iteratore precedente. |
createFile(blob) | File | Crea un file nella directory principale del Drive dell'utente a partire da un determinato Blob di dati arbitrari. |
createFile(name, content) | File | Crea un file di testo nella directory principale di Drive dell'utente con il nome e i contenuti specificati. |
createFile(name, content, mimeType) | File | Crea un file nella directory principale di Drive dell'utente con il nome, i contenuti e il tipo MIME specificati. |
createFolder(name) | Folder | Crea una cartella nella directory principale di Drive dell'utente con il nome specificato. |
createShortcut(targetId) | File | Crea una scorciatoia all'ID elemento di Drive fornito e la restituisce. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Crea una scorciatoia all'ID elemento di Drive e alla chiave risorsa forniti e la restituisce. |
enforceSingleParent(value) | void | Consente di attivare o disattivare il comportamento applySingleParent per tutte le chiamate che interessano i genitori degli elementi. |
getFileById(id) | File | Restituisce il file con l'ID specificato. |
getFileByIdAndResourceKey(id, resourceKey) | File | Restituisce il file con l'ID e la chiave risorsa specificati. |
getFiles() | FileIterator | Recupera una raccolta di tutti i file presenti nel Drive dell'utente. |
getFilesByName(name) | FileIterator | Recupera una raccolta di tutti i file del Drive dell'utente che hanno il nome specificato. |
getFilesByType(mimeType) | FileIterator | Recupera una raccolta di tutti i file del Drive dell'utente che hanno il tipo MIME specificato. |
getFolderById(id) | Folder | Restituisce la cartella con l'ID specificato. |
getFolderByIdAndResourceKey(id, resourceKey) | Folder | Restituisce la cartella con l'ID e la chiave della risorsa specificati. |
getFolders() | FolderIterator | Recupera una raccolta di tutte le cartelle nel Drive dell'utente. |
getFoldersByName(name) | FolderIterator | Recupera una raccolta di tutte le cartelle nel Drive dell'utente che hanno il nome specificato. |
getRootFolder() | Folder | Recupera la cartella nella directory principale di Drive dell'utente. |
getStorageLimit() | Integer | Restituisce il numero di byte che l'utente è autorizzato ad archiviare su Drive. |
getStorageUsed() | Integer | Restituisce il numero di byte che l'utente sta archiviando attualmente su Drive. |
getTrashedFiles() | FileIterator | Recupera una raccolta di tutti i file presenti nel cestino del Drive dell'utente. |
getTrashedFolders() | FolderIterator | Recupera una raccolta di tutte le cartelle presenti nel cestino di Drive dell'utente. |
searchFiles(params) | FileIterator | Restituisce una raccolta di tutti i file di Drive dell'utente che corrispondono ai criteri di ricerca specificati. |
searchFolders(params) | FolderIterator | Restituisce una raccolta di tutte le cartelle nel Drive dell'utente che corrispondono ai criteri di ricerca specificati. |
File
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
addCommenter(emailAddress) | File | Aggiungi l'utente specificato all'elenco di commentatori per File . |
addCommenter(user) | File | Aggiungi l'utente specificato all'elenco di commentatori per File . |
addCommenters(emailAddresses) | File | Aggiungi l'array specificato di utenti all'elenco di commentatori per File . |
addEditor(emailAddress) | File | Aggiunge l'utente specificato all'elenco degli editor per File . |
addEditor(user) | File | Aggiunge l'utente specificato all'elenco degli editor per File . |
addEditors(emailAddresses) | File | Aggiunge l'array specificato di utenti all'elenco degli editor per File . |
addViewer(emailAddress) | File | Aggiunge l'utente specificato all'elenco dei visualizzatori per File . |
addViewer(user) | File | Aggiunge l'utente specificato all'elenco dei visualizzatori per File . |
addViewers(emailAddresses) | File | Aggiunge l'array specificato di utenti all'elenco dei visualizzatori per File . |
getAccess(email) | Permission | Consente di ottenere l'autorizzazione concessa all'utente specificato. |
getAccess(user) | Permission | Consente di ottenere l'autorizzazione concessa all'utente specificato. |
getAs(contentType) | Blob | Restituisce i dati all'interno di questo oggetto sotto forma di blob convertito nel tipo di contenuto specificato. |
getBlob() | Blob | Restituisce i dati all'interno di questo oggetto sotto forma di blob. |
getDateCreated() | Date | Recupera la data di creazione di File . |
getDescription() | String | Recupera la descrizione di File . |
getDownloadUrl() | String | Consente di acquisire l'URL che può essere utilizzato per scaricare il file. |
getEditors() | User[] | Consente di acquisire l'elenco degli editor di File . |
getId() | String | Recupera l'ID di File . |
getLastUpdated() | Date | Visualizza la data dell'ultimo aggiornamento di File . |
getMimeType() | String | Restituisce il tipo MIME del file. |
getName() | String | Recupera il nome di File . |
getOwner() | User | Ottieni il proprietario del file. |
getParents() | FolderIterator | Recupera una raccolta di cartelle che sono elementi padre stretti di File . |
getResourceKey() | String | Recupera la chiave risorsa di File necessaria per accedere agli elementi
condivisi utilizzando un link. |
getSecurityUpdateEligible() | Boolean | Riconosce se questo File è idoneo ad applicare l'aggiornamento della sicurezza che richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link. |
getSecurityUpdateEnabled() | Boolean | Riconosce se questo File richiede una chiave della risorsa per l'accesso quando viene
condiviso tramite un link. |
getSharingAccess() | Access | Restituisce la classe di utenti che può accedere a File , oltre a ogni singolo utente a cui è stato esplicitamente concesso l'accesso. |
getSharingPermission() | Permission | Ottieni l'autorizzazione concessa agli utenti che possono accedere a File ,
oltre ai singoli utenti a cui è stato concesso esplicitamente l'accesso. |
getSize() | Integer | Restituisce il numero di byte utilizzati per archiviare File in Drive. |
getTargetId() | String | Se si tratta di una scorciatoia, restituisce l'ID dell'elemento a cui rimanda. |
getTargetMimeType() | String | Se si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui rimanda. |
getTargetResourceKey() | String | Se il file è una scorciatoia, restituisce la chiave risorsa dell'elemento a cui rimanda. |
getThumbnail() | Blob | Restituisce un'immagine in miniatura per il file o null se non esiste una miniatura. |
getUrl() | String | Recupera l'URL che può essere utilizzato per aprire File in un'app Google come Drive o Documenti. |
getViewers() | User[] | Visualizza l'elenco di spettatori e commentatori per File . |
isShareableByEditors() | Boolean | Determina se gli utenti con autorizzazioni di modifica per File sono autorizzati a condividere contenuti con altri utenti o a modificare le autorizzazioni. |
isStarred() | Boolean | Determina se File è stato aggiunto a Speciali nel Drive dell'utente. |
isTrashed() | Boolean | Determina se File si trova nel cestino del Drive dell'utente. |
makeCopy() | File | Crea una copia del file. |
makeCopy(destination) | File | Crea una copia del file nella directory di destinazione. |
makeCopy(name) | File | Crea una copia del file e lo assegna al nome fornito. |
makeCopy(name, destination) | File | Crea una copia del file nella directory di destinazione e la denomina con il nome fornito. |
moveTo(destination) | File | Sposta questo elemento nella cartella di destinazione fornita. |
removeCommenter(emailAddress) | File | Rimuove l'utente specificato dall'elenco dei commentatori per File . |
removeCommenter(user) | File | Rimuove l'utente specificato dall'elenco dei commentatori per File . |
removeEditor(emailAddress) | File | Rimuove l'utente specificato dall'elenco degli editor per File . |
removeEditor(user) | File | Rimuove l'utente specificato dall'elenco degli editor per File . |
removeViewer(emailAddress) | File | Rimuove l'utente specificato dall'elenco dei visualizzatori e commentatori per File . |
removeViewer(user) | File | Rimuove l'utente specificato dall'elenco dei visualizzatori e commentatori per File . |
revokePermissions(emailAddress) | File | Revoca l'accesso a File concesso all'utente specificato. |
revokePermissions(user) | File | Revoca l'accesso a File concesso all'utente specificato. |
setContent(content) | File | Sovrascrive il contenuto del file con una determinata sostituzione. |
setDescription(description) | File | Consente di impostare la descrizione dell'elemento File . |
setName(name) | File | Imposta il nome dell'oggetto File . |
setOwner(emailAddress) | File | Cambia il proprietario di File . |
setOwner(user) | File | Cambia il proprietario di File . |
setSecurityUpdateEnabled(enabled) | File | Consente di impostare se File richiede una chiave della risorsa per l'accesso quando viene
condivisa tramite un link. |
setShareableByEditors(shareable) | File | Consente di stabilire se gli utenti con autorizzazioni di modifica per File possono condividere
con altri utenti o modificare le autorizzazioni. |
setSharing(accessType, permissionType) | File | Imposta la classe di utenti che può accedere a File e le autorizzazioni concesse a tali utenti, oltre ai singoli utenti a cui è stato concesso esplicitamente l'accesso. |
setStarred(starred) | File | Consente di impostare se l'elemento File viene aggiunto a Speciali nel Drive dell'utente. |
setTrashed(trashed) | File | Consente di impostare se File si trova nel cestino del Drive dell'utente. |
FileIterator
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getContinuationToken() | String | Recupera un token che può essere utilizzato per riprendere questa iterazione in un secondo momento. |
hasNext() | Boolean | Determina se la chiamata a next() restituisce un elemento. |
next() | File | Consente di acquisire l'elemento successivo nella raccolta di file o cartelle. |
Folder
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
addEditor(emailAddress) | Folder | Aggiunge l'utente specificato all'elenco degli editor per Folder . |
addEditor(user) | Folder | Aggiunge l'utente specificato all'elenco degli editor per Folder . |
addEditors(emailAddresses) | Folder | Aggiunge l'array specificato di utenti all'elenco degli editor per Folder . |
addViewer(emailAddress) | Folder | Aggiunge l'utente specificato all'elenco dei visualizzatori per Folder . |
addViewer(user) | Folder | Aggiunge l'utente specificato all'elenco dei visualizzatori per Folder . |
addViewers(emailAddresses) | Folder | Aggiunge l'array specificato di utenti all'elenco dei visualizzatori per Folder . |
createFile(blob) | File | Crea un file nella cartella corrente a partire da un determinato Blob di dati arbitrari. |
createFile(name, content) | File | Crea un file di testo nella cartella corrente con il nome e i contenuti specificati. |
createFile(name, content, mimeType) | File | Crea un file nella cartella corrente con il nome, i contenuti e il tipo MIME specificati. |
createFolder(name) | Folder | Crea una cartella nella cartella corrente con il nome specificato. |
createShortcut(targetId) | File | Crea una scorciatoia all'ID elemento di Drive fornito e la restituisce. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Crea una scorciatoia all'ID elemento di Drive e alla chiave risorsa forniti e la restituisce. |
getAccess(email) | Permission | Consente di ottenere l'autorizzazione concessa all'utente specificato. |
getAccess(user) | Permission | Consente di ottenere l'autorizzazione concessa all'utente specificato. |
getDateCreated() | Date | Recupera la data di creazione di Folder . |
getDescription() | String | Recupera la descrizione di Folder . |
getEditors() | User[] | Consente di acquisire l'elenco degli editor di Folder . |
getFiles() | FileIterator | Restituisce una raccolta di tutti i file che sono secondari della cartella corrente. |
getFilesByName(name) | FileIterator | Restituisce una raccolta di tutti i file che sono secondari della cartella corrente e hanno il nome specificato. |
getFilesByType(mimeType) | FileIterator | Restituisce una raccolta di tutti i file secondari della cartella corrente con il tipo MIME specificato. |
getFolders() | FolderIterator | Restituisce una raccolta di tutte le cartelle secondarie della cartella corrente. |
getFoldersByName(name) | FolderIterator | Restituisce una raccolta di tutte le cartelle che sono secondarie della cartella corrente e hanno il nome specificato. |
getId() | String | Recupera l'ID di Folder . |
getLastUpdated() | Date | Visualizza la data dell'ultimo aggiornamento di Folder . |
getName() | String | Recupera il nome di Folder . |
getOwner() | User | Ottieni il proprietario di questo Folder . |
getParents() | FolderIterator | Recupera una raccolta di cartelle che sono elementi padre stretti di Folder . |
getResourceKey() | String | Recupera la chiave risorsa di Folder necessaria per accedere agli elementi
condivisi utilizzando un link. |
getSecurityUpdateEligible() | Boolean | Riconosce se questo Folder è idoneo ad applicare l'aggiornamento della sicurezza che richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link. |
getSecurityUpdateEnabled() | Boolean | Riconosce se questo Folder richiede una chiave della risorsa per l'accesso quando viene
condiviso tramite un link. |
getSharingAccess() | Access | Restituisce la classe di utenti che può accedere a Folder , oltre a ogni singolo utente a cui è stato esplicitamente concesso l'accesso. |
getSharingPermission() | Permission | Ottieni l'autorizzazione concessa agli utenti che possono accedere a Folder ,
oltre ai singoli utenti a cui è stato concesso esplicitamente l'accesso. |
getSize() | Integer | Restituisce il numero di byte utilizzati per archiviare Folder in Drive. |
getUrl() | String | Recupera l'URL che può essere utilizzato per aprire Folder in un'app Google come Drive o Documenti. |
getViewers() | User[] | Visualizza l'elenco di spettatori e commentatori per Folder . |
isShareableByEditors() | Boolean | Determina se gli utenti con autorizzazioni di modifica per Folder sono autorizzati a condividere contenuti con altri utenti o a modificare le autorizzazioni. |
isStarred() | Boolean | Determina se Folder è stato aggiunto a Speciali nel Drive dell'utente. |
isTrashed() | Boolean | Determina se Folder si trova nel cestino del Drive dell'utente. |
moveTo(destination) | Folder | Sposta questo elemento nella cartella di destinazione fornita. |
removeEditor(emailAddress) | Folder | Rimuove l'utente specificato dall'elenco degli editor per Folder . |
removeEditor(user) | Folder | Rimuove l'utente specificato dall'elenco degli editor per Folder . |
removeViewer(emailAddress) | Folder | Rimuove l'utente specificato dall'elenco dei visualizzatori e commentatori per Folder . |
removeViewer(user) | Folder | Rimuove l'utente specificato dall'elenco dei visualizzatori e commentatori per Folder . |
revokePermissions(emailAddress) | Folder | Revoca l'accesso a Folder concesso all'utente specificato. |
revokePermissions(user) | Folder | Revoca l'accesso a Folder concesso all'utente specificato. |
searchFiles(params) | FileIterator | Restituisce una raccolta di tutti i file che sono secondari della cartella corrente e che corrispondono ai criteri di ricerca specificati. |
searchFolders(params) | FolderIterator | Restituisce una raccolta di tutte le cartelle che sono secondarie della cartella corrente e che corrispondono ai criteri di ricerca specificati. |
setDescription(description) | Folder | Consente di impostare la descrizione dell'elemento Folder . |
setName(name) | Folder | Imposta il nome dell'oggetto Folder . |
setOwner(emailAddress) | Folder | Cambia il proprietario di Folder . |
setOwner(user) | Folder | Cambia il proprietario di Folder . |
setSecurityUpdateEnabled(enabled) | Folder | Consente di impostare se Folder richiede una chiave della risorsa per l'accesso quando viene
condivisa tramite un link. |
setShareableByEditors(shareable) | Folder | Consente di stabilire se gli utenti con autorizzazioni di modifica per Folder possono condividere
con altri utenti o modificare le autorizzazioni. |
setSharing(accessType, permissionType) | Folder | Imposta la classe di utenti che può accedere a Folder e le autorizzazioni concesse a tali utenti, oltre ai singoli utenti a cui è stato concesso esplicitamente l'accesso. |
setStarred(starred) | Folder | Consente di impostare se l'elemento Folder viene aggiunto a Speciali nel Drive dell'utente. |
setTrashed(trashed) | Folder | Consente di impostare se Folder si trova nel cestino del Drive dell'utente. |
FolderIterator
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getContinuationToken() | String | Recupera un token che può essere utilizzato per riprendere questa iterazione in un secondo momento. |
hasNext() | Boolean | Determina se la chiamata a next() restituisce un elemento. |
next() | Folder | Consente di acquisire l'elemento successivo nella raccolta di file o cartelle. |
Permission
Proprietà
Proprietà | Tipo | Descrizione |
---|---|---|
VIEW | Enum | Gli utenti che possono accedere al file o alla cartella possono solo visualizzarlo o copiarlo. |
EDIT | Enum | Gli utenti che possono accedere al file o alla cartella possono modificarlo. |
COMMENT | Enum | Gli utenti che possono accedere al file o alla cartella possono solo visualizzarlo, copiarlo o commentarlo. |
OWNER | Enum | Il file o la cartella sono di proprietà dell'utente. |
ORGANIZER | Enum | Utenti che possono organizzare file e cartelle all'interno di un Drive condiviso. |
FILE_ORGANIZER | Enum | Utenti che possono modificare, spostare nel cestino e spostare contenuti all'interno di un Drive condiviso. |
NONE | Enum | L'utente non dispone di alcuna autorizzazione per il file o la cartella. |
User
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getDomain() | String | Restituisce il nome di dominio associato all'account dell'utente. |
getEmail() | String | Consente di acquisire l'indirizzo email dell'utente. |
getName() | String | Restituisce il nome dell'utente. |
getPhotoUrl() | String | Consente di acquisire l'URL della foto dell'utente. |