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 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. |
Documentazione dettagliata
addEditor(emailAddress)
Aggiunge l'utente specificato all'elenco di editor per Folder
. Se l'utente era già
nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da aggiungere. |
Invio
Folder
: 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 di editor per Folder
. Se l'utente era già
nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da aggiungere. |
Invio
Folder
: 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 di utenti specificato all'elenco di editor per Folder
. Se uno dei
utenti erano già presenti nell'elenco dei visualizzatori, questo metodo li promuove dall'elenco dei
spettatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddresses | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Invio
Folder
: 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 di visualizzatori per Folder
. Se l'utente era già
nell'elenco degli editor, questo metodo non ha alcun effetto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da aggiungere. |
Invio
Folder
: 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 di visualizzatori per Folder
. Se l'utente era già
nell'elenco degli editor, questo metodo non ha alcun effetto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da aggiungere. |
Invio
Folder
: 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 di visualizzatori per Folder
. Se uno dei
utenti erano già presenti nell'elenco degli editor, questo metodo non ha alcun effetto su di loro.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddresses | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Invio
Folder
: 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. |
Invio
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. Lancia
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. |
Invio
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. Lanci
un'eccezione se content
è più grande di 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. |
Invio
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. |
Invio
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 del file o della cartella di destinazione. |
Invio
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 per l'ID elemento di Drive e la chiave della risorsa forniti e la restituisce. Una risorsa è un parametro aggiuntivo che deve essere passato per accedere al file o alla cartella di destinazione è stato condiviso utilizzando 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. |
Invio
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 di cui è necessario verificare le autorizzazioni |
Invio
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 è necessario verificare le autorizzazioni |
Invio
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()
Ottiene l'elenco degli editor per questo Folder
. Se l'utente che esegue lo script
non dispone dell'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()); }
Invio
User[]
: l'elenco di editor per questo Folder
, se l'utente ha accesso in modifica o un
in 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()
Recupera una raccolta di tutti i file secondari della cartella corrente.
Invio
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 secondari della cartella corrente e con il nome specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome dei file da trovare. |
Invio
FileIterator
: una raccolta di tutti i file secondari della cartella corrente e con 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)
Ottiene una raccolta di tutti i file secondari della cartella corrente e con il tipo MIME specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
mimeType | String | Il tipo MIME dei file da trovare. |
Invio
FileIterator
: una raccolta di tutti i file secondari della cartella corrente e con l'oggetto MIME specificato
di testo.
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()
Recupera una raccolta di tutte le cartelle secondarie della cartella corrente.
Invio
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 secondarie della cartella corrente e con il nome specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome delle cartelle da trovare. |
Invio
FolderIterator
: una raccolta di tutte le cartelle secondarie della cartella corrente e con 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()
Ottiene la data dell'ultimo aggiornamento di Folder
.
Invio
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()
Recupera 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());
Invio
User
: il proprietario di 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
getParents()
Recupera una raccolta di cartelle padre immediate di Folder
.
Invio
FolderIterator
: una raccolta di cartelle padre immediate 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 che
sono stati condivisi tramite link.
Invio
String
: la chiave risorsa del valore 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 il Folder
è idoneo per applicare l'aggiornamento della sicurezza che
richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link.
Drive richiede una chiave della risorsa per accedere ad alcuni file o cartelle che sono stati condivisi utilizzando un
. Questa modifica fa parte di un aggiornamento della sicurezza. L'aggiornamento è attivo per impostazione predefinita per i contenuti
e cartelle. Per attivare o disattivare il requisito della chiave della risorsa per i file idonei, utilizza
setSecurityUpdateEnabled
.
Scopri di più sull'aggiornamento della sicurezza per Google Drive.
Invio
Boolean
: indica se il requisito della chiave della risorsa può essere applicato 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 risorsa per l'accesso quando
condiviso tramite link. Questo requisito è attivo per impostazione predefinita per i file e le cartelle idonei.
Per attivare o disattivare il requisito della chiave della risorsa per i file idonei, utilizza
setSecurityUpdateEnabled
.
Scopri di più sull'aggiornamento della sicurezza per Google Drive.
Invio
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()
Trova la classe di utenti che può accedere all'Folder
, oltre a qualsiasi individuo
agli utenti a cui è stato concesso esplicitamente l'accesso.
Invio
Access
: la classe di utenti che può accedere all'app 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()
Consente di concedere l'autorizzazione agli utenti che possono accedere a Folder
,
accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
Invio
Permission
: le autorizzazioni concesse agli utenti che possono accedere all'app 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()
Recupera il numero di byte utilizzati per archiviare Folder
su Drive. Tieni presente che
I file dell'applicazione Google Workspace non concorrono al raggiungimento dei limiti di spazio di archiviazione di Drive e quindi vengono restituiti
0
byte.
Invio
Integer
: il numero di byte utilizzati per archiviare Folder
su 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.
Invio
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()
Consente di acquisire l'elenco di visualizzatori e commentatori di Folder
. Se l'utente
Esegue lo script non dispone dell'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()); }
Invio
User[]
: l'elenco di visualizzatori e commentatori di questa Folder
, se l'utente ha modificato
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.
Invio
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 l'elemento Folder
si trova nel cestino del Drive dell'utente.
Invio
Boolean
: true
se Folder
si trova 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 proprietà cartella principale corrente per spostare l'elemento nella cartella di destinazione.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
destination | Folder | La cartella che diventa la nuova cartella principale. |
Invio
Folder
: 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
viene condiviso con l'intera organizzazione
dominio 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 dei visualizzatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da rimuovere. |
Invio
Folder
: 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
viene condiviso con l'intera organizzazione
dominio 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 dei visualizzatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da rimuovere. |
Invio
Folder
: 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 di visualizzatori e commentatori per Folder
. Questo
non ha effetto se l'utente è un editor, non un visualizzatore o un commentatore. Questo metodo
non impedisce agli utenti di accedere a Folder
se appartengono a una classe di utenti che
dispongono di accesso generale, ad esempio, se Folder
è condiviso con
l'intero dominio 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. |
Invio
Folder
: 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 di visualizzatori e commentatori per Folder
. Questo
non ha effetto se l'utente è un editor, non un visualizzatore. Inoltre, questo metodo non blocca
agli utenti di accedere a Folder
se appartengono a una classe di utenti con
accesso, ad esempio se Folder
è condiviso con l'intero dominio dell'utente oppure
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 |
---|---|---|
user | User | Una rappresentazione dell'utente da rimuovere. |
Invio
Folder
: 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 al Folder
concesso all'utente specificato. Questo metodo non
impedisce agli utenti di accedere a Folder
se appartengono a una classe di utenti che
dispongono di accesso generale, ad esempio, se Folder
è condiviso con
l'intero dominio.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente di cui deve essere revocato l'accesso. |
Invio
Folder
: 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 al Folder
concesso all'utente specificato. Questo metodo non
impedisce agli utenti di accedere a Folder
se appartengono a una classe di utenti che
dispongono di accesso generale, ad esempio, se Folder
è condiviso con
l'intero dominio.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente di cui deve essere revocato l'accesso. |
Invio
Folder
: 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 secondari della cartella corrente e corrispondenti alla ricerca specificata criteri. I criteri di ricerca sono descritti in dettaglio nella documentazione relativa all'SDK Google Drive. Tieni presente che l'interfaccia utilizza la versione 2 dell'API Drive e alcuni campi di query sono diversi dalla versione 3. Esamina il campo e le differenze tra le versioni v2 e v3.
L'argomento params
è una stringa di query che può contenere valori di stringa, quindi presta attenzione
in modo che le virgolette siano corrette (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 nella documentazione relativa all'SDK Google Drive. |
Invio
FileIterator
: una raccolta di tutti i file secondari della cartella corrente e che corrispondono alla ricerca
criteri.
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 secondarie della cartella corrente e corrispondenti alla ricerca specificata criteri. I criteri di ricerca sono descritti in dettaglio nella documentazione relativa all'SDK Google Drive. Tieni presente che l'interfaccia utilizza la versione 2 dell'API Drive e alcuni campi di query sono diversi dalla versione 3. Esamina il campo e le differenze tra le versioni v2 e v3.
L'argomento params
è una stringa di query che può contenere valori di stringa, quindi presta attenzione
in modo che le virgolette siano corrette (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 nella documentazione relativa all'SDK Google Drive. |
Invio
FolderIterator
: una raccolta di tutte le cartelle secondarie della cartella corrente e che corrispondono alla ricerca
criteri.
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 per Folder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
description | String | la nuova descrizione per Folder |
Invio
Folder
: Folder
, per 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)
Consente di impostare il nome dell'elemento Folder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nuovo nome di Folder |
Invio
Folder
: Folder
, per 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)
Modifica il proprietario di Folder
. Questo metodo fornisce anche al proprietario precedente
accesso in modifica esplicito al Folder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente che dovrebbe diventare il nuovo proprietario |
Invio
Folder
: Folder
, per 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)
Modifica il proprietario di Folder
. Questo metodo fornisce anche al proprietario precedente
accesso in modifica esplicito al Folder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | una rappresentazione dell'utente che dovrebbe diventare il nuovo proprietario |
Invio
Folder
: Folder
, per 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 risorsa per l'accesso quando
condiviso tramite link. I file e le cartelle idonei sono abilitati per impostazione predefinita.
Scopri di più sull'aggiornamento della sicurezza per Google Drive.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | Se abilitare il requisito della chiave della risorsa per Folder . |
Invio
Folder
: 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 all'Folder
e le autorizzazioni
a questi utenti, oltre a quelli individuali a cui è stato esplicitamente concesso 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 | quale classe di utenti deve essere in grado di accedere all'Folder |
permissionType | Permission | le autorizzazioni che devono essere concesse agli utenti che possono accedere all'Folder |
Invio
Folder
: Folder
, per 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 Folder
viene aggiunto a Speciali nel Drive dell'utente. L'impostazione predefinita per
i nuovi Folder
sono false
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
starred | Boolean | true se Folder deve essere aggiunto a Speciali nella cartella
Drive; false in caso contrario |
Invio
Folder
: Folder
, per 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 l'elemento Folder
si trova nel cestino del Drive dell'utente. Solo il
proprietario può spostare nel cestino Folder
. Il valore predefinito per i nuovi Folder
è false
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
trashed | Boolean | true se Folder deve essere spostato nel cestino di
il Drive dell'utente; false in caso contrario |
Invio
Folder
: Folder
, per concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive