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:
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
Nome | Breve descrizione |
---|---|
Access | Un'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. |
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 l'iterazione degli script su una raccolta potenzialmente grande di file. |
Folder | Una cartella su Google Drive. |
FolderIterator | Un oggetto che consente l'iterazione degli script su una raccolta potenzialmente grande di cartelle. |
Permission | Un'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. |
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 | Può accedere chiunque abbia il link. |
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 a qualsiasi agli utenti a cui è stato concesso esplicitamente l'accesso. |
Permission | Permission | Un'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
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
continueFileIterator(continuationToken) | FileIterator | Riprende un'iterazione di 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 radice del Drive dell'utente con il nome e i contenuti specificati. |
createFile(name, content, mimeType) | File | Crea un file nella directory principale del Drive dell'utente con il nome, i contenuti e il tipo MIME specificati. |
createFolder(name) | Folder | Crea una cartella nella directory principale del 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 della risorsa forniti e la restituisce. |
enforceSingleParent(value) | void | Attiva o disattiva il comportamento forzato singolo per tutte le chiamate che interessano elementi padre. |
getFileById(id) | File | Recupera il file con l'ID specificato. |
getFileByIdAndResourceKey(id, resourceKey) | File | Recupera il file con l'ID e la chiave della 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 con lo stesso nome presenti nel Drive dell'utente. |
getFilesByType(mimeType) | FileIterator | Recupera una raccolta di tutti i file con il tipo MIME specificato nel Drive dell'utente. |
getFolderById(id) | Folder | Recupera la cartella con l'ID specificato. |
getFolderByIdAndResourceKey(id, resourceKey) | Folder | Recupera la cartella con l'ID e la chiave della risorsa specificati. |
getFolders() | FolderIterator | Ottiene una raccolta di tutte le cartelle nel Drive dell'utente. |
getFoldersByName(name) | FolderIterator | Recupera una raccolta di tutte le cartelle che hanno il nome specificato nel Drive dell'utente. |
getRootFolder() | Folder | Recupera la cartella nella directory principale del Drive dell'utente. |
getStorageLimit() | Integer | Recupera il numero di byte che l'utente può archiviare su Drive. |
getStorageUsed() | Integer | Restituisce il numero di byte attualmente archiviati dall'utente su Drive. |
getTrashedFiles() | FileIterator | Recupera una raccolta di tutti i file nel cestino del Drive dell'utente. |
getTrashedFolders() | FolderIterator | Recupera una raccolta di tutte le cartelle nel cestino del Drive dell'utente. |
searchFiles(params) | FileIterator | Recupera una raccolta di tutti i file nel Drive dell'utente che corrispondono alla ricerca specificata criteri. |
searchFolders(params) | FolderIterator | Restituisce una raccolta di tutte le cartelle nel Drive dell'utente che corrispondono alla ricerca specificata criteri. |
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 di utenti specificato all'elenco dei commentatori per File . |
addEditor(emailAddress) | File | Aggiunge l'utente specificato all'elenco di editor per File . |
addEditor(user) | File | Aggiunge l'utente specificato all'elenco di editor per File . |
addEditors(emailAddresses) | File | Aggiunge l'array di utenti specificato all'elenco di editor per File . |
addViewer(emailAddress) | File | Aggiunge l'utente specificato all'elenco di visualizzatori per File . |
addViewer(user) | File | Aggiunge l'utente specificato all'elenco di visualizzatori per File . |
addViewers(emailAddresses) | File | Aggiunge l'array specificato di utenti all'elenco di 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 come blob convertito nel tipo di contenuto specificato. |
getBlob() | Blob | Restituisce i dati all'interno dell'oggetto sotto forma di blob. |
getDateCreated() | Date | Recupera la data di creazione di File . |
getDescription() | String | Recupera la descrizione del File . |
getDownloadUrl() | String | Recupera l'URL che può essere utilizzato per scaricare il file. |
getEditors() | User[] | Ottiene l'elenco degli editor per questo File . |
getId() | String | Recupera l'ID di File . |
getLastUpdated() | Date | Ottiene la data dell'ultimo aggiornamento di File . |
getMimeType() | String | Recupera il tipo MIME del file. |
getName() | String | Ottiene il nome del File . |
getOwner() | User | Recupera il proprietario del file. |
getParents() | FolderIterator | Recupera una raccolta di cartelle padre immediate di File . |
getResourceKey() | String | Recupera la chiave risorsa di File necessaria per accedere agli elementi che
sono stati condivisi tramite link. |
getSecurityUpdateEligible() | Boolean | Riconosce 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() | Boolean | Riconosce se questo File richiede una chiave risorsa per l'accesso quando
condiviso tramite link. |
getSharingAccess() | Access | Trova la classe di utenti che può accedere all'File , oltre a qualsiasi individuo
agli utenti a cui è stato concesso esplicitamente l'accesso. |
getSharingPermission() | Permission | Consente di concedere l'autorizzazione agli utenti che possono accedere a File ,
accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso. |
getSize() | Integer | Recupera il numero di byte utilizzati per archiviare File su 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 | Recupera 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[] | Consente di acquisire l'elenco di visualizzatori e commentatori di File . |
isShareableByEditors() | Boolean | Consente di stabilire se gli utenti con autorizzazioni di modifica per File possono
condividere con altri utenti o modificare le autorizzazioni. |
isStarred() | Boolean | Determina se File è stato aggiunto a Speciali nel Drive dell'utente. |
isTrashed() | Boolean | Determina se l'elemento 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 gli assegna il nome fornito. |
makeCopy(name, destination) | File | Crea una copia del file nella directory di destinazione e le assegna il nome fornito. |
moveTo(destination) | File | Sposta questo elemento nella cartella di destinazione fornita. |
removeCommenter(emailAddress) | File | Rimuove l'utente specificato dall'elenco degli autori di commenti per File . |
removeCommenter(user) | File | Rimuove l'utente specificato dall'elenco degli autori di commenti 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 di visualizzatori e commentatori per File . |
removeViewer(user) | File | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per File . |
revokePermissions(emailAddress) | File | Revoca l'accesso al File concesso all'utente specificato. |
revokePermissions(user) | File | Revoca l'accesso al File concesso all'utente specificato. |
setContent(content) | File | Sovrascrive i contenuti del file con una determinata sostituzione. |
setDescription(description) | File | Consente di impostare la descrizione per File . |
setName(name) | File | Consente di impostare il nome dell'elemento File . |
setOwner(emailAddress) | File | Modifica il proprietario di File . |
setOwner(user) | File | Modifica il proprietario di File . |
setSecurityUpdateEnabled(enabled) | File | Consente di impostare se File richiede una chiave risorsa per l'accesso quando
condiviso tramite 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 all'File e le autorizzazioni
a questi utenti, oltre a quelli individuali a cui è stato esplicitamente concesso l'accesso. |
setStarred(starred) | File | Consente di impostare se File viene aggiunto a Speciali nel Drive dell'utente. |
setTrashed(trashed) | File | Consente di impostare se l'elemento File si trova nel cestino del Drive dell'utente. |
FileIterator
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getContinuationToken() | String | Ottiene un token che può essere utilizzato per riprendere questa iterazione in un secondo momento. |
hasNext() | Boolean | Determina se la chiamata a next() restituirà un elemento. |
next() | File | Recupera 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 di editor per Folder . |
addEditor(user) | Folder | Aggiunge l'utente specificato all'elenco di editor per Folder . |
addEditors(emailAddresses) | Folder | Aggiunge l'array di utenti specificato all'elenco di editor per Folder . |
addViewer(emailAddress) | Folder | Aggiunge l'utente specificato all'elenco di visualizzatori per Folder . |
addViewer(user) | Folder | Aggiunge l'utente specificato all'elenco di visualizzatori per Folder . |
addViewers(emailAddresses) | Folder | Aggiunge l'array specificato di utenti all'elenco di 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 della 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 del Folder . |
getEditors() | User[] | Ottiene l'elenco degli editor per questo Folder . |
getFiles() | FileIterator | Recupera una raccolta di tutti i file secondari della cartella corrente. |
getFilesByName(name) | FileIterator | Restituisce una raccolta di tutti i file secondari della cartella corrente e con il nome specificato. |
getFilesByType(mimeType) | FileIterator | Recupera una raccolta di tutti i file secondari della cartella corrente e con il tipo MIME specificato. |
getFolders() | FolderIterator | Recupera una raccolta di tutte le cartelle secondarie della cartella corrente. |
getFoldersByName(name) | FolderIterator | Restituisce una raccolta di tutte le cartelle secondarie della cartella corrente e con il nome specificato. |
getId() | String | Recupera l'ID di Folder . |
getLastUpdated() | Date | Ottiene la data dell'ultimo aggiornamento di Folder . |
getName() | String | Ottiene il nome del Folder . |
getOwner() | User | Recupera il proprietario di questo Folder . |
getParents() | FolderIterator | Recupera una raccolta di cartelle padre immediate di Folder . |
getResourceKey() | String | Recupera la chiave risorsa di Folder necessaria per accedere agli elementi che
sono stati condivisi tramite link. |
getSecurityUpdateEligible() | Boolean | Riconosce 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() | Boolean | Riconosce se questo Folder richiede una chiave risorsa per l'accesso quando
condiviso tramite link. |
getSharingAccess() | Access | Trova la classe di utenti che può accedere all'Folder , oltre a qualsiasi individuo
agli utenti a cui è stato concesso esplicitamente l'accesso. |
getSharingPermission() | Permission | Consente di concedere l'autorizzazione agli utenti che possono accedere a Folder ,
accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso. |
getSize() | Integer | Recupera il numero di byte utilizzati per archiviare Folder su Drive. |
getUrl() | String | Recupera 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() | Boolean | Consente di stabilire se gli utenti con autorizzazioni di modifica per Folder possono
condividere con altri utenti o modificare le autorizzazioni. |
isStarred() | Boolean | Determina se Folder è stato aggiunto a Speciali nel Drive dell'utente. |
isTrashed() | Boolean | Determina se l'elemento 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 di visualizzatori e commentatori per Folder . |
removeViewer(user) | Folder | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per Folder . |
revokePermissions(emailAddress) | Folder | Revoca l'accesso al Folder concesso all'utente specificato. |
revokePermissions(user) | Folder | Revoca l'accesso al Folder concesso all'utente specificato. |
searchFiles(params) | FileIterator | Restituisce una raccolta di tutti i file secondari della cartella corrente e corrispondenti alla ricerca specificata criteri. |
searchFolders(params) | FolderIterator | Restituisce una raccolta di tutte le cartelle secondarie della cartella corrente e corrispondenti alla ricerca specificata criteri. |
setDescription(description) | Folder | Consente di impostare la descrizione per Folder . |
setName(name) | Folder | Consente di impostare il nome dell'elemento Folder . |
setOwner(emailAddress) | Folder | Modifica il proprietario di Folder . |
setOwner(user) | Folder | Modifica il proprietario di Folder . |
setSecurityUpdateEnabled(enabled) | Folder | Consente di impostare se Folder richiede una chiave risorsa per l'accesso quando
condiviso tramite 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 all'Folder e le autorizzazioni
a questi utenti, oltre a quelli individuali a cui è stato esplicitamente concesso l'accesso. |
setStarred(starred) | Folder | Consente di impostare se Folder viene aggiunto a Speciali nel Drive dell'utente. |
setTrashed(trashed) | Folder | Consente di impostare se l'elemento Folder si trova nel cestino del Drive dell'utente. |
FolderIterator
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getContinuationToken() | String | Ottiene un token che può essere utilizzato per riprendere questa iterazione in un secondo momento. |
hasNext() | Boolean | Determina se la chiamata a next() restituirà un elemento. |
next() | Folder | Recupera 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 visualizzarli, copiarli o commentarli. |
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 i 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 | Ottiene il nome di dominio associato all'account dell'utente. |
getEmail() | String | Recupera l'indirizzo email dell'utente. |
getName() | String | Ottiene il nome dell'utente. |
getPhotoUrl() | String | Recupera l'URL della foto dell'utente. |