Class Folder

Cartella

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

MetodoTipo restituitoBreve descrizione
addEditor(emailAddress)FolderAggiunge l'utente specificato all'elenco di editor per Folder.
addEditor(user)FolderAggiunge l'utente specificato all'elenco di editor per Folder.
addEditors(emailAddresses)FolderAggiunge l'array di utenti specificato all'elenco di editor per Folder.
addViewer(emailAddress)FolderAggiunge l'utente specificato all'elenco di visualizzatori per Folder.
addViewer(user)FolderAggiunge l'utente specificato all'elenco di visualizzatori per Folder.
addViewers(emailAddresses)FolderAggiunge l'array specificato di utenti all'elenco di visualizzatori per Folder.
createFile(blob)FileCrea un file nella cartella corrente a partire da un determinato Blob di dati arbitrari.
createFile(name, content)FileCrea un file di testo nella cartella corrente con il nome e i contenuti specificati.
createFile(name, content, mimeType)FileCrea un file nella cartella corrente con il nome, i contenuti e il tipo MIME specificati.
createFolder(name)FolderCrea una cartella nella cartella corrente con il nome specificato.
createShortcut(targetId)FileCrea una scorciatoia all'ID elemento di Drive fornito e la restituisce.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileCrea una scorciatoia all'ID elemento di Drive e alla chiave della risorsa forniti e la restituisce.
getAccess(email)PermissionConsente di ottenere l'autorizzazione concessa all'utente specificato.
getAccess(user)PermissionConsente di ottenere l'autorizzazione concessa all'utente specificato.
getDateCreated()DateRecupera la data di creazione di Folder.
getDescription()StringRecupera la descrizione del Folder.
getEditors()User[]Ottiene l'elenco degli editor per questo Folder.
getFiles()FileIteratorRecupera una raccolta di tutti i file secondari della cartella corrente.
getFilesByName(name)FileIteratorRestituisce una raccolta di tutti i file secondari della cartella corrente e con il nome specificato.
getFilesByType(mimeType)FileIteratorRecupera una raccolta di tutti i file secondari della cartella corrente e con il tipo MIME specificato.
getFolders()FolderIteratorRecupera una raccolta di tutte le cartelle secondarie della cartella corrente.
getFoldersByName(name)FolderIteratorRestituisce una raccolta di tutte le cartelle secondarie della cartella corrente e con il nome specificato.
getId()StringRecupera l'ID di Folder.
getLastUpdated()DateOttiene la data dell'ultimo aggiornamento di Folder.
getName()StringOttiene il nome del Folder.
getOwner()UserRecupera il proprietario di questo Folder.
getParents()FolderIteratorRecupera una raccolta di cartelle padre immediate di Folder.
getResourceKey()StringRecupera la chiave risorsa di Folder necessaria per accedere agli elementi che sono stati condivisi tramite link.
getSecurityUpdateEligible()BooleanRiconosce 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()BooleanRiconosce se questo Folder richiede una chiave risorsa per l'accesso quando condiviso tramite link.
getSharingAccess()AccessTrova la classe di utenti che può accedere all'Folder, oltre a qualsiasi individuo agli utenti a cui è stato concesso esplicitamente l'accesso.
getSharingPermission()PermissionConsente di concedere l'autorizzazione agli utenti che possono accedere a Folder, accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
getSize()IntegerRecupera il numero di byte utilizzati per archiviare Folder su Drive.
getUrl()StringRecupera 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()BooleanConsente di stabilire se gli utenti con autorizzazioni di modifica per Folder possono condividere con altri utenti o modificare le autorizzazioni.
isStarred()BooleanDetermina se Folder è stato aggiunto a Speciali nel Drive dell'utente.
isTrashed()BooleanDetermina se l'elemento Folder si trova nel cestino del Drive dell'utente.
moveTo(destination)FolderSposta questo elemento nella cartella di destinazione fornita.
removeEditor(emailAddress)FolderRimuove l'utente specificato dall'elenco degli editor per Folder.
removeEditor(user)FolderRimuove l'utente specificato dall'elenco degli editor per Folder.
removeViewer(emailAddress)FolderRimuove l'utente specificato dall'elenco di visualizzatori e commentatori per Folder.
removeViewer(user)FolderRimuove l'utente specificato dall'elenco di visualizzatori e commentatori per Folder.
revokePermissions(emailAddress)FolderRevoca l'accesso al Folder concesso all'utente specificato.
revokePermissions(user)FolderRevoca l'accesso al Folder concesso all'utente specificato.
searchFiles(params)FileIteratorRestituisce una raccolta di tutti i file secondari della cartella corrente e corrispondenti alla ricerca specificata criteri.
searchFolders(params)FolderIteratorRestituisce una raccolta di tutte le cartelle secondarie della cartella corrente e corrispondenti alla ricerca specificata criteri.
setDescription(description)FolderConsente di impostare la descrizione per Folder.
setName(name)FolderConsente di impostare il nome dell'elemento Folder.
setOwner(emailAddress)FolderModifica il proprietario di Folder.
setOwner(user)FolderModifica il proprietario di Folder.
setSecurityUpdateEnabled(enabled)FolderConsente di impostare se Folder richiede una chiave risorsa per l'accesso quando condiviso tramite link.
setShareableByEditors(shareable)FolderConsente di stabilire se gli utenti con autorizzazioni di modifica per Folder possono condividere con altri utenti o modificare le autorizzazioni.
setSharing(accessType, permissionType)FolderImposta 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)FolderConsente di impostare se Folder viene aggiunto a Speciali nel Drive dell'utente.
setTrashed(trashed)FolderConsente di impostare se l'elemento Folder si trova nel cestino del Drive dell'utente.

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

NomeTipoDescrizione
emailAddressStringL'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

NomeTipoDescrizione
userUserUna 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

NomeTipoDescrizione
emailAddressesString[]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

NomeTipoDescrizione
emailAddressStringL'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

NomeTipoDescrizione
userUserUna 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

NomeTipoDescrizione
emailAddressesString[]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

NomeTipoDescrizione
blobBlobSourceI 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

NomeTipoDescrizione
nameStringIl nome del nuovo file.
contentStringI 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

NomeTipoDescrizione
nameStringIl nome del nuovo file.
contentStringI contenuti del nuovo file.
mimeTypeStringIl 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

NomeTipoDescrizione
nameStringIl 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

NomeTipoDescrizione
targetIdStringL'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

NomeTipoDescrizione
targetIdStringL'ID del file o della cartella di destinazione.
targetResourceKeyStringLa 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

NomeTipoDescrizione
emailStringL'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

NomeTipoDescrizione
userUseruna 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

NomeTipoDescrizione
nameStringIl 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

NomeTipoDescrizione
mimeTypeStringIl 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

NomeTipoDescrizione
nameStringIl 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

NomeTipoDescrizione
destinationFolderLa 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

NomeTipoDescrizione
emailAddressStringL'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)

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

NomeTipoDescrizione
userUserUna 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

NomeTipoDescrizione
emailAddressStringL'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

NomeTipoDescrizione
userUserUna 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

NomeTipoDescrizione
emailAddressStringL'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)

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

NomeTipoDescrizione
userUserUna 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

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

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

NomeTipoDescrizione
paramsStringI 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

NomeTipoDescrizione
descriptionStringla 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

NomeTipoDescrizione
nameStringil 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

NomeTipoDescrizione
emailAddressStringL'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

NomeTipoDescrizione
userUseruna 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

NomeTipoDescrizione
enabledBooleanSe 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

NomeTipoDescrizione
shareableBooleantrue 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

NomeTipoDescrizione
accessTypeAccessquale classe di utenti deve essere in grado di accedere all'Folder
permissionTypePermissionle 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

NomeTipoDescrizione
starredBooleantrue 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

NomeTipoDescrizione
trashedBooleantrue 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