Una cartella su Google Drive. È possibile accedere alle cartelle o crearle da DriveApp
.
// Log the name of every folder in the user's Drive. var folders = DriveApp.getFolders(); while (folders.hasNext()) { var folder = folders.next(); Logger.log(folder.getName()); }
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. |
Documentazione dettagliata
addEditor(emailAddress)
Aggiunge l'utente specificato all'elenco degli editor per Folder
. Se l'utente era già
nell'elenco degli spettatori, scegli questo metodo per escluderlo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da aggiungere. |
Ritorni
Folder
- Questo Folder
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addEditor(user)
Aggiunge l'utente specificato all'elenco degli editor per Folder
. Se l'utente era già
nell'elenco degli spettatori, scegli questo metodo per escluderlo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da aggiungere. |
Ritorni
Folder
- Questo Folder
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addEditors(emailAddresses)
Aggiunge l'array specificato di utenti all'elenco degli editor per Folder
. Se uno degli utenti era già presente nell'elenco degli spettatori, questo metodo lo promuove fuori dall'elenco degli spettatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddresses | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Ritorni
Folder
- Questo Folder
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addViewer(emailAddress)
Aggiunge l'utente specificato all'elenco dei visualizzatori per Folder
. Se l'utente era già
nell'elenco degli editor, questo metodo non ha effetto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da aggiungere. |
Ritorni
Folder
- Questo Folder
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addViewer(user)
Aggiunge l'utente specificato all'elenco dei visualizzatori per Folder
. Se l'utente era già
nell'elenco degli editor, questo metodo non ha effetto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da aggiungere. |
Ritorni
Folder
- Questo Folder
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addViewers(emailAddresses)
Aggiunge l'array specificato di utenti all'elenco dei visualizzatori per Folder
. Se qualcuno degli utenti era già presente nell'elenco degli editor, questo metodo non produce alcun effetto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddresses | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Ritorni
Folder
- Questo Folder
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
createFile(blob)
Crea un file nella cartella corrente a partire da un determinato Blob
di dati arbitrari.
// Create an image file in Google Drive using the Maps service. var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob(); DriveApp.getRootFolder().createFile(blob);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blob | BlobSource | I dati per il nuovo file. |
Ritorni
File
: il nuovo file.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
createFile(name, content)
Crea un file di testo nella cartella corrente con il nome e i contenuti specificati. Genera un'eccezione se content
è superiore a 50 MB.
// Create a text file with the content "Hello, world!" DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome del nuovo file. |
content | String | I contenuti del nuovo file. |
Ritorni
File
: il nuovo file.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
createFile(name, content, mimeType)
Crea un file nella cartella corrente con il nome, i contenuti e il tipo MIME specificati. Genera un'eccezione se content
è superiore a 10 MB.
// Create an HTML file with the content "Hello, world!" DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome del nuovo file. |
content | String | I contenuti del nuovo file. |
mimeType | String | Il tipo MIME del nuovo file. |
Ritorni
File
: il nuovo file.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
createFolder(name)
Crea una cartella nella cartella corrente con il nome specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome della nuova cartella. |
Ritorni
Folder
: la nuova cartella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
createShortcut(targetId)
Crea una scorciatoia all'ID elemento di Drive fornito e la restituisce.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
targetId | String | L'ID file del file o della cartella di destinazione. |
Ritorni
File
: la nuova scorciatoia.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)
Crea una scorciatoia all'ID elemento di Drive e alla chiave risorsa forniti e la restituisce. Una chiave di risorsa è un parametro aggiuntivo che deve essere trasmesso per accedere al file o alla cartella di destinazione condivisi tramite un link.
// Creates shortcuts for all folders in the user's drive that have a specific name. // TODO(developer): Replace 'Test-Folder' with a valid folder name in your drive. const folders = DriveApp.getFoldersByName('Test-Folder'); // Iterates through all folders named 'Test-Folder'. while (folders.hasNext()) { const folder = folders.next(); // Creates a shortcut to the provided Drive item ID and resource key, and returns it. DriveApp.createShortcutForTargetIdAndResourceKey(folder.getId(), folder.getResourceKey()); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
targetId | String | L'ID del file o della cartella di destinazione. |
targetResourceKey | String | La chiave della risorsa del file o della cartella di destinazione. |
Ritorni
File
: la nuova scorciatoia.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
getAccess(email)
Consente di ottenere l'autorizzazione concessa all'utente specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
email | String | L'indirizzo email dell'utente le cui autorizzazioni devono essere controllate |
Ritorni
Permission
: le autorizzazioni concesse all'utente
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getAccess(user)
Consente di ottenere l'autorizzazione concessa all'utente specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | una rappresentazione dell'utente di cui devono essere verificate le autorizzazioni |
Ritorni
Permission
: le autorizzazioni concesse all'utente
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getDateCreated()
getDescription()
getEditors()
Consente di acquisire l'elenco degli editor di Folder
. Se l'utente che esegue lo script non ha accesso in modifica a Folder
, questo metodo restituisce un array vuoto.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the list of editors and logs their names to the console. const editors = folder.getEditors(); for (editor of editors) { console.log(editor.getName()); }
Ritorni
User[]
: l'elenco degli editor per questo Folder
se l'utente ha accesso in modifica o, in caso contrario, un array vuoto.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFiles()
Restituisce una raccolta di tutti i file che sono secondari della cartella corrente.
Ritorni
FileIterator
: una raccolta di tutti i file secondari della cartella corrente.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFilesByName(name)
Restituisce una raccolta di tutti i file che sono secondari della cartella corrente e hanno il nome specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome dei file da trovare. |
Ritorni
FileIterator
: una raccolta di tutti i file che sono secondari della cartella corrente e hanno il nome specificato.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFilesByType(mimeType)
Restituisce una raccolta di tutti i file secondari della cartella corrente con il tipo MIME specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
mimeType | String | Il tipo MIME dei file da trovare. |
Ritorni
FileIterator
: una raccolta di tutti i file secondari della cartella corrente e con il tipo MIME specificato.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFolders()
Restituisce una raccolta di tutte le cartelle secondarie della cartella corrente.
Ritorni
FolderIterator
: una raccolta di tutte le cartelle secondarie della cartella corrente.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFoldersByName(name)
Restituisce una raccolta di tutte le cartelle che sono secondarie della cartella corrente e hanno il nome specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome delle cartelle da trovare. |
Ritorni
FolderIterator
: una raccolta di tutte le cartelle che sono secondarie della cartella corrente e hanno il nome specificato.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getId()
getLastUpdated()
Visualizza la data dell'ultimo aggiornamento di Folder
.
Ritorni
Date
: la data dell'ultimo aggiornamento di Folder
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getName()
getOwner()
Ottieni il proprietario di questo Folder
.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the owner of the folder and logs the name to the console. const folderOwner = folder.getOwner(); console.log(folderOwner.getName());
Ritorni
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getParents()
Recupera una raccolta di cartelle che sono elementi padre stretti di Folder
.
Ritorni
FolderIterator
: una raccolta di cartelle che sono elementi principali stretti di Folder
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getResourceKey()
Recupera la chiave risorsa di Folder
necessaria per accedere agli elementi
condivisi utilizzando un link.
Ritorni
String
: la chiave risorsa del Folder
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEligible()
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.
Drive richiede una chiave di risorsa per accedere ad alcuni file o cartelle condivisi tramite un link. Questa modifica fa parte di un aggiornamento della sicurezza. L'aggiornamento è attivo per impostazione predefinita
per i file e le cartelle idonei. Per attivare o disattivare il requisito delle chiavi delle risorse per i file idonei, utilizza
setSecurityUpdateEnabled
.
Scopri di più sull'aggiornamento della sicurezza per Google Drive.
Ritorni
Boolean
: indica se è possibile applicare il requisito della chiave della risorsa per Folder
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEnabled()
Riconosce se questo Folder
richiede una chiave della risorsa per l'accesso quando viene
condiviso tramite un link. Questo requisito è attivo per impostazione predefinita per i file e le cartelle idonei.
Per attivare o disattivare il requisito delle chiavi delle risorse per i file idonei, utilizza
setSecurityUpdateEnabled
.
Scopri di più sull'aggiornamento della sicurezza per Google Drive.
Ritorni
Boolean
: indica se il requisito della chiave della risorsa è abilitato per questo Folder
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingAccess()
Restituisce la classe di utenti che può accedere a Folder
, oltre a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
Ritorni
Access
: la classe di utenti che può accedere al Folder
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingPermission()
Ottieni l'autorizzazione concessa agli utenti che possono accedere a Folder
,
oltre ai singoli utenti a cui è stato concesso esplicitamente l'accesso.
Ritorni
Permission
: le autorizzazioni concesse agli utenti che possono accedere al Folder
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSize()
Restituisce il numero di byte utilizzati per archiviare Folder
in Drive. Tieni presente che i file dell'applicazione Google Workspace non vengono conteggiati ai fini dei limiti di spazio di archiviazione di Drive e, pertanto, restituiscono 0
byte.
Ritorni
Integer
: il numero di byte utilizzati per archiviare Folder
in Drive
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getUrl()
Recupera l'URL che può essere utilizzato per aprire Folder
in un'app Google come Drive o Documenti.
Ritorni
String
: l'URL che può essere utilizzato per visualizzare questo Folder
in un'app Google come Drive o Documenti
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getViewers()
Visualizza l'elenco di spettatori e commentatori per Folder
. Se l'utente che esegue lo script non ha accesso in modifica a Folder
, questo metodo restituisce un array vuoto.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the list of viewers and logs their names to the console. const viewers = folder.getViewers(); for (viewer of viewers) { console.log(viewer.getName()); }
Ritorni
User[]
: l'elenco di visualizzatori e commentatori per Folder
se l'utente dispone dell'accesso in modifica o un array vuoto.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isStarred()
Determina se Folder
è stato aggiunto a Speciali nel Drive dell'utente.
Ritorni
Boolean
: true
se Folder
è stato aggiunto a Speciali nel Drive dell'utente; false
in caso contrario
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isTrashed()
Determina se Folder
si trova nel cestino del Drive dell'utente.
Ritorni
Boolean
: true
se Folder
è nel cestino del Drive dell'utente;
false
in caso contrario
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
moveTo(destination)
Sposta questo elemento nella cartella di destinazione fornita.
L'utente corrente deve essere il proprietario del file o disporre almeno dell'accesso in modifica alla cartella principale dell'elemento per spostare l'elemento nella cartella di destinazione.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
destination | Folder | La cartella che diventa la nuova cartella principale. |
Ritorni
Folder
- Questo Folder
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
removeEditor(emailAddress)
Rimuove l'utente specificato dall'elenco degli editor per Folder
. Questo metodo non impedisce agli utenti di accedere a Folder
se appartengono a una classe di utenti con accesso generale, ad esempio se Folder
è condiviso con l'intero dominio dell'utente o se Folder
si trova su un Drive condiviso a cui l'utente può accedere.
Per i file di Drive, l'utente viene rimosso anche dall'elenco dei visualizzatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da rimuovere. |
Ritorni
Folder
- Questo Folder
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
removeEditor(user)
Rimuove l'utente specificato dall'elenco degli editor per Folder
. Questo metodo non impedisce agli utenti di accedere a Folder
se appartengono a una classe di utenti con accesso generale, ad esempio se Folder
è condiviso con l'intero dominio dell'utente o se Folder
si trova su un Drive condiviso a cui l'utente può accedere.
Per i file di Drive, l'utente viene rimosso anche dall'elenco dei visualizzatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da rimuovere. |
Ritorni
Folder
- Questo Folder
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
removeViewer(emailAddress)
Rimuove l'utente specificato dall'elenco dei visualizzatori e commentatori per Folder
. Questo metodo non ha effetto se l'utente è un editor, non un visualizzatore o un commentatore. Questo metodo non impedisce inoltre agli utenti di accedere a Folder
se appartengono a una classe di utenti con accesso generale, ad esempio se Folder
è condiviso con l'intero dominio dell'utente o se Folder
si trova in un Drive condiviso a cui l'utente può accedere.
Per i file di Drive, l'utente viene rimosso anche dall'elenco degli editor.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da rimuovere. |
Ritorni
Folder
- Questo Folder
per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
removeViewer(user)
Rimuove l'utente specificato dall'elenco dei visualizzatori e commentatori per Folder
. Questo metodo non ha effetto se l'utente è un editor, non un visualizzatore. Questo metodo non impedisce inoltre agli utenti di accedere a Folder
se appartengono a una classe di utenti con accesso generale, ad esempio se Folder
è condiviso con l'intero dominio dell'utente o se Folder
si trova su un Drive condiviso a cui l'utente può accedere.
Per i file di Drive, l'utente viene rimosso anche dall'elenco degli editor.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da rimuovere. |
Ritorni
Folder
- Questo Folder
per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
revokePermissions(emailAddress)
Revoca l'accesso a Folder
concesso all'utente specificato. Questo metodo non impedisce agli utenti di accedere a Folder
se appartengono a una classe di utenti con accesso generale, ad esempio se Folder
è condiviso con l'intero dominio dell'utente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente di cui deve essere revocato l'accesso. |
Ritorni
Folder
- Questo Folder
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
Revoca l'accesso a Folder
concesso all'utente specificato. Questo metodo non impedisce agli utenti di accedere a Folder
se appartengono a una classe di utenti con accesso generale, ad esempio se Folder
è condiviso con l'intero dominio dell'utente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente di cui deve essere revocato l'accesso. |
Ritorni
Folder
- Questo Folder
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
searchFiles(params)
Restituisce una raccolta di tutti i file che sono secondari della cartella corrente e che corrispondono ai criteri di ricerca specificati. I criteri di ricerca sono descritti in dettaglio nella documentazione dell'SDK Google Drive. Tieni presente che il servizio Drive utilizza la versione 2 dell'API Drive e alcuni campi di query sono diversi dalla versione 3. Esamina le differenze di campo tra v2 e v3.
L'argomento params
è una stringa di query che può contenere valori stringa, perciò assicurati di inserire correttamente l'escape delle virgolette (ad esempio "title contains 'Gulliver\\'s
Travels'"
o 'title contains "Gulliver\'s Travels"'
).
// Logs the name of every file that are children of the current folder and modified after February 28, // 2022 whose name contains "untitled."" var files = DriveApp.getRootFolder().searchFiles( 'modifiedDate > "2022-02-28" and title contains "untitled"'); while (files.hasNext()) { var file = files.next(); console.log(file.getName()); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
params | String | I criteri di ricerca, come descritto in dettaglio nella documentazione relativa all'SDK Google Drive. |
Ritorni
FileIterator
: una raccolta di tutti i file che sono secondari della cartella corrente e che corrispondono ai criteri di ricerca.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
searchFolders(params)
Restituisce una raccolta di tutte le cartelle che sono secondarie della cartella corrente e che corrispondono ai criteri di ricerca specificati. I criteri di ricerca sono descritti in dettaglio nella documentazione dell'SDK Google Drive. Tieni presente che il servizio Drive utilizza la versione 2 dell'API Drive e alcuni campi di query sono diversi dalla versione 3. Esamina le differenze di campo tra v2 e v3.
L'argomento params
è una stringa di query che può contenere valori stringa, perciò assicurati di inserire correttamente l'escape delle virgolette (ad esempio "title contains 'Gulliver\\'s
Travels'"
o 'title contains "Gulliver\'s Travels"'
).
// Logs the name of every folder that are children of the current folder and you own and is starred. var folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners'); while (folders.hasNext()) { var folder = folders.next(); console.log(folder.getName()); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
params | String | I criteri di ricerca, come descritto in dettaglio nella documentazione relativa all'SDK Google Drive. |
Ritorni
FolderIterator
: una raccolta di tutte le cartelle che sono secondarie della cartella corrente e che corrispondono ai criteri di ricerca.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
setDescription(description)
Consente di impostare la descrizione dell'elemento Folder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
description | String | la nuova descrizione per Folder |
Ritorni
Folder
: questo Folder
, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setName(name)
Imposta il nome dell'oggetto Folder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nuovo nome di Folder |
Ritorni
Folder
: questo Folder
, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setOwner(emailAddress)
Cambia il proprietario di Folder
. Questo metodo concede inoltre al proprietario precedente l'accesso in modifica esplicita a Folder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente che deve diventare il nuovo proprietario |
Ritorni
Folder
: questo Folder
, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setOwner(user)
Cambia il proprietario di Folder
. Questo metodo concede inoltre al proprietario precedente l'accesso in modifica esplicita a Folder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente che deve diventare il nuovo proprietario. |
Ritorni
Folder
: questo Folder
, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setSecurityUpdateEnabled(enabled)
Consente di impostare se Folder
richiede una chiave della risorsa per l'accesso quando viene
condivisa tramite un link. Le cartelle e i file idonei sono attivati per impostazione predefinita.
Scopri di più sull'aggiornamento della sicurezza per Google Drive.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | Indica se abilitare il requisito della chiave della risorsa per Folder . |
Ritorni
Folder
- Questo Folder
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setSharing(accessType, permissionType)
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.
// Creates a folder that anyone on the Internet can read from and write to. (Domain // administrators can prohibit this setting for users of a Google Workspace domain.) var folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
accessType | Access | la classe di utenti che deve essere in grado di accedere al Folder |
permissionType | Permission | le autorizzazioni da concedere agli utenti che possono accedere a Folder |
Ritorni
Folder
: questo Folder
, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setStarred(starred)
Consente di impostare se l'elemento Folder
viene aggiunto a Speciali nel Drive dell'utente. Il valore predefinito per i nuovi Folder
è false
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
starred | Boolean | true se Folder deve essere aggiunto a Speciali nel Drive dell'utente; false in caso contrario |
Ritorni
Folder
: questo Folder
, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setTrashed(trashed)
Consente di impostare se Folder
si trova nel cestino del Drive dell'utente. Solo il proprietario può spostare Folder
nel cestino. Il valore predefinito per i nuovi Folder
è false
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
trashed | Boolean | true se Folder deve essere spostato nel cestino del Drive dell'utente; in caso contrario false |
Ritorni
Folder
: questo Folder
, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive