Questa pagina è stata tradotta dall'API Cloud Translation.

Class Folder

Una cartella in Google Drive. Puoi accedere alle cartelle o crearle da DriveApp.

// 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
`addEditor(emailAddress)`	`Folder`	Aggiunge l'utente specificato all'elenco degli editor di `Folder`.
`addEditor(user)`	`Folder`	Aggiunge l'utente specificato all'elenco degli editor di `Folder`.
`addEditors(emailAddresses)`	`Folder`	Aggiunge l'array di utenti specificato all'elenco degli editor di `Folder`.
`addViewer(emailAddress)`	`Folder`	Aggiunge l'utente specificato all'elenco degli spettatori del `Folder`.
`addViewer(user)`	`Folder`	Aggiunge l'utente specificato all'elenco degli spettatori del `Folder`.
`addViewers(emailAddresses)`	`Folder`	Aggiunge l'array di utenti specificato all'elenco degli spettatori per `Folder`.
`createFile(blob)`	`File`	Crea un file nella cartella corrente 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 e alla chiave della risorsa di Drive forniti e la restituisce.
`getAccess(email)`	`Permission`	Recupera l'autorizzazione concessa a un utente specifico.
`getAccess(user)`	`Permission`	Recupera l'autorizzazione concessa a un utente specifico.
`getDateCreated()`	`Date`	Recupera la data di creazione del `Folder`.
`getDescription()`	`String`	Recupera la descrizione di `Folder`.
`getEditors()`	`User[]`	Recupera l'elenco degli editor di questo `Folder`.
`getFiles()`	`FileIterator`	Recupera una raccolta di tutti i file che sono elementi secondari della cartella corrente.
`getFilesByName(name)`	`FileIterator`	Recupera una raccolta di tutti i file secondari della cartella corrente che hanno 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`	Recupera una raccolta di tutte le cartelle secondarie della cartella corrente che hanno il nome specificato.
`getId()`	`String`	Recupera l'ID del `Folder`.
`getLastUpdated()`	`Date`	Recupera la data dell'ultimo aggiornamento di `Folder`.
`getName()`	`String`	Recupera il nome del `Folder`.
`getOwner()`	`User`	Restituisce il proprietario di questo `Folder`.
`getParents()`	`FolderIterator`	Recupera una raccolta di cartelle che sono le cartelle principali immediate di `Folder`.
`getResourceKey()`	`String`	Recupera la chiave della risorsa del `Folder` necessaria per accedere agli elementi che sono stati condivisi utilizzando un link.
`getSecurityUpdateEligible()`	`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.
`getSecurityUpdateEnabled()`	`Boolean`	Indica se questo `Folder` richiede una chiave della risorsa per l'accesso quando viene condiviso utilizzando un link.
`getSharingAccess()`	`Access`	Restituisce la classe di utenti che può accedere al `Folder`, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
`getSharingPermission()`	`Permission`	Recupera l'autorizzazione concessa agli utenti che possono accedere a `Folder`, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
`getSize()`	`Integer`	Recupera il numero di byte utilizzati per archiviare il file `Folder` su Drive.
`getUrl()`	`String`	Recupera l'URL che può essere utilizzato per aprire il `Folder` in un'app Google come Drive o Documenti.
`getViewers()`	`User[]`	Recupera l'elenco di visualizzatori e commentatori per questo `Folder`.
`isShareableByEditors()`	`Boolean`	Determina se gli utenti con autorizzazioni di modifica per il `Folder` possono condividerlo con altri utenti o modificarne le autorizzazioni.
`isStarred()`	`Boolean`	Determina se `Folder` è stato aggiunto ai preferiti su Drive dell'utente.
`isTrashed()`	`Boolean`	Determina se `Folder` si trova nel cestino di Drive dell'utente.
`moveTo(destination)`	`Folder`	Sposta questo elemento nella cartella di destinazione specificata.
`removeEditor(emailAddress)`	`Folder`	Rimuove l'utente specificato dall'elenco degli editor di `Folder`.
`removeEditor(user)`	`Folder`	Rimuove l'utente specificato dall'elenco degli editor di `Folder`.
`removeViewer(emailAddress)`	`Folder`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il `Folder`.
`removeViewer(user)`	`Folder`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il `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`	Recupera una raccolta di tutti i file che sono figli della cartella corrente e corrispondono ai criteri di ricerca specificati.
`searchFolders(params)`	`FolderIterator`	Recupera una raccolta di tutte le cartelle secondarie della cartella corrente che corrispondono ai criteri di ricerca specificati.
`setDescription(description)`	`Folder`	Imposta la descrizione per `Folder`.
`setName(name)`	`Folder`	Imposta il nome del `Folder`.
`setOwner(emailAddress)`	`Folder`	Modifica il proprietario del `Folder`.
`setOwner(user)`	`Folder`	Modifica il proprietario del `Folder`.
`setSecurityUpdateEnabled(enabled)`	`Folder`	Imposta se `Folder` richiede una chiave della risorsa per l'accesso quando viene condivisa utilizzando un link.
`setShareableByEditors(shareable)`	`Folder`	Imposta se gli utenti con autorizzazioni di modifica per il `Folder` possono condividerlo con altri utenti o modificarne le autorizzazioni.
`setSharing(accessType, permissionType)`	`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.
`setStarred(starred)`	`Folder`	Imposta se `Folder` è contrassegnato come preferito in Drive dell'utente.
`setTrashed(trashed)`	`Folder`	Imposta se `Folder` si trova nel cestino di Drive dell'utente.

Metodi ritirati

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 di Folder. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`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

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

`addEditors(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
`emailAddresses`	`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

`addViewer(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
`emailAddress`	`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

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

`addViewers(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
`emailAddresses`	`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

`createFile(blob)`

Crea un file nella cartella corrente da un determinato Blob di dati arbitrari.

Parametri

Nome	Tipo	Descrizione
`blob`	`BlobSource`	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

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

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

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

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

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

`getDateCreated()`

Recupera la data di creazione del Folder.

Invio

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

`getDescription()`

Recupera la descrizione di Folder.

Invio

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

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

`getFiles()`

Recupera una raccolta di tutti i file che sono elementi 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)`

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

FileIterator: 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

`getFilesByType(mimeType)`

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

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

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

FolderIterator: 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

`getId()`

Recupera l'ID del Folder.

Invio

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

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

`getName()`

Recupera il nome del Folder.

Invio

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

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

`getParents()`

Recupera una raccolta di cartelle che sono le cartelle principali immediate di Folder.

Invio

FolderIterator: 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

`getResourceKey()`

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

`getSecurityUpdateEligible()`

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

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

`getSharingAccess()`

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

`getSharingPermission()`

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

`getSize()`

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

`getUrl()`

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

`getViewers()`

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

`isShareableByEditors()`

Determina se gli utenti con autorizzazioni di modifica per il Folder possono condividerlo con altri utenti o modificarne le autorizzazioni.

Invio

Boolean - true se gli utenti con autorizzazioni di modifica sono autorizzati a condividere con altri utenti o modificare le autorizzazioni; 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

`isStarred()`

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

`isTrashed()`

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

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

`removeEditor(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
`emailAddress`	`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

`removeEditor(user)`

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

`removeViewer(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
`emailAddress`	`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

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

`revokePermissions(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
`emailAddress`	`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

`revokePermissions(user)`

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

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

FileIterator: 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

`searchFolders(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.

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

FolderIterator: 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

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

`setName(name)`

Imposta il nome del Folder.

Parametri

Nome	Tipo	Descrizione
`name`	`String`	il nuovo nome del `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

`setOwner(emailAddress)`

Modifica il proprietario del Folder. Questo metodo concede inoltre al proprietario precedente accesso in modifica esplicito a Folder.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`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

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

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

`setShareableByEditors(shareable)`

Imposta se gli utenti con autorizzazioni di modifica per il Folder possono condividerlo con altri utenti o modificarne le autorizzazioni. Il valore predefinito per una nuova Folder è true.

Parametri

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

`setSharing(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
`accessType`	`Access`	La classe di utenti che deve poter accedere a `Folder`
`permissionType`	`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

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

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

Metodi ritirati

`addFile(child)`

Ritiro. Utilizza invece File.moveTo(destination) o createShortcut(targetId).

Aggiunge il file specificato alla cartella corrente. Questo metodo non sposta il file dalla sua cartella principale esistente; un file può avere più di un'origine contemporaneamente.

Parametri

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

Invio

Folder: il nuovo file principale aggiunto come file 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)`

Ritiro. Utilizza invece moveTo(destination) o createShortcut(targetId).

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

Parametri

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

Invio

Folder: la nuova cartella principale aggiunta come cartella 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)`

Ritiro. 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 tutte le cartelle principali, non può essere visualizzato su Drive, a meno che non lo cerchi o utilizzi la visualizzazione "Tutti gli elementi".

Parametri

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

Invio

Folder: l'elemento principale precedente dell'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

`removeFolder(child)`

Ritiro. 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 tutte le cartelle principali, non può essere visualizzata su Drive, tranne se la cerchi o utilizzi la visualizzazione "Tutti gli elementi".

Parametri

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

Invio

Folder: l'elemento principale precedente dell'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