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.
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 per `Folder`.
`addEditor(user)`	`Folder`	Aggiunge l'utente specificato all'elenco degli editor per `Folder`.
`addEditors(emailAddresses)`	`Folder`	Aggiunge l'array di utenti specificato all'elenco degli editor del `Folder`.
`addViewer(emailAddress)`	`Folder`	Aggiunge l'utente specificato all'elenco degli spettatori di `Folder`.
`addViewer(user)`	`Folder`	Aggiunge l'utente specificato all'elenco degli spettatori di `Folder`.
`addViewers(emailAddresses)`	`Folder`	Aggiunge l'array di utenti specificato all'elenco degli spettatori di `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 il contenuto specificati.
`createFile(name, content, mimeType)`	`File`	Crea un file nella cartella corrente con il nome, il contenuto e il tipo MIME specificati.
`createFolder(name)`	`Folder`	Crea una cartella nella cartella attuale 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 Drive e alla chiave risorsa 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 di `Folder`.
`getDescription()`	`String`	Recupera la descrizione di `Folder`.
`getEditors()`	`User[]`	Recupera l'elenco degli editor per questo `Folder`.
`getFiles()`	`FileIterator`	Recupera una raccolta di tutti i file secondari della cartella corrente.
`getFilesByName(name)`	`FileIterator`	Recupera una raccolta di tutti i file secondari della cartella corrente con il nome specificato.
`getFilesByType(mimeType)`	`FileIterator`	Recupera una raccolta di tutti i file secondari della cartella corrente 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 con il nome specificato.
`getId()`	`String`	Recupera l'ID di `Folder`.
`getLastUpdated()`	`Date`	Recupera la data dell'ultimo aggiornamento di `Folder`.
`getName()`	`String`	Recupera il nome di `Folder`.
`getOwner()`	`User`	Recupera il proprietario di questo `Folder`.
`getParents()`	`FolderIterator`	Recupera una raccolta di cartelle che sono i genitori immediati di `Folder`.
`getResourceKey()`	`String`	Recupera la chiave della risorsa del `Folder` necessaria per accedere agli elementi che sono stati condivisi tramite un link.
`getSecurityUpdateEligible()`	`Boolean`	Indica se questo `Folder` è idoneo per applicare l'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa per l'accesso quando viene condiviso tramite un link.
`getSecurityUpdateEnabled()`	`Boolean`	Indica se questo `Folder` richiede una chiave risorsa per l'accesso quando viene condiviso tramite un link.
`getSharingAccess()`	`Access`	Recupera la classe di utenti che possono accedere a `Folder`, oltre a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso.
`getSharingPermission()`	`Permission`	Recupera l'autorizzazione concessa agli utenti che possono accedere a `Folder`, oltre a tutti gli utenti individuali 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[]`	Recupera l'elenco di visualizzatori e commentatori per questo `Folder`.
`isShareableByEditors()`	`Boolean`	Determina 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 ai preferiti nell'unità Drive dell'utente.
`isTrashed()`	`Boolean`	Determina se `Folder` si trova nel cestino di Drive dell'utente.
`moveTo(destination)`	`Folder`	Sposta l'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 del `Folder`.
`removeViewer(user)`	`Folder`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del `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 di `Folder`.
`setOwner(emailAddress)`	`Folder`	Modifica il proprietario di `Folder`.
`setOwner(user)`	`Folder`	Modifica il proprietario di `Folder`.
`setSecurityUpdateEnabled(enabled)`	`Folder`	Imposta se `Folder` richiede una chiave di risorsa per l'accesso quando viene condiviso tramite un link.
`setShareableByEditors(shareable)`	`Folder`	Determina se gli utenti con autorizzazioni di modifica per `Folder` possono condividere con altri utenti o modificare le autorizzazioni.
`setSharing(accessType, permissionType)`	`Folder`	Definisce la classe di utenti che può accedere a `Folder` e le autorizzazioni concesse a questi utenti, oltre a eventuali singoli utenti a cui è stato concesso esplicitamente l'accesso.
`setStarred(starred)`	`Folder`	Determina se `Folder` è aggiunto ai preferiti nel Drive dell'utente.
`setTrashed(trashed)`	`Folder`	Indica 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 per 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.

Indietro

Folder — This Folder, for chaining.

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, questo metodo lo rimuove dall'elenco.

Parametri

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

Indietro

Folder — This Folder, for chaining.

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 del Folder. Se alcuni utenti erano già presenti nell'elenco degli spettatori, questo metodo li rimuove dall'elenco.

Parametri

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

Indietro

Folder — This Folder, for chaining.

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

Indietro

Folder — This Folder, for chaining.

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

Indietro

Folder — This Folder, for chaining.

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 di Folder. Se alcuni degli utenti erano già presenti nell'elenco degli editor, questo metodo non ha alcun effetto.

Parametri

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

Indietro

Folder — This Folder, for chaining.

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 per il nuovo file.

Indietro

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 il contenuto specificati. Genera un'eccezione se content supera i 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.

Indietro

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, il contenuto 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.

Indietro

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 attuale con il nome specificato.

Parametri

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

Indietro

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.

Indietro

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 Drive e alla chiave risorsa forniti e la restituisce. Una chiave della risorsa è un parametro aggiuntivo che deve essere trasmesso per accedere al file o alla cartella di destinazione che è 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.

Indietro

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 la restituzione delle autorizzazioni per un gruppo Google o delle 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.

Indietro

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 la restituzione delle autorizzazioni per un gruppo Google o delle autorizzazioni ereditate tramite Google Gruppi.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente di cui devono essere controllate le autorizzazioni.

Indietro

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.

Indietro

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.

Indietro

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 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 (const editor of editors) {
  console.log(editor.getName());
}

Indietro

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 secondari della cartella corrente.

Indietro

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 con il nome specificato.

Parametri

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

Indietro

FileIterator: una raccolta di tutti i file secondari della cartella corrente 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)`

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

Indietro

FileIterator: una raccolta di tutti i file figli della cartella corrente 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()`

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

Indietro

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 con il nome specificato.

Parametri

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

Indietro

FolderIterator: una raccolta di tutte le cartelle secondarie della cartella corrente 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.

Indietro

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

Recupera la data dell'ultimo aggiornamento di Folder.

Indietro

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.

Indietro

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

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

Indietro

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 i genitori immediati di Folder.

Indietro

FolderIterator: una raccolta di cartelle che sono i genitori immediati 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 tramite un link.

Indietro

String: la chiave della risorsa 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 applicare l'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa per l'accesso 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.

Indietro

Boolean: indica se il requisito della chiave della risorsa può essere applicato 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

`getSecurityUpdateEnabled()`

Indica se questo Folder richiede una chiave risorsa per l'accesso quando viene condiviso tramite un link. Questo requisito è attivato 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.

Indietro

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

Recupera la classe di utenti che possono accedere a Folder, oltre a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso.

Indietro

Access: quale classe di utenti 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 a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso.

Indietro

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

Restituisce il numero di byte utilizzati per archiviare Folder in Drive. Tieni presente che i file delle applicazioni Google Workspace non vengono conteggiati ai fini dei limiti di spazio di archiviazione di Drive e pertanto restituiscono 0 byte.

Indietro

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.

Indietro

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());
}

Indietro

User[]: l'elenco dei visualizzatori e dei 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 Folder possono condividere con altri utenti o modificare le autorizzazioni.

Indietro

Boolean — true se gli utenti con autorizzazioni di modifica possono 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 nell'unità Drive dell'utente.

Indietro

Boolean: true se Folder è stato aggiunto ai preferiti 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 di Drive dell'utente.

Indietro

Boolean: true se 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 l'elemento nella cartella di destinazione fornita.

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

Parametri

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

Indietro

Folder — This Folder, for chaining.

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 che dispone di 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 dei visualizzatori.

Parametri

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

Indietro

Folder — This Folder, for chaining.

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.

Indietro

Folder — This Folder, for chaining.

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 del Folder. Questo metodo non ha alcun 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 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.

Indietro

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 di visualizzatori e commentatori del Folder. Questo metodo non ha effetto se l'utente è un editor, non un visualizzatore. 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
`user`	`User`	Una rappresentazione dell'utente da rimuovere.

Indietro

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 che hanno accesso generale, ad esempio se Folder è condiviso con l'intero dominio dell'utente.

Parametri

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

Indietro

Folder — This Folder, for chaining.

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 a cui deve essere revocato l'accesso.

Indietro

Folder — This Folder, for chaining.

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 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 differiscono dalla versione 3. Esamina le differenze tra i campi delle versioni 2 e 3.

L'argomento params è una stringa di query che può contenere valori stringa, quindi fai attenzione a eseguire l'escape delle virgolette correttamente (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.

Indietro

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 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 differiscono dalla versione 3. Esamina le differenze tra i campi delle versioni 2 e 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.

Indietro

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 di `Folder`

Indietro

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

Parametri

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

Indietro

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

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

Drive non supporta il cambio di proprietà per gli elementi di proprietà di account gmail.com, ma è supportato per gli account Workspace.

Parametri

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

Indietro

Folder — This Folder, for chaining.

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 concede inoltre al precedente proprietario l'accesso esplicito in modifica a Folder.

Drive non supporta il cambio di proprietà per gli elementi di proprietà di account gmail.com, ma è supportato per gli account Workspace.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente che deve diventare il nuovo proprietario.

Indietro

Folder — This Folder, for chaining.

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 di risorsa per l'accesso quando viene condiviso tramite un 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`.

Indietro

Folder — This Folder, for chaining.

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

Determina 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 con altri utenti o modificare le autorizzazioni; `false` in caso contrario

Indietro

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

Definisce la classe di utenti che può accedere a Folder e le autorizzazioni concesse a questi utenti, oltre a eventuali 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.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parametri

Nome	Tipo	Descrizione
`accessType`	`Access`	quale classe di utenti deve poter accedere a `Folder`
`permissionType`	`Permission`	le autorizzazioni da concedere agli utenti che possono accedere a `Folder`

Indietro

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

Determina se Folder è aggiunto ai preferiti nel Drive dell'utente. Il valore predefinito per i nuovi Folder è false.

Parametri

Nome	Tipo	Descrizione
`starred`	`Boolean`	`true` se `Folder` deve essere aggiunto ai preferiti nel Drive dell'utente; `false` in caso contrario

Indietro

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

Indica se Folder si trova nel cestino di 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 di Drive dell'utente; `false` in caso contrario

Indietro

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 ritirati

`addFile(child)`

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

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

Parametri

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

Indietro

Folder: il nuovo genitore del file aggiunto come figlio.

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

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

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

Parametri

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

Indietro

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

Deprecato. 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 i suoi genitori, non può essere visualizzato in Drive, tranne che tramite ricerca o utilizzando la visualizzazione "Tutti gli elementi".

Parametri

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

Indietro

Folder: il genitore precedente del bambino.

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

Deprecato. 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 sue cartelle principali, non può essere visualizzata in Drive se non cercandola o utilizzando la visualizzazione "Tutti gli elementi".

Parametri

Nome	Tipo	Descrizione
`child`	`Folder`	La cartella del bambino da rimuovere.

Indietro

Folder: il genitore precedente del bambino.

Autorizzazione

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

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

Class Folder Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Metodi

Metodi ritirati

Documentazione dettagliata

addEditor(emailAddress)

Parametri

Indietro

Autorizzazione

addEditor(user)

Parametri

Indietro

Autorizzazione

addEditors(emailAddresses)

Parametri

Indietro

Autorizzazione

addViewer(emailAddress)

Parametri

Indietro

Autorizzazione

addViewer(user)

Parametri

Indietro

Autorizzazione

addViewers(emailAddresses)

Parametri

Indietro

Autorizzazione

createFile(blob)

Parametri

Indietro

Autorizzazione

createFile(name, content)

Parametri

Indietro

Autorizzazione

createFile(name, content, mimeType)

Parametri

Indietro

Autorizzazione

createFolder(name)

Parametri

Indietro

Autorizzazione

createShortcut(targetId)

Parametri

Indietro

Autorizzazione

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

Parametri

Indietro

Autorizzazione

getAccess(email)

Parametri

Indietro

Autorizzazione

getAccess(user)

Parametri

Indietro

Autorizzazione

getDateCreated()

Indietro

Autorizzazione

getDescription()

Indietro

Autorizzazione

getEditors()

Indietro

Autorizzazione

getFiles()

Indietro

Autorizzazione

getFilesByName(name)

Parametri

Indietro

Autorizzazione

getFilesByType(mimeType)

Parametri

Indietro

Autorizzazione

Class Folder

`addEditor(emailAddress)`

`addEditor(user)`

`addEditors(emailAddresses)`

`addViewer(emailAddress)`

`addViewer(user)`

`addViewers(emailAddresses)`

`createFile(blob)`

`createFile(name, content)`

`createFile(name, content, mimeType)`

`createFolder(name)`

`createShortcut(targetId)`

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

`getAccess(email)`

`getAccess(user)`

`getDateCreated()`

`getDescription()`

`getEditors()`

`getFiles()`

`getFilesByName(name)`

`getFilesByType(mimeType)`

`getFolders()`

`getFoldersByName(name)`

`getId()`

`getLastUpdated()`

`getName()`

`getOwner()`

`getParents()`

`getResourceKey()`

`getSecurityUpdateEligible()`

`getSecurityUpdateEnabled()`

`getSharingAccess()`

`getSharingPermission()`

`getSize()`

`getUrl()`

`getViewers()`

`isShareableByEditors()`

`isStarred()`

`isTrashed()`

`moveTo(destination)`

`removeEditor(emailAddress)`

`removeEditor(user)`

`removeViewer(emailAddress)`