Questa pagina è stata tradotta dall'API Cloud Translation.

Class Folder

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.

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
`addFile(child)`	`Folder`	Aggiunge il file specificato alla cartella corrente.
`addFolder(child)`	`Folder`	Aggiunge la cartella specificata alla cartella corrente.
`removeFile(child)`	`Folder`	Rimuove il file specificato dalla cartella corrente.
`removeFolder(child)`	`Folder`	Rimuove la cartella specificata dalla cartella corrente.

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()`

Recupera la data di creazione di Folder.

Ritorni

Date: la data di creazione 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

`getDescription()`

Recupera la descrizione di Folder.

Ritorni

String: la descrizione 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

`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()`

Recupera l'ID di Folder.

Ritorni

String: l'ID 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

`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()`

Recupera il nome di Folder.

Ritorni

String: il nome 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

`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

User: proprietario 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

`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

`isShareableByEditors()`

Determina se gli utenti con autorizzazioni di modifica per Folder sono autorizzati a condividere contenuti con altri utenti o a modificare le autorizzazioni.

Ritorni

Boolean: true se gli utenti con autorizzazioni di modifica sono autorizzati a condividere contenuti con altri utenti o a modificare le autorizzazioni; in caso contrario false

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)`

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)`

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.

// 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

`setShareableByEditors(shareable)`

Consente di stabilire se gli utenti con autorizzazioni di modifica per Folder possono condividere con altri utenti o modificare le autorizzazioni. Il valore predefinito di un nuovo Folder è true.

Parametri

Nome	Tipo	Descrizione
`shareable`	`Boolean`	`true` se gli utenti con autorizzazioni di modifica devono essere autorizzati a condividere con altri utenti o a modificare le autorizzazioni; 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

`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

Metodi deprecati

`addFile(child)`

Obsoleta. Usa invece File.moveTo(destination) o createShortcut(targetId).

Aggiunge il file specificato alla cartella corrente. Questo metodo non sposta il file fuori dalla cartella principale esistente. Un file può avere più di un elemento principale contemporaneamente.

Parametri

Nome	Tipo	Descrizione
`child`	`File`	Il file secondario da aggiungere.

Ritorni

Folder: il nuovo elemento principale del file aggiunto come elemento secondario.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`addFolder(child)`

Obsoleta. Usa invece moveTo(destination) o createShortcut(targetId).

Aggiunge la cartella specificata alla cartella corrente. Questo metodo non sposta la cartella fuori dalla cartella principale esistente; una cartella può avere più di una cartella padre contemporaneamente.

Parametri

Nome	Tipo	Descrizione
`child`	`Folder`	La cartella secondaria da aggiungere.

Ritorni

Folder: il nuovo elemento principale della cartella aggiunta come secondaria.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`removeFile(child)`

Obsoleta. Utilizza invece File.moveTo(destination).

Rimuove il file specificato dalla cartella corrente. Questo metodo non elimina il file, ma se un file viene rimosso da tutti gli elementi principali, non sarà visibile in Drive se non mediante la ricerca o la visualizzazione "Tutti gli elementi".

Parametri

Nome	Tipo	Descrizione
`child`	`File`	Il file secondario da rimuovere.

Ritorni

Folder: l'elemento principale precedente del publisher secondario.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`removeFolder(child)`

Obsoleta. Utilizza invece moveTo(destination).

Rimuove la cartella specificata dalla cartella corrente. Questo metodo non elimina la cartella o i suoi contenuti, ma se una cartella viene rimossa da tutti gli elementi principali, non può essere visualizzata in Drive se non tramite la ricerca o la visualizzazione "Tutti gli elementi".

Parametri

Nome	Tipo	Descrizione
`child`	`Folder`	La cartella secondaria da rimuovere.

Ritorni

Folder: l'elemento principale precedente del publisher secondario.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive