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 di editor per `Folder`.
`addEditor(user)`	`Folder`	Aggiunge l'utente specificato all'elenco di editor per `Folder`.
`addEditors(emailAddresses)`	`Folder`	Aggiunge l'array di utenti specificato all'elenco di editor per `Folder`.
`addViewer(emailAddress)`	`Folder`	Aggiunge l'utente specificato all'elenco di visualizzatori per `Folder`.
`addViewer(user)`	`Folder`	Aggiunge l'utente specificato all'elenco di visualizzatori per `Folder`.
`addViewers(emailAddresses)`	`Folder`	Aggiunge l'array specificato di utenti all'elenco di visualizzatori per `Folder`.
`createFile(blob)`	`File`	Crea un file nella cartella corrente a partire da un determinato `Blob` di dati arbitrari.
`createFile(name, content)`	`File`	Crea un file di testo nella cartella corrente con il nome e i contenuti specificati.
`createFile(name, content, mimeType)`	`File`	Crea un file nella cartella corrente con il nome, i contenuti e il tipo MIME specificati.
`createFolder(name)`	`Folder`	Crea una cartella nella cartella corrente con il nome specificato.
`createShortcut(targetId)`	`File`	Crea una scorciatoia all'ID elemento di Drive fornito e la restituisce.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Crea una scorciatoia all'ID elemento di Drive e alla chiave della risorsa forniti e la restituisce.
`getAccess(email)`	`Permission`	Consente di ottenere l'autorizzazione concessa all'utente specificato.
`getAccess(user)`	`Permission`	Consente di ottenere l'autorizzazione concessa all'utente specificato.
`getDateCreated()`	`Date`	Recupera la data di creazione di `Folder`.
`getDescription()`	`String`	Recupera la descrizione del `Folder`.
`getEditors()`	`User[]`	Ottiene l'elenco degli editor per questo `Folder`.
`getFiles()`	`FileIterator`	Recupera una raccolta di tutti i file secondari della cartella corrente.
`getFilesByName(name)`	`FileIterator`	Restituisce una raccolta di tutti i file secondari della cartella corrente e con il nome specificato.
`getFilesByType(mimeType)`	`FileIterator`	Recupera una raccolta di tutti i file secondari della cartella corrente e con il tipo MIME specificato.
`getFolders()`	`FolderIterator`	Recupera una raccolta di tutte le cartelle secondarie della cartella corrente.
`getFoldersByName(name)`	`FolderIterator`	Restituisce una raccolta di tutte le cartelle secondarie della cartella corrente e con il nome specificato.
`getId()`	`String`	Recupera l'ID di `Folder`.
`getLastUpdated()`	`Date`	Ottiene la data dell'ultimo aggiornamento di `Folder`.
`getName()`	`String`	Ottiene il nome del `Folder`.
`getOwner()`	`User`	Recupera il proprietario di questo `Folder`.
`getParents()`	`FolderIterator`	Recupera una raccolta di cartelle padre immediate di `Folder`.
`getResourceKey()`	`String`	Recupera la chiave risorsa di `Folder` necessaria per accedere agli elementi che sono stati condivisi tramite link.
`getSecurityUpdateEligible()`	`Boolean`	Riconosce se il `Folder` è idoneo per applicare l'aggiornamento della sicurezza che richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link.
`getSecurityUpdateEnabled()`	`Boolean`	Riconosce se questo `Folder` richiede una chiave risorsa per l'accesso quando condiviso tramite link.
`getSharingAccess()`	`Access`	Trova la classe di utenti che può accedere all'`Folder`, oltre a qualsiasi individuo agli utenti a cui è stato concesso esplicitamente l'accesso.
`getSharingPermission()`	`Permission`	Consente di concedere l'autorizzazione agli utenti che possono accedere a `Folder`, accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
`getSize()`	`Integer`	Recupera il numero di byte utilizzati per archiviare `Folder` su Drive.
`getUrl()`	`String`	Recupera l'URL che può essere utilizzato per aprire `Folder` in un'app Google come Drive o Documenti.
`getViewers()`	`User[]`	Consente di acquisire l'elenco di visualizzatori e commentatori di `Folder`.
`isShareableByEditors()`	`Boolean`	Consente di stabilire se gli utenti con autorizzazioni di modifica per `Folder` possono condividere con altri utenti o modificare le autorizzazioni.
`isStarred()`	`Boolean`	Determina se `Folder` è stato aggiunto a Speciali nel Drive dell'utente.
`isTrashed()`	`Boolean`	Determina se l'elemento `Folder` si trova nel cestino del Drive dell'utente.
`moveTo(destination)`	`Folder`	Sposta questo elemento nella cartella di destinazione fornita.
`removeEditor(emailAddress)`	`Folder`	Rimuove l'utente specificato dall'elenco degli editor per `Folder`.
`removeEditor(user)`	`Folder`	Rimuove l'utente specificato dall'elenco degli editor per `Folder`.
`removeViewer(emailAddress)`	`Folder`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per `Folder`.
`removeViewer(user)`	`Folder`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Revoca l'accesso al `Folder` concesso all'utente specificato.
`revokePermissions(user)`	`Folder`	Revoca l'accesso al `Folder` concesso all'utente specificato.
`searchFiles(params)`	`FileIterator`	Restituisce una raccolta di tutti i file secondari della cartella corrente e corrispondenti alla ricerca specificata criteri.
`searchFolders(params)`	`FolderIterator`	Restituisce una raccolta di tutte le cartelle secondarie della cartella corrente e corrispondenti alla ricerca specificata criteri.
`setDescription(description)`	`Folder`	Consente di impostare la descrizione per `Folder`.
`setName(name)`	`Folder`	Consente di impostare il nome dell'elemento `Folder`.
`setOwner(emailAddress)`	`Folder`	Modifica il proprietario di `Folder`.
`setOwner(user)`	`Folder`	Modifica il proprietario di `Folder`.
`setSecurityUpdateEnabled(enabled)`	`Folder`	Consente di impostare se `Folder` richiede una chiave risorsa per l'accesso quando condiviso tramite link.
`setShareableByEditors(shareable)`	`Folder`	Consente di stabilire se gli utenti con autorizzazioni di modifica per `Folder` possono condividere con altri utenti o modificare le autorizzazioni.
`setSharing(accessType, permissionType)`	`Folder`	Imposta la classe di utenti che può accedere all'`Folder` e le autorizzazioni a questi utenti, oltre a quelli individuali a cui è stato esplicitamente concesso l'accesso.
`setStarred(starred)`	`Folder`	Consente di impostare se `Folder` viene aggiunto a Speciali nel Drive dell'utente.
`setTrashed(trashed)`	`Folder`	Consente di impostare se l'elemento `Folder` si trova nel cestino del Drive dell'utente.

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 di editor per Folder. Se l'utente era già nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da aggiungere.

Invio

Folder: Folder, per il concatenamento.

Autorizzazione

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

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

`addEditor(user)`

Aggiunge l'utente specificato all'elenco di editor per Folder. Se l'utente era già nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da aggiungere.

Invio

Folder: Folder, per il concatenamento.

Autorizzazione

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

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

`addEditors(emailAddresses)`

Aggiunge l'array di utenti specificato all'elenco di editor per Folder. Se uno dei utenti erano già presenti nell'elenco dei visualizzatori, questo metodo li promuove dall'elenco dei spettatori.

Parametri

Nome	Tipo	Descrizione
`emailAddresses`	`String[]`	Un array di indirizzi email degli utenti da aggiungere.

Invio

Folder: Folder, per il concatenamento.

Autorizzazione

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

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

`addViewer(emailAddress)`

Aggiunge l'utente specificato all'elenco di visualizzatori per Folder. Se l'utente era già nell'elenco degli editor, questo metodo non ha alcun effetto.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da aggiungere.

Invio

Folder: Folder, per il concatenamento.

Autorizzazione

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

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

`addViewer(user)`

Aggiunge l'utente specificato all'elenco di visualizzatori per Folder. Se l'utente era già nell'elenco degli editor, questo metodo non ha alcun effetto.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da aggiungere.

Invio

Folder: Folder, per il concatenamento.

Autorizzazione

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

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

`addViewers(emailAddresses)`

Aggiunge l'array specificato di utenti all'elenco di visualizzatori per Folder. Se uno dei utenti erano già presenti nell'elenco degli editor, questo metodo non ha alcun effetto su di loro.

Parametri

Nome	Tipo	Descrizione
`emailAddresses`	`String[]`	Un array di indirizzi email degli utenti da aggiungere.

Invio

Folder: Folder, per il concatenamento.

Autorizzazione

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

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

`createFile(blob)`

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

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.getRootFolder().createFile(blob);

Parametri

Nome	Tipo	Descrizione
`blob`	`BlobSource`	I dati per il nuovo file.

Invio

File: il nuovo file.

Autorizzazione

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

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

`createFile(name, content)`

Crea un file di testo nella cartella corrente con il nome e i contenuti specificati. Lancia eccezione se content è superiore a 50 MB.

// Create a text file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome del nuovo file.
`content`	`String`	I contenuti del nuovo file.

Invio

File: il nuovo file.

Autorizzazione

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

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

`createFile(name, content, mimeType)`

Crea un file nella cartella corrente con il nome, i contenuti e il tipo MIME specificati. Lanci un'eccezione se content è più grande di 10 MB.

// Create an HTML file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome del nuovo file.
`content`	`String`	I contenuti del nuovo file.
`mimeType`	`String`	Il tipo MIME del nuovo file.

Invio

File: il nuovo file.

Autorizzazione

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

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

`createFolder(name)`

Crea una cartella nella cartella corrente con il nome specificato.

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome della nuova cartella.

Invio

Folder: la nuova cartella.

Autorizzazione

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

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

`createShortcut(targetId)`

Crea una scorciatoia all'ID elemento di Drive fornito e la restituisce.

Parametri

Nome	Tipo	Descrizione
`targetId`	`String`	L'ID del file o della cartella di destinazione.

Invio

File: la nuova scorciatoia.

Autorizzazione

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

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

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

Crea una scorciatoia per l'ID elemento di Drive e la chiave della risorsa forniti e la restituisce. Una risorsa è un parametro aggiuntivo che deve essere passato per accedere al file o alla cartella di destinazione è stato condiviso utilizzando un link.

// Creates shortcuts for all folders in the user's drive that have a specific name.
// TODO(developer): Replace 'Test-Folder' with a valid folder name in your drive.
const folders = DriveApp.getFoldersByName('Test-Folder');

// Iterates through all folders named 'Test-Folder'.
while (folders.hasNext()) {
  const folder = folders.next();

  // Creates a shortcut to the provided Drive item ID and resource key, and returns it.
  DriveApp.createShortcutForTargetIdAndResourceKey(folder.getId(), folder.getResourceKey());
}

Parametri

Nome	Tipo	Descrizione
`targetId`	`String`	L'ID del file o della cartella di destinazione.
`targetResourceKey`	`String`	La chiave della risorsa del file o della cartella di destinazione.

Invio

File: la nuova scorciatoia.

Autorizzazione

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

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

`getAccess(email)`

Consente di ottenere l'autorizzazione concessa all'utente specificato.

Parametri

Nome	Tipo	Descrizione
`email`	`String`	L'indirizzo email dell'utente di cui è necessario verificare le autorizzazioni

Invio

Permission: le autorizzazioni concesse all'utente

Autorizzazione

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

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

`getAccess(user)`

Consente di ottenere l'autorizzazione concessa all'utente specificato.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	una rappresentazione dell'utente di cui è necessario verificare le autorizzazioni

Invio

Permission: le autorizzazioni concesse all'utente

Autorizzazione

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

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

`getDateCreated()`

Recupera la data di creazione di Folder.

Invio

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

Ottiene l'elenco degli editor per questo Folder. Se l'utente che esegue lo script non dispone dell'accesso in modifica a Folder, questo metodo restituisce un array vuoto.

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of editors and logs their names to the console.
const editors = folder.getEditors();
for (editor of editors) {
  console.log(editor.getName());
}

Invio

User[]: l'elenco di editor per questo Folder, se l'utente ha accesso in modifica o un in un array vuoto.

Autorizzazione

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

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

`getFiles()`

Recupera una raccolta di tutti i file secondari della cartella corrente.

Invio

FileIterator: una raccolta di tutti i file secondari della cartella corrente.

Autorizzazione

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

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

`getFilesByName(name)`

Restituisce una raccolta di tutti i file secondari della cartella corrente e con il nome specificato.

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome dei file da trovare.

Invio

FileIterator: una raccolta di tutti i file secondari della cartella corrente e con il nome specificato.

Autorizzazione

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

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

`getFilesByType(mimeType)`

Ottiene una raccolta di tutti i file secondari della cartella corrente e con il tipo MIME specificato.

Parametri

Nome	Tipo	Descrizione
`mimeType`	`String`	Il tipo MIME dei file da trovare.

Invio

FileIterator: una raccolta di tutti i file secondari della cartella corrente e con l'oggetto MIME specificato di testo.

Autorizzazione

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

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

`getFolders()`

Recupera una raccolta di tutte le cartelle secondarie della cartella corrente.

Invio

FolderIterator: una raccolta di tutte le cartelle secondarie della cartella corrente.

Autorizzazione

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

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

`getFoldersByName(name)`

Restituisce una raccolta di tutte le cartelle secondarie della cartella corrente e con il nome specificato.

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome delle cartelle da trovare.

Invio

FolderIterator: una raccolta di tutte le cartelle secondarie della cartella corrente e con il nome specificato.

Autorizzazione

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

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

`getId()`

Recupera l'ID di Folder.

Invio

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

`getLastUpdated()`

Ottiene la data dell'ultimo aggiornamento di Folder.

Invio

Date: la data dell'ultimo aggiornamento di Folder

Autorizzazione

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

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

`getName()`

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

Recupera il proprietario di questo Folder.

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the owner of the folder and logs the name to the console.
const folderOwner = folder.getOwner();
console.log(folderOwner.getName());

Invio

User: il proprietario di questo Folder.

Autorizzazione

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

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

`getParents()`

Recupera una raccolta di cartelle padre immediate di Folder.

Invio

FolderIterator: una raccolta di cartelle padre immediate di Folder

Autorizzazione

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

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

`getResourceKey()`

Recupera la chiave risorsa di Folder necessaria per accedere agli elementi che sono stati condivisi tramite link.

Invio

String: la chiave risorsa del valore Folder.

Autorizzazione

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

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

`getSecurityUpdateEligible()`

Riconosce se il Folder è idoneo per applicare l'aggiornamento della sicurezza che richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link.

Drive richiede una chiave della risorsa per accedere ad alcuni file o cartelle che sono stati condivisi utilizzando un . Questa modifica fa parte di un aggiornamento della sicurezza. L'aggiornamento è attivo per impostazione predefinita per i contenuti e cartelle. Per attivare o disattivare il requisito della chiave della risorsa per i file idonei, utilizza setSecurityUpdateEnabled.

Scopri di più sull'aggiornamento della sicurezza per Google Drive.

Invio

Boolean: indica se il requisito della chiave della risorsa può essere applicato per Folder.

Autorizzazione

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

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

`getSecurityUpdateEnabled()`

Riconosce se questo Folder richiede una chiave risorsa per l'accesso quando condiviso tramite link. Questo requisito è attivo per impostazione predefinita per i file e le cartelle idonei. Per attivare o disattivare il requisito della chiave della risorsa per i file idonei, utilizza setSecurityUpdateEnabled.

Scopri di più sull'aggiornamento della sicurezza per Google Drive.

Invio

Boolean: indica se il requisito della chiave della risorsa è abilitato per questo Folder.

Autorizzazione

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

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

`getSharingAccess()`

Trova la classe di utenti che può accedere all'Folder, oltre a qualsiasi individuo agli utenti a cui è stato concesso esplicitamente l'accesso.

Invio

Access: la classe di utenti che può accedere all'app Folder

Autorizzazione

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

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

`getSharingPermission()`

Consente di concedere l'autorizzazione agli utenti che possono accedere a Folder, accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.

Invio

Permission: le autorizzazioni concesse agli utenti che possono accedere all'app Folder.

Autorizzazione

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

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

`getSize()`

Recupera il numero di byte utilizzati per archiviare Folder su Drive. Tieni presente che I file dell'applicazione Google Workspace non concorrono al raggiungimento dei limiti di spazio di archiviazione di Drive e quindi vengono restituiti 0 byte.

Invio

Integer: il numero di byte utilizzati per archiviare Folder su Drive

Autorizzazione

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

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

`getUrl()`

Recupera l'URL che può essere utilizzato per aprire Folder in un'app Google come Drive o Documenti.

Invio

String: l'URL che può essere utilizzato per visualizzare questo Folder in un'app Google come Drive o Documenti

Autorizzazione

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

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

`getViewers()`

Consente di acquisire l'elenco di visualizzatori e commentatori di Folder. Se l'utente Esegue lo script non dispone dell'accesso in modifica a Folder, questo metodo restituisce un array vuoto.

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of viewers and logs their names to the console.
const viewers = folder.getViewers();
for (viewer of viewers) {
  console.log(viewer.getName());
}

Invio

User[]: l'elenco di visualizzatori e commentatori di questa Folder, se l'utente ha modificato o un array vuoto.

Autorizzazione

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

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

`isShareableByEditors()`

Consente di stabilire se gli utenti con autorizzazioni di modifica per Folder possono condividere con altri utenti o modificare le autorizzazioni.

Invio

Boolean: true se gli utenti con autorizzazioni di modifica sono autorizzati a condividere contenuti 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 a Speciali nel Drive dell'utente.

Invio

Boolean: true se Folder è stato aggiunto a Speciali nel Drive dell'utente; false in caso contrario

Autorizzazione

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

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

`isTrashed()`

Determina se l'elemento Folder si trova nel cestino del Drive dell'utente.

Invio

Boolean: true se Folder si trova nel cestino del Drive dell'utente; false in caso contrario

Autorizzazione

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

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

`moveTo(destination)`

Sposta questo elemento nella cartella di destinazione fornita.

L'utente corrente deve essere il proprietario del file o disporre almeno dell'accesso in modifica alla proprietà cartella principale corrente per spostare l'elemento nella cartella di destinazione.

Parametri

Nome	Tipo	Descrizione
`destination`	`Folder`	La cartella che diventa la nuova cartella principale.

Invio

Folder: Folder, per il concatenamento.

Autorizzazione

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

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

`removeEditor(emailAddress)`

Rimuove l'utente specificato dall'elenco degli editor per Folder. Questo metodo non impedisce agli utenti di accedere a Folder se appartengono a una classe di utenti con accesso generale, ad esempio se Folder viene condiviso con l'intera organizzazione dominio o se Folder si trova in un Drive condiviso a cui l'utente può accedere.

Per i file di Drive, l'utente viene rimosso anche dall'elenco dei visualizzatori.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da rimuovere.

Invio

Folder: Folder, per il concatenamento.

Autorizzazione

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

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

`removeEditor(user)`

Per i file di Drive, l'utente viene rimosso anche dall'elenco dei visualizzatori.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da rimuovere.

Invio

Folder: Folder, per il concatenamento.

Autorizzazione

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

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

`removeViewer(emailAddress)`

Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per Folder. Questo non ha effetto se l'utente è un editor, non un visualizzatore o un commentatore. Questo metodo non impedisce agli utenti di accedere a Folder se appartengono a una classe di utenti che dispongono di accesso generale, ad esempio, se Folder è condiviso con l'intero dominio o se Folder si trova in un Drive condiviso a cui l'utente può accedere.

Per i file di Drive, l'utente viene rimosso anche dall'elenco degli editor.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da rimuovere.

Invio

Folder: Folder per il concatenamento.

Autorizzazione

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

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

`removeViewer(user)`

Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per Folder. Questo non ha effetto se l'utente è un editor, non un visualizzatore. Inoltre, questo metodo non blocca agli utenti di accedere a Folder se appartengono a una classe di utenti con accesso, ad esempio se Folder è condiviso con l'intero dominio dell'utente oppure se Folder si trova in un Drive condiviso a cui l'utente può accedere.

Per i file di Drive, l'utente viene rimosso anche dall'elenco degli editor.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da rimuovere.

Invio

Folder: Folder per il concatenamento.

Autorizzazione

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

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

`revokePermissions(emailAddress)`

Revoca l'accesso al Folder concesso all'utente specificato. Questo metodo non impedisce agli utenti di accedere a Folder se appartengono a una classe di utenti che dispongono di accesso generale, ad esempio, se Folder è condiviso con l'intero dominio.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente di cui deve essere revocato l'accesso.

Invio

Folder: Folder, per il concatenamento.

Autorizzazione

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

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

`revokePermissions(user)`

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente di cui deve essere revocato l'accesso.

Invio

Folder: Folder, per il concatenamento.

Autorizzazione

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

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

`searchFiles(params)`

Restituisce una raccolta di tutti i file secondari della cartella corrente e corrispondenti alla ricerca specificata criteri. I criteri di ricerca sono descritti in dettaglio nella documentazione relativa all'SDK Google Drive. Tieni presente che l'interfaccia utilizza la versione 2 dell'API Drive e alcuni campi di query sono diversi dalla versione 3. Esamina il campo e le differenze tra le versioni v2 e v3.

L'argomento params è una stringa di query che può contenere valori di stringa, quindi presta attenzione in modo che le virgolette siano corrette (ad esempio "title contains 'Gulliver\\'s Travels'" o 'title contains "Gulliver\'s Travels"').

// Logs the name of every file that are children of the current folder and modified after February 28,
// 2022 whose name contains "untitled.""
var files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Parametri

Nome	Tipo	Descrizione
`params`	`String`	I criteri di ricerca, come descritto nella documentazione relativa all'SDK Google Drive.

Invio

FileIterator: una raccolta di tutti i file secondari della cartella corrente e che corrispondono alla ricerca criteri.

Autorizzazione

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

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

`searchFolders(params)`

Restituisce una raccolta di tutte le cartelle secondarie della cartella corrente e corrispondenti alla ricerca specificata criteri. I criteri di ricerca sono descritti in dettaglio nella documentazione relativa all'SDK Google Drive. Tieni presente che l'interfaccia utilizza la versione 2 dell'API Drive e alcuni campi di query sono diversi dalla versione 3. Esamina il campo e le differenze tra le versioni v2 e v3.

// Logs the name of every folder that are children of the current folder and you own and is starred.
var folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  console.log(folder.getName());
}

Parametri

Nome	Tipo	Descrizione
`params`	`String`	I criteri di ricerca, come descritto nella documentazione relativa all'SDK Google Drive.

Invio

FolderIterator: una raccolta di tutte le cartelle secondarie della cartella corrente e che corrispondono alla ricerca criteri.

Autorizzazione

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

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

`setDescription(description)`

Consente di impostare la descrizione per Folder.

Parametri

Nome	Tipo	Descrizione
`description`	`String`	la nuova descrizione per `Folder`

Invio

Folder: Folder, per concatenamento

Autorizzazione

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

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

`setName(name)`

Consente di impostare il nome dell'elemento Folder.

Parametri

Nome	Tipo	Descrizione
`name`	`String`	il nuovo nome di `Folder`

Invio

Folder: Folder, per concatenamento

Autorizzazione

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

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

`setOwner(emailAddress)`

Modifica il proprietario di Folder. Questo metodo fornisce anche al proprietario precedente accesso in modifica esplicito al Folder.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente che dovrebbe diventare il nuovo proprietario

Invio

Folder: Folder, per concatenamento

Autorizzazione

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

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

`setOwner(user)`

Modifica il proprietario di Folder. Questo metodo fornisce anche al proprietario precedente accesso in modifica esplicito al Folder.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	una rappresentazione dell'utente che dovrebbe diventare il nuovo proprietario

Invio

Folder: Folder, per concatenamento

Autorizzazione

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

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

`setSecurityUpdateEnabled(enabled)`

Consente di impostare se Folder richiede una chiave risorsa per l'accesso quando condiviso tramite link. I file e le cartelle idonei sono abilitati per impostazione predefinita.

Scopri di più sull'aggiornamento della sicurezza per Google Drive.

Parametri

Nome	Tipo	Descrizione
`enabled`	`Boolean`	Se abilitare il requisito della chiave della risorsa per `Folder`.

Invio

Folder: Folder, per il concatenamento.

Autorizzazione

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

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

`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 per un nuovo Folder è true.

Parametri

Nome	Tipo	Descrizione
`shareable`	`Boolean`	`true` se gli utenti con autorizzazioni di modifica devono essere autorizzati a condividere contenuti con altri utenti o modificarne le autorizzazioni; `false` in caso contrario

Invio

Folder: Folder, per concatenamento

Autorizzazione

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

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

`setSharing(accessType, permissionType)`

Imposta la classe di utenti che può accedere all'Folder e le autorizzazioni a questi utenti, oltre a quelli individuali a cui è stato esplicitamente concesso l'accesso.

// Creates a folder that anyone on the Internet can read from and write to. (Domain
// administrators can prohibit this setting for users of a Google Workspace domain.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parametri

Nome	Tipo	Descrizione
`accessType`	`Access`	quale classe di utenti deve essere in grado di accedere all'`Folder`
`permissionType`	`Permission`	le autorizzazioni che devono essere concesse agli utenti che possono accedere all'`Folder`

Invio

Folder: Folder, per concatenamento

Autorizzazione

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

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

`setStarred(starred)`

Consente di impostare se Folder viene aggiunto a Speciali nel Drive dell'utente. L'impostazione predefinita per i nuovi Folder sono false.

Parametri

Nome	Tipo	Descrizione
`starred`	`Boolean`	`true` se `Folder` deve essere aggiunto a Speciali nella cartella Drive; `false` in caso contrario

Invio

Folder: Folder, per concatenamento

Autorizzazione

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

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

`setTrashed(trashed)`

Consente di impostare se l'elemento Folder si trova nel cestino del Drive dell'utente. Solo il proprietario può spostare nel cestino Folder. Il valore predefinito per i nuovi Folder è false.

Parametri

Nome	Tipo	Descrizione
`trashed`	`Boolean`	`true` se `Folder` deve essere spostato nel cestino di il Drive dell'utente; `false` in caso contrario

Invio

Folder: Folder, per concatenamento

Autorizzazione

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

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

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 cartella principale esistente; un file può avere più di un file principale contemporaneamente.

Parametri

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

Invio

Folder: il nuovo file principale del file aggiunto come 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 la cartella principale esistente; una cartella può avere più elementi padre contemporaneamente.

Parametri

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

Invio

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 può essere visualizzato in Drive se non tramite la ricerca o utilizzando il menu a discesa "Tutti gli elementi" vista.

Parametri

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

Invio

Folder: l'elemento principale precedente dell'account 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 tutte le cartelle principali, non può essere visualizzata in Drive ad eccezione della ricerca o dell'utilizzo della casella di controllo "Tutti gli elementi" vista.

Parametri

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

Invio

Folder: l'elemento principale precedente dell'account secondario.

Autorizzazione

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

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