Una cartella in Google Drive. Puoi accedere alle cartelle o crearle da Drive
.
// Log the name of every folder in the user's Drive. const folders = DriveApp.getFolders(); while (folders.hasNext()) { const folder = folders.next(); Logger.log(folder.getName()); }
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
add | Folder | Aggiunge l'utente specificato all'elenco degli editor di Folder . |
add | Folder | Aggiunge l'utente specificato all'elenco degli editor di Folder . |
add | Folder | Aggiunge l'array di utenti specificato all'elenco degli editor di Folder . |
add | Folder | Aggiunge l'utente specificato all'elenco degli spettatori del Folder . |
add | Folder | Aggiunge l'utente specificato all'elenco degli spettatori del Folder . |
add | Folder | Aggiunge l'array di utenti specificato all'elenco degli spettatori per Folder . |
create | File | Crea un file nella cartella corrente da un determinato Blob di dati arbitrari. |
create | File | Crea un file di testo nella cartella corrente con il nome e i contenuti specificati. |
create | File | Crea un file nella cartella corrente con il nome, i contenuti e il tipo MIME specificati. |
create | Folder | Crea una cartella nella cartella corrente con il nome specificato. |
create | File | Crea una scorciatoia all'ID elemento di Drive fornito e la restituisce. |
create | File | Crea una scorciatoia all'ID elemento e alla chiave della risorsa di Drive forniti e la restituisce. |
get | Permission | Recupera l'autorizzazione concessa a un utente specifico. |
get | Permission | Recupera l'autorizzazione concessa a un utente specifico. |
get | Date | Recupera la data di creazione del Folder . |
get | String | Recupera la descrizione di Folder . |
get | User[] | Recupera l'elenco degli editor di questo Folder . |
get | File | Recupera una raccolta di tutti i file che sono elementi secondari della cartella corrente. |
get | File | Recupera una raccolta di tutti i file secondari della cartella corrente che hanno il nome specificato. |
get | File | Recupera una raccolta di tutti i file secondari della cartella corrente e con il tipo MIME specificato. |
get | Folder | Recupera una raccolta di tutte le cartelle secondarie della cartella corrente. |
get | Folder | Recupera una raccolta di tutte le cartelle secondarie della cartella corrente che hanno il nome specificato. |
get | String | Recupera l'ID del Folder . |
get | Date | Recupera la data dell'ultimo aggiornamento di Folder . |
get | String | Recupera il nome del Folder . |
get | User | Restituisce il proprietario di questo Folder . |
get | Folder | Recupera una raccolta di cartelle che sono le cartelle principali immediate di Folder . |
get | String | Recupera la chiave della risorsa del Folder necessaria per accedere agli elementi che sono stati condivisi utilizzando un link. |
get | Boolean | Indica se questo Folder è idoneo per l'applicazione dell'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa quando viene condiviso tramite un link. |
get | Boolean | Indica se questo Folder richiede una chiave della risorsa per l'accesso quando viene condiviso utilizzando un link. |
get | Access | Restituisce la classe di utenti che può accedere al Folder , oltre ai singoli
utenti a cui è stato concesso l'accesso esplicitamente. |
get | Permission | Recupera l'autorizzazione concessa agli utenti che possono accedere a Folder , oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente. |
get | Integer | Recupera il numero di byte utilizzati per archiviare il file Folder su Drive. |
get | String | Recupera l'URL che può essere utilizzato per aprire il Folder in un'app Google come Drive o Documenti. |
get | User[] | Recupera l'elenco di visualizzatori e commentatori per questo Folder . |
is | Boolean | Determina se gli utenti con autorizzazioni di modifica per il Folder possono condividerlo con altri utenti o modificarne le autorizzazioni. |
is | Boolean | Determina se Folder è stato aggiunto ai preferiti su Drive dell'utente. |
is | Boolean | Determina se Folder si trova nel cestino di Drive dell'utente. |
move | Folder | Sposta questo elemento nella cartella di destinazione specificata. |
remove | Folder | Rimuove l'utente specificato dall'elenco degli editor di Folder . |
remove | Folder | Rimuove l'utente specificato dall'elenco degli editor di Folder . |
remove | Folder | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il Folder . |
remove | Folder | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il Folder . |
revoke | Folder | Revoca l'accesso a Folder concesso all'utente specificato. |
revoke | Folder | Revoca l'accesso a Folder concesso all'utente specificato. |
search | File | Recupera una raccolta di tutti i file che sono figli della cartella corrente e corrispondono ai criteri di ricerca specificati. |
search | Folder | Recupera una raccolta di tutte le cartelle secondarie della cartella corrente che corrispondono ai criteri di ricerca specificati. |
set | Folder | Imposta la descrizione per Folder . |
set | Folder | Imposta il nome del Folder . |
set | Folder | Modifica il proprietario del Folder . |
set | Folder | Modifica il proprietario del Folder . |
set | Folder | Imposta se Folder richiede una chiave della risorsa per l'accesso quando viene condivisa utilizzando un link. |
set | Folder | Imposta se gli utenti con autorizzazioni di modifica per il Folder possono condividerlo con altri utenti o modificarne le autorizzazioni. |
set | Folder | Imposta la classe di utenti che può accedere a Folder e le autorizzazioni concesse a questi utenti, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente. |
set | Folder | Imposta se Folder è contrassegnato come preferito in Drive dell'utente. |
set | Folder | Imposta se Folder si trova nel cestino di Drive dell'utente. |
Documentazione dettagliata
add Editor(emailAddress)
Aggiunge l'utente specificato all'elenco degli editor di Folder
. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
email | String | L'indirizzo email dell'utente da aggiungere. |
Invio
Folder
: questo Folder
, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
add Editor(user)
Aggiunge l'utente specificato all'elenco degli editor di Folder
. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da aggiungere. |
Invio
Folder
: questo Folder
, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
add Editors(emailAddresses)
Aggiunge l'array di utenti specificato all'elenco degli editor di Folder
. Se uno degli utenti faceva già parte dell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
email | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Invio
Folder
: questo Folder
, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
add Viewer(emailAddress)
Aggiunge l'utente specificato all'elenco degli spettatori del Folder
. Se l'utente era già nell'elenco degli editor, questo metodo non ha alcun effetto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
email | String | L'indirizzo email dell'utente da aggiungere. |
Invio
Folder
: questo Folder
, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
add Viewer(user)
Aggiunge l'utente specificato all'elenco degli spettatori del 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
: questo Folder
, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
add Viewers(emailAddresses)
Aggiunge l'array di utenti specificato all'elenco degli spettatori per Folder
. Se uno degli utenti faceva già parte dell'elenco degli editor, questo metodo non ha alcun effetto su di lui.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
email | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Invio
Folder
: questo Folder
, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
create File(blob)
Crea un file nella cartella corrente da un determinato Blob
di dati arbitrari.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blob | Blob | I dati 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
create File(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. |
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
create File(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. |
mime | 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
create Folder(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
create Shortcut(targetId)
Crea una scorciatoia all'ID elemento di Drive fornito e la restituisce.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
target | 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
create Shortcut For Target Id And Resource Key(targetId, targetResourceKey)
Crea una scorciatoia all'ID elemento e alla chiave della risorsa di Drive forniti e la restituisce. Una chiave risorsa è un parametro aggiuntivo che deve essere passato per accedere al file o alla cartella di destinazione che è stata condivisa 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 |
---|---|---|
target | String | L'ID del file o della cartella di destinazione. |
target | 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
get Access(email)
Recupera l'autorizzazione concessa a un utente specifico. Il metodo non supporta il ritorno delle autorizzazioni per un gruppo Google o le autorizzazioni ereditate tramite Google Gruppi.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
email | String | L'indirizzo email dell'utente di cui devono essere controllate le autorizzazioni. Google Gruppi non è supportato. |
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
get Access(user)
Recupera l'autorizzazione concessa a un utente specifico. Il metodo non supporta il ritorno delle autorizzazioni per un gruppo Google o le autorizzazioni ereditate tramite Google Gruppi.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente di cui devono essere controllate 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
get Date Created()
get Description()
get Editors()
Recupera l'elenco degli editor di questo 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 (const editor of editors) { console.log(editor.getName()); }
Invio
User[]
: l'elenco degli editor di questo Folder
se l'utente dispone dell'accesso in modifica o un array vuoto 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
get Files()
Recupera una raccolta di tutti i file che sono elementi secondari della cartella corrente.
Invio
File
: 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
get Files By Name(name)
Recupera una raccolta di tutti i file secondari della cartella corrente che hanno il nome specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome dei file da trovare. |
Invio
File
: una raccolta di tutti i file secondari della cartella corrente che 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
get Files By Type(mimeType)
Recupera una raccolta di tutti i file secondari della cartella corrente e con il tipo MIME specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
mime | String | Il tipo MIME dei file da trovare. |
Invio
File
: una raccolta di tutti i file secondari della cartella corrente che hanno 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
get Folders()
Recupera una raccolta di tutte le cartelle secondarie della cartella corrente.
Invio
Folder
: 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
get Folders By Name(name)
Recupera una raccolta di tutte le cartelle secondarie della cartella corrente che hanno il nome specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome delle cartelle da trovare. |
Invio
Folder
: una raccolta di tutte le cartelle secondarie della cartella corrente che 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
get Id()
get Last Updated()
Recupera 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
get Name()
get Owner()
Restituisce 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
get Parents()
Recupera una raccolta di cartelle che sono le cartelle principali immediate di Folder
.
Invio
Folder
: una raccolta di cartelle che sono cartelle principali 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
get Resource Key()
Recupera la chiave della risorsa del Folder
necessaria per accedere agli elementi che sono stati condivisi utilizzando un link.
Invio
String
: la chiave della 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
get Security Update Eligible()
Indica se questo Folder
è idoneo per l'applicazione dell'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa quando viene condiviso tramite un link.
Drive richiede una chiave della 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 della chiave della risorsa per i file idonei, utilizza
set
.
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
get Security Update Enabled()
Indica se questo Folder
richiede una chiave della risorsa per l'accesso quando viene condiviso utilizzando un 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
get Sharing Access()
Restituisce la classe di utenti che può accedere al Folder
, oltre ai singoli
utenti a cui è stato concesso l'accesso esplicitamente.
Invio
Access
: la classe di utenti che può accedere a 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
get Sharing Permission()
Recupera l'autorizzazione concessa agli utenti che possono accedere a Folder
, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
Invio
Permission
: le autorizzazioni concesse agli utenti che possono accedere a 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
get Size()
Recupera il numero di byte utilizzati per archiviare il file Folder
su Drive. Tieni presente che
i file delle applicazioni Google Workspace non vengono conteggiati ai fini del calcolo dei limiti di spazio di archiviazione di Drive e quindi restituiscono
0
byte.
Invio
Integer
: il numero di byte utilizzati per archiviare il 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
get Url()
Recupera l'URL che può essere utilizzato per aprire il 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
get Viewers()
Recupera l'elenco di visualizzatori e commentatori per questo 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 (const viewer of viewers) { console.log(viewer.getName()); }
Invio
User[]
: l'elenco di visualizzatori e commentatori di questo Folder
se l'utente dispone dell'accesso in modifica o un array vuoto 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
is Starred()
Determina se Folder
è stato aggiunto ai preferiti su Drive dell'utente.
Invio
Boolean
- true
se Folder
è contrassegnato come preferito in 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
is Trashed()
Determina se Folder
si trova nel cestino di Drive dell'utente.
Invio
Boolean
- true
se il Folder
si trova nel cestino di 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
move To(destination)
Sposta questo elemento nella cartella di destinazione specificata.
Per spostare l'elemento nella cartella di destinazione, l'utente corrente deve essere il proprietario del file o disporre almeno dell'accesso in modifica alla cartella principale corrente dell'elemento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
destination | Folder | La cartella che diventa la nuova cartella principale. |
Invio
Folder
: questo Folder
, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
remove Editor(emailAddress)
Rimuove l'utente specificato dall'elenco degli editor di 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 in un Drive condiviso a cui l'utente può accedere.
Per i file di Drive, l'utente viene rimosso anche dall'elenco degli spettatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
email | String | L'indirizzo email dell'utente da rimuovere. |
Invio
Folder
: questo Folder
, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
remove Editor(user)
Rimuove l'utente specificato dall'elenco degli editor di 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 in un Drive condiviso a cui l'utente può accedere.
Per i file di Drive, l'utente viene rimosso anche dall'elenco degli spettatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da rimuovere. |
Invio
Folder
: questo Folder
, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
remove Viewer(emailAddress)
Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il Folder
. Questo metodo non ha alcun effetto se l'utente è un editor, non uno spettatore o un commentatore. Inoltre, questo metodo
non impedisce agli utenti di accedere a Folder
se appartengono a una classe di utenti che
hanno 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 |
---|---|---|
email | String | L'indirizzo email dell'utente da rimuovere. |
Invio
Folder
: questo Folder
per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
remove Viewer(user)
Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il Folder
. Questo metodo non ha alcun effetto se l'utente è un editor e non un visualizzatore. Inoltre, 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 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
: questo Folder
per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
revoke Permissions(emailAddress)
Revoca l'accesso a Folder
concesso all'utente specificato. Questo metodo non impedisce agli utenti di accedere al Folder
se appartengono a una classe di utenti che hanno accesso generale, ad esempio se il Folder
è condiviso con l'intero dominio dell'utente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
email | String | L'indirizzo email dell'utente di cui deve essere revocato l'accesso. |
Invio
Folder
: questo Folder
, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
revoke Permissions(user)
Revoca l'accesso a Folder
concesso all'utente specificato. Questo metodo non impedisce agli utenti di accedere al Folder
se appartengono a una classe di utenti che hanno accesso generale, ad esempio se il 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. |
Invio
Folder
: questo Folder
, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
search Files(params)
Recupera una raccolta di tutti i file che sono figli della cartella corrente e corrispondono ai criteri di ricerca specificati. I criteri di ricerca sono descritti nella documentazione dell'SDK di 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 tra i campi della versione 2 e della versione 3.
L'argomento params
è una stringa di query che può contenere valori di stringa, quindi assicurati di eseguire correttamente la fuga 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."" const files = DriveApp.getRootFolder().searchFiles( 'modifiedDate > "2022-02-28" and title contains "untitled"'); while (files.hasNext()) { const file = files.next(); console.log(file.getName()); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
params | String | I criteri di ricerca, come descritto nella documentazione dell'SDK Google Drive. |
Invio
File
: una raccolta di tutti i file secondari della cartella corrente 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
search Folders(params)
Recupera una raccolta di tutte le cartelle secondarie della cartella corrente che corrispondono ai criteri di ricerca specificati. I criteri di ricerca sono descritti nella documentazione dell'SDK di 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 tra i campi della versione 2 e della versione 3.
L'argomento params
è una stringa di query che può contenere valori di stringa, quindi assicurati di eseguire correttamente la fuga 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. const folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners'); while (folders.hasNext()) { const folder = folders.next(); console.log(folder.getName()); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
params | String | I criteri di ricerca, come descritto nella documentazione dell'SDK Google Drive. |
Invio
Folder
: una raccolta di tutte le cartelle secondarie della cartella corrente 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
set Description(description)
Imposta la descrizione per Folder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
description | String | la nuova descrizione per il Folder |
Invio
Folder
- questo Folder
, per l'accodamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
set Name(name)
set Owner(emailAddress)
Modifica il proprietario del Folder
. Questo metodo concede inoltre al proprietario precedente accesso in modifica esplicito a Folder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
email | String | L'indirizzo email dell'utente che deve diventare il nuovo proprietario |
Invio
Folder
- questo Folder
, per l'accodamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
set Owner(user)
Modifica il proprietario del Folder
. Questo metodo concede inoltre al proprietario precedente accesso in modifica esplicito a Folder
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | una rappresentazione dell'utente che deve diventare il nuovo proprietario |
Invio
Folder
- questo Folder
, per l'accodamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
set Security Update Enabled(enabled)
Imposta se Folder
richiede una chiave della risorsa per l'accesso quando viene condivisa utilizzando un link. I file e le cartelle idonei sono attivati 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
: questo Folder
, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
set Sharing(accessType, permissionType)
Imposta la classe di utenti che può accedere a Folder
e le autorizzazioni concesse a questi utenti, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
// 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.) const folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
access | Access | La classe di utenti che deve poter accedere a Folder |
permission | Permission | le autorizzazioni che devono essere concesse agli utenti che possono accedere a Folder |
Invio
Folder
- questo Folder
, per l'accodamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
set Starred(starred)
Imposta se Folder
è contrassegnato come preferito in Drive dell'utente. Il valore predefinito per i nuovi Folder
è false
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
starred | Boolean | true se Folder deve essere contrassegnato come preferito su Drive dell'utente; false in caso contrario |
Invio
Folder
- questo Folder
, per l'accodamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
set Trashed(trashed)
Imposta se Folder
si trova nel cestino di Drive dell'utente. Solo il
proprietario può eliminare il Folder
. Il valore predefinito per i nuovi Folder
è false
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
trashed | Boolean | true se Folder deve essere spostato nel cestino di Drive dell'utente; false in caso contrario |
Invio
Folder
- questo Folder
, per l'accodamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive