Class File

File

Un file su Google Drive. È possibile accedere o creare file da DriveApp. 

// Trash every untitled spreadsheet that hasn't been updated in a week.
var files = DriveApp.getFilesByName('Untitled spreadsheet');
while (files.hasNext()) {
  var file = files.next();
  if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) {
    file.setTrashed(true);
  }
}

Metodi

MetodoTipo restituitoBreve descrizione
addCommenter(emailAddress)FileAggiungi l'utente specificato all'elenco di commentatori per File.
addCommenter(user)FileAggiungi l'utente specificato all'elenco di commentatori per File.
addCommenters(emailAddresses)FileAggiungi l'array di utenti specificato all'elenco dei commentatori per File.
addEditor(emailAddress)FileAggiunge l'utente specificato all'elenco di editor per File.
addEditor(user)FileAggiunge l'utente specificato all'elenco di editor per File.
addEditors(emailAddresses)FileAggiunge l'array di utenti specificato all'elenco di editor per File.
addViewer(emailAddress)FileAggiunge l'utente specificato all'elenco di visualizzatori per File.
addViewer(user)FileAggiunge l'utente specificato all'elenco di visualizzatori per File.
addViewers(emailAddresses)FileAggiunge l'array specificato di utenti all'elenco di visualizzatori per File.
getAccess(email)PermissionConsente di ottenere l'autorizzazione concessa all'utente specificato.
getAccess(user)PermissionConsente di ottenere l'autorizzazione concessa all'utente specificato.
getAs(contentType)BlobRestituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato.
getBlob()BlobRestituisce i dati all'interno dell'oggetto sotto forma di blob.
getDateCreated()DateRecupera la data di creazione di File.
getDescription()StringRecupera la descrizione del File.
getDownloadUrl()StringRecupera l'URL che può essere utilizzato per scaricare il file.
getEditors()User[]Ottiene l'elenco degli editor per questo File.
getId()StringRecupera l'ID di File.
getLastUpdated()DateOttiene la data dell'ultimo aggiornamento di File.
getMimeType()StringRecupera il tipo MIME del file.
getName()StringOttiene il nome del File.
getOwner()UserRecupera il proprietario del file.
getParents()FolderIteratorRecupera una raccolta di cartelle padre immediate di File.
getResourceKey()StringRecupera la chiave risorsa di File necessaria per accedere agli elementi che sono stati condivisi tramite link.
getSecurityUpdateEligible()BooleanRiconosce se il File è idoneo per applicare l'aggiornamento della sicurezza che richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link.
getSecurityUpdateEnabled()BooleanRileverà se questo File richiede una chiave risorsa per l'accesso quando condiviso tramite link.
getSharingAccess()AccessTrova la classe di utenti che può accedere all'File, 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 File, accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
getSize()IntegerRecupera il numero di byte utilizzati per archiviare File su Drive.
getTargetId()StringSe si tratta di una scorciatoia, restituisce l'ID dell'elemento a cui rimanda.
getTargetMimeType()StringSe si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui rimanda.
getTargetResourceKey()StringSe il file è una scorciatoia, restituisce la chiave risorsa dell'elemento a cui rimanda.
getThumbnail()BlobRecupera un'immagine in miniatura per il file o null se non esiste una miniatura.
getUrl()StringRecupera l'URL che può essere utilizzato per aprire File in un'app Google come Drive o Documenti.
getViewers()User[]Consente di acquisire l'elenco di visualizzatori e commentatori di File.
isShareableByEditors()BooleanConsente di stabilire se gli utenti con autorizzazioni di modifica per File possono condividere con altri utenti o modificare le autorizzazioni.
isStarred()BooleanDetermina se File è stato aggiunto a Speciali nel Drive dell'utente.
isTrashed()BooleanDetermina se l'elemento File si trova nel cestino del Drive dell'utente.
makeCopy()FileCrea una copia del file.
makeCopy(destination)FileCrea una copia del file nella directory di destinazione.
makeCopy(name)FileCrea una copia del file e gli assegna il nome fornito.
makeCopy(name, destination)FileCrea una copia del file nella directory di destinazione e le assegna il nome fornito.
moveTo(destination)FileSposta questo elemento nella cartella di destinazione fornita.
removeCommenter(emailAddress)FileRimuove l'utente specificato dall'elenco degli autori di commenti per File.
removeCommenter(user)FileRimuove l'utente specificato dall'elenco degli autori di commenti per File.
removeEditor(emailAddress)FileRimuove l'utente specificato dall'elenco degli editor per File.
removeEditor(user)FileRimuove l'utente specificato dall'elenco degli editor per File.
removeViewer(emailAddress)FileRimuove l'utente specificato dall'elenco di visualizzatori e commentatori per File.
removeViewer(user)FileRimuove l'utente specificato dall'elenco di visualizzatori e commentatori per File.
revokePermissions(emailAddress)FileRevoca l'accesso al File concesso all'utente specificato.
revokePermissions(user)FileRevoca l'accesso al File concesso all'utente specificato.
setContent(content)FileSovrascrive i contenuti del file con una determinata sostituzione.
setDescription(description)FileConsente di impostare la descrizione per File.
setName(name)FileConsente di impostare il nome dell'elemento File.
setOwner(emailAddress)FileModifica il proprietario di File.
setOwner(user)FileModifica il proprietario di File.
setSecurityUpdateEnabled(enabled)FileConsente di impostare se File richiede una chiave risorsa per l'accesso quando condiviso tramite link.
setShareableByEditors(shareable)FileConsente di stabilire se gli utenti con autorizzazioni di modifica per File possono condividere con altri utenti o modificare le autorizzazioni.
setSharing(accessType, permissionType)FileImposta la classe di utenti che può accedere all'File e le autorizzazioni a questi utenti, oltre a quelli individuali a cui è stato esplicitamente concesso l'accesso.
setStarred(starred)FileConsente di impostare se File viene aggiunto a Speciali nel Drive dell'utente.
setTrashed(trashed)FileConsente di impostare se l'elemento File si trova nel cestino del Drive dell'utente.

Documentazione dettagliata

addCommenter(emailAddress)

Aggiungi l'utente specificato all'elenco di commentatori per File. Se l'utente era già presente nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace 'cloudysanfrancisco@gmail.com' with the email address that you
// want to add as a commenter.
while (files.hasNext()) {
  const file = files.next();
  email = 'cloudysanfrancisco@gmail.com';
  console.log(file.addCommenter(email));
}

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente da aggiungere.

Invio

File: File, 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

addCommenter(user)

Aggiungi l'utente specificato all'elenco di commentatori per File. Se l'utente era già presente nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Adds the active user as a commenter.
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter(Session.getActiveUser());
}

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente da aggiungere.

Invio

File: File, 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

addCommenters(emailAddresses)

Aggiungi l'array di utenti specificato all'elenco dei commentatori per File. Se presente utenti erano già presenti nell'elenco dei visualizzatori, questo metodo li promuove dall'elenco dei spettatori. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

while (files.hasNext()) {
  const file = files.next();
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and
  // 'baklavainthebalkans@gmail.com' with the email addresses to add as commenters.
  const emails = ['cloudysanfrancisco@gmail.com','baklavainthebalkans@gmail.com'];
  console.log(file.addCommenters(emails));
}

Parametri

NomeTipoDescrizione
emailAddressesString[]Un array di indirizzi email degli utenti da aggiungere.

Invio

File: File, 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(emailAddress)

Aggiunge l'utente specificato all'elenco di editor per File. 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

File: File, 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 File. 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

File: File, 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 File. 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

File: File, 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 File. 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

File: File, 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 File. Se l'utente era già nell'elenco degli editor, questo metodo non ha alcun effetto.

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente da aggiungere.

Invio

File: File, 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 File. 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

File: File, 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

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

getAs(contentType)

Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. Questo aggiunge l'estensione appropriata al nome del file, ad esempio "miofile.pdf". Tuttavia, presuppone che la parte del nome file che segue l'ultimo punto (se presente) sia una un'estensione che deve essere sostituita. Di conseguenza, "ShoppingList.25.12.2014" diventa "ShoppingList.12.25.pdf".

Per visualizzare le quote giornaliere per le conversioni, consulta Quote per Google Servizi. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a restrizioni quote.

Parametri

NomeTipoDescrizione
contentTypeStringIl tipo MIME in cui eseguire la conversione. Per la maggior parte dei blob, 'application/pdf' è è l'unica opzione valida. Per le immagini in formato BMP, GIF, JPEG o PNG, vengono visualizzati anche i valori 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png' valida. Per un documento di Documenti Google è valido anche 'text/markdown'.

Invio

Blob: i dati come blob.

getBlob()

Restituisce i dati all'interno dell'oggetto sotto forma di blob.

Invio

Blob: i dati come blob.

getDateCreated()

Recupera la data di creazione di File.

Invio

Date: la data di creazione di File

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

Invio

String: la descrizione di File

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

getDownloadUrl()

Recupera l'URL che può essere utilizzato per scaricare il file. Solo gli utenti con l'autorizzazione per aprire il file su Google Drive possono accedere all'URL. Puoi usare questo URL in un browser per scaricare il file, ma non puoi utilizzare per recuperare il file con UrlFetchApp. Se vuoi che i contenuti nello script, usa getBlob(). 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the download URLs to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getDownloadUrl());
}

Invio

String: l'URL che può essere utilizzato per scaricare il file.

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 File. Se l'utente che esegue lo script non dispone dell'accesso in modifica a File, questo metodo restituisce un array vuoto. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Adds the email addresses in the array as editors of each file.
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com'
  // and 'baklavainthebalkans@gmail.com' with valid email addresses.
  file.addEditors(['cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com']);

  // Gets a list of the file editors.
  const editors = file.getEditors();

  // For each file, logs the editors' email addresses to the console.
  for (const editor of editors) {
    console.log(editor.getEmail());
  }
}

Invio

User[]: se l'utente ha accesso in modifica per questo File, restituisce l'elenco di editor. Se l'utente non ha accesso in modifica, restituisce 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

getId()

Recupera l'ID di File.

Invio

String: l'ID di File

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

Invio

Date: la data dell'ultimo aggiornamento di File

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

getMimeType()

Recupera il tipo MIME del file. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the MIME type to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getMimeType());
}

Invio

String: il tipo MIME del file.

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

Invio

String: il nome del File

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the names of the file owners to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getOwner().getName());
}

Invio

User: il proprietario del file.

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

Invio

FolderIterator: una raccolta di cartelle padre immediate di File

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 File necessaria per accedere agli elementi che sono stati condivisi tramite link.

Invio

String: la chiave risorsa del valore File.

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

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

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'File, oltre a qualsiasi individuo agli utenti a cui è stato concesso esplicitamente l'accesso.

Invio

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

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 File, accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.

Invio

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

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

getTargetId()

Se si tratta di una scorciatoia, restituisce l'ID dell'elemento a cui rimanda.

In caso contrario, restituisce null. 

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the target ID of the shortcut.
console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);

Invio

String: l'ID dell'elemento target.

getTargetMimeType()

Se si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui rimanda.

In caso contrario, restituisce null. 

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the MIME type of the file that the shortcut points to.
console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);

Invio

String: il tipo MIME dell'elemento target.

getTargetResourceKey()

Se il file è una scorciatoia, restituisce la chiave risorsa dell'elemento a cui rimanda. Una chiave della risorsa è parametro aggiuntivo che devi passare per accedere ai file condivisi utilizzando .

Se il file non è una scorciatoia, viene restituito null. 

// Gets a file by its ID.
// TODO(developer): Replace 'abc123456' with your file ID.
const file = DriveApp.getFileById('abc123456');

// If the file is a shortcut, returns the resource key of the file that it points to.
console.log(file.getTargetResourceKey());

Invio

String: chiave della risorsa dell'elemento di destinazione o null se il file non è una scorciatoia.

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

getThumbnail()

Recupera un'immagine in miniatura per il file o null se non esiste una miniatura. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Logs the thumbnail image for each file to the console as a blob,
  // or null if no thumbnail exists.
  console.log(file.getThumbnail());
}

Invio

Blob: l'immagine in miniatura del file.

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 File in un'app Google come Drive o Documenti.

Invio

String: l'URL che può essere utilizzato per visualizzare questo File 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 File. Se l'utente Esegue lo script non dispone dell'accesso in modifica a File, questo metodo restituisce un array vuoto. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // For each file, logs the viewers' email addresses to the console.
  const viewers = file.getViewers();
  for (viewer of viewers) {
    console.log(viewer.getEmail());
  }
}

Invio

User[]: se l'utente ha accesso in modifica per questo File, restituisce l'elenco di spettatori e commentatori. Se l'utente non ha accesso in modifica, restituisce 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 File 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 File è stato aggiunto a Speciali nel Drive dell'utente.

Invio

Boolean: true se File è 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 File si trova nel cestino del Drive dell'utente.

Invio

Boolean: true se File 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

makeCopy()

Crea una copia del file. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and logs the file name to the console.
  console.log(file.makeCopy().getName());
}

Invio

File: la nuova copia.

Autorizzazione

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

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

makeCopy(destination)

Crea una copia del file nella directory di destinazione. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and adds it to the specified folder.
  // TODO(developer): Replace the folder ID with your own.
  const destination = DriveApp.getFolderById('123456abcxyz');
  const copiedFile = file.makeCopy(destination);

  // Logs the file names to the console.
  console.log(copiedFile.getName());
}

Parametri

NomeTipoDescrizione
destinationFolderLa directory in cui copiare il file.

Invio

File: la nuova copia.

Autorizzazione

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

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

makeCopy(name)

Crea una copia del file e gli assegna il nome fornito. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and sets the name to 'Test-Copy.'
  const filename = file.makeCopy('Test-Copy');

  // Logs the copied file's name to the console.
  console.log(filename.getName());
}

Parametri

NomeTipoDescrizione
nameStringIl nome file da applicare alla nuova copia.

Invio

File: la nuova copia.

Autorizzazione

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

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

makeCopy(name, destination)

Crea una copia del file nella directory di destinazione e le assegna il nome fornito. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file, sets the file name, and adds the copied file
  // to the specified folder.
  // TODO(developer): Replace the folder ID with your own.
  const destination = DriveApp.getFolderById('123456abcxyz');
  const copiedFile = file.makeCopy('Test-Copy', destination);

  // Logs the file names to the console.
  console.log(copiedFile.getName());
}

Parametri

NomeTipoDescrizione
nameStringIl nome file da applicare alla nuova copia.
destinationFolderLa directory in cui copiare il file.

Invio

File: la nuova copia.

Autorizzazione

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

  • 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

File: File, 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

removeCommenter(emailAddress)

Rimuove l'utente specificato dall'elenco degli autori di commenti per File. Questo metodo non impedisce agli utenti di accedere a File se appartengono a una classe di utenti che hanno accesso generale, ad esempio se File è condiviso con l'intero dominio. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  // TODO(developer): Replace the email with the email of the user you want to remove.
  file.removeCommenter('cloudysanfrancisco@gmail.com');
}

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente da rimuovere.

Invio

File: File, 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

removeCommenter(user)

Rimuove l'utente specificato dall'elenco degli autori di commenti per File. Questo metodo non impedisce agli utenti di accedere a File se appartengono a una classe di utenti che hanno accesso generale, ad esempio se File è condiviso con l'intero dominio. 

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  console.log(file.removeCommenter(Session.getActiveUser()));
}

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente da rimuovere.

Invio

File: File, 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 File. Questo metodo non impedisce agli utenti di accedere a File se appartengono a una classe di utenti con accesso generale, ad esempio se File viene condiviso con l'intera organizzazione dominio o se File 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

File: File, 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 File. Questo metodo non impedisce agli utenti di accedere a File se appartengono a una classe di utenti con accesso generale, ad esempio se File viene condiviso con l'intera organizzazione dominio o se File 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

File: File, 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 File. Questo non ha effetto se l'utente è un editor, non un visualizzatore o un commentatore. Questo metodo non impedisce agli utenti di accedere a File se appartengono a una classe di utenti che dispongono di accesso generale, ad esempio, se File è condiviso con l'intero dominio o se File 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

File: File 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 File. Questo non ha effetto se l'utente è un editor, non un visualizzatore. Inoltre, questo metodo non blocca agli utenti di accedere a File se appartengono a una classe di utenti con accesso, ad esempio se File è condiviso con l'intero dominio dell'utente oppure se File 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

File: File 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 File concesso all'utente specificato. Questo metodo non impedisce agli utenti di accedere a File se appartengono a una classe di utenti che dispongono di accesso generale, ad esempio, se File è condiviso con l'intero dominio.

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente di cui deve essere revocato l'accesso.

Invio

File: File, 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 File concesso all'utente specificato. Questo metodo non impedisce agli utenti di accedere a File se appartengono a una classe di utenti che dispongono di accesso generale, ad esempio, se File è condiviso con l'intero dominio.

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente di cui deve essere revocato l'accesso.

Invio

File: File, 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

setContent(content)

Sovrascrive i contenuti del file con una determinata sostituzione. Genera un'eccezione se content è superiore a 10 MB. 

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

// Logs the content of the text file to the console.
console.log(file.getBlob().getDataAsString());

// Updates the content of the text file to 'Updated text!'
file.setContent('Updated text!')

// Logs content of the text file to the console.
console.log(file.getBlob().getDataAsString());

Parametri

NomeTipoDescrizione
contentStringI nuovi contenuti per il file.

Invio

File: File, 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

setDescription(description)

Consente di impostare la descrizione per File.

Parametri

NomeTipoDescrizione
descriptionStringla nuova descrizione per File

Invio

File: File, 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 File.

Parametri

NomeTipoDescrizione
nameStringil nuovo nome di File

Invio

File: File, 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 File. Questo metodo fornisce anche al proprietario precedente accesso in modifica esplicito al File.

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente che dovrebbe diventare il nuovo proprietario

Invio

File: File, 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 File. Questo metodo fornisce anche al proprietario precedente accesso in modifica esplicito al File.

Parametri

NomeTipoDescrizione
userUseruna rappresentazione dell'utente che dovrebbe diventare il nuovo proprietario

Invio

File: File, 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 File 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 File.

Invio

File: File, 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 File possono condividere con altri utenti o modificare le autorizzazioni. Il valore predefinito per un nuovo File è 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

File: File, 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'File 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'File
permissionTypePermissionle autorizzazioni che devono essere concesse agli utenti che possono accedere all'File

Invio

File: File, 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 File viene aggiunto a Speciali nel Drive dell'utente. L'impostazione predefinita per i nuovi File sono false.

Parametri

NomeTipoDescrizione
starredBooleantrue se File deve essere aggiunto a Speciali nella cartella Drive; false in caso contrario

Invio

File: File, 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 File si trova nel cestino del Drive dell'utente. Solo il proprietario può spostare nel cestino File. Il valore predefinito per i nuovi File è false.

Parametri

NomeTipoDescrizione
trashedBooleantrue se File deve essere spostato nel cestino di il Drive dell'utente; false in caso contrario

Invio

File: File, 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