Class File

File

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

// Trash every untitled spreadsheet that hasn't been updated in a week.
const files = DriveApp.getFilesByName('Untitled spreadsheet');
while (files.hasNext()) {
  const 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 dei commentatori per File.
addCommenter(user)FileAggiungi l'utente specificato all'elenco dei 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 degli editor di File.
addEditor(user)FileAggiunge l'utente specificato all'elenco degli editor di File.
addEditors(emailAddresses)FileAggiunge l'array di utenti specificato all'elenco degli editor di File.
addViewer(emailAddress)FileAggiunge l'utente specificato all'elenco degli spettatori del File.
addViewer(user)FileAggiunge l'utente specificato all'elenco degli spettatori del File.
addViewers(emailAddresses)FileAggiunge l'array di utenti specificato all'elenco degli spettatori per File.
getAccess(email)PermissionRecupera l'autorizzazione concessa a un utente specifico.
getAccess(user)PermissionRecupera l'autorizzazione concessa a un utente specifico.
getAs(contentType)BlobRestituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato.
getBlob()BlobRestituisce i dati all'interno di questo oggetto come blob.
getDateCreated()DateRecupera la data di creazione del File.
getDescription()StringRecupera la descrizione di File.
getDownloadUrl()StringRecupera l'URL che può essere utilizzato per scaricare il file.
getEditors()User[]Recupera l'elenco degli editor di questo File.
getId()StringRecupera l'ID del File.
getLastUpdated()DateRecupera la data dell'ultimo aggiornamento di File.
getMimeType()StringRecupera il tipo MIME del file.
getName()StringRecupera il nome del File.
getOwner()UserRecupera il proprietario del file.
getParents()FolderIteratorRecupera una raccolta di cartelle che sono le cartelle principali immediate di File.
getResourceKey()StringRecupera la chiave della risorsa del File necessaria per accedere agli elementi che sono stati condivisi utilizzando un link.
getSecurityUpdateEligible()BooleanIndica se questo File è idoneo per l'applicazione dell'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa quando viene condiviso tramite un link.
getSecurityUpdateEnabled()BooleanIndica se questo File richiede una chiave della risorsa per l'accesso quando viene condiviso utilizzando un link.
getSharingAccess()AccessRestituisce la classe di utenti che può accedere al File, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
getSharingPermission()PermissionRecupera l'autorizzazione concessa agli utenti che possono accedere a File, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
getSize()IntegerRecupera il numero di byte utilizzati per archiviare il file 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 della risorsa dell'elemento a cui rimanda.
getThumbnail()BlobRestituisce un'immagine in miniatura del file o null se non esiste alcuna miniatura.
getUrl()StringRecupera l'URL che può essere utilizzato per aprire il File in un'app Google come Drive o Documenti.
getViewers()User[]Recupera l'elenco di visualizzatori e commentatori per questo File.
isShareableByEditors()BooleanDetermina se gli utenti con autorizzazioni di modifica per il File possono condividerlo con altri utenti o modificarne le autorizzazioni.
isStarred()BooleanDetermina se File è stato aggiunto ai preferiti su Drive dell'utente.
isTrashed()BooleanDetermina se File si trova nel cestino di 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 la rinomina con il nome fornito.
makeCopy(name, destination)FileCrea una copia del file nella directory di destinazione e la rinomina con il nome fornito.
moveTo(destination)FileSposta questo elemento nella cartella di destinazione specificata.
removeCommenter(emailAddress)FileRimuove l'utente specificato dall'elenco dei commentatori per il File.
removeCommenter(user)FileRimuove l'utente specificato dall'elenco dei commentatori per il File.
removeEditor(emailAddress)FileRimuove l'utente specificato dall'elenco degli editor di File.
removeEditor(user)FileRimuove l'utente specificato dall'elenco degli editor di File.
removeViewer(emailAddress)FileRimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il File.
removeViewer(user)FileRimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il File.
revokePermissions(emailAddress)FileRevoca l'accesso a File concesso all'utente specificato.
revokePermissions(user)FileRevoca l'accesso a File concesso all'utente specificato.
setContent(content)FileSostituisce i contenuti del file con una determinata sostituzione.
setDescription(description)FileImposta la descrizione per File.
setName(name)FileImposta il nome del File.
setOwner(emailAddress)FileModifica il proprietario del File.
setOwner(user)FileModifica il proprietario del File.
setSecurityUpdateEnabled(enabled)FileImposta se File richiede una chiave della risorsa per l'accesso quando viene condivisa utilizzando un link.
setShareableByEditors(shareable)FileImposta se gli utenti con autorizzazioni di modifica per il File possono condividerlo con altri utenti o modificare le autorizzazioni.
setSharing(accessType, permissionType)FileImposta la classe di utenti che può accedere a File e le autorizzazioni concesse a questi utenti, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
setStarred(starred)FileImposta se File è contrassegnato come preferito in Drive dell'utente.
setTrashed(trashed)FileImposta se File si trova nel cestino di Drive dell'utente.

Documentazione dettagliata

addCommenter(emailAddress)

Aggiungi l'utente specificato all'elenco dei commentatori per File. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco. 

const files = DriveApp.getFilesByName('Test');

// Loops through the files
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter('hello@example.com');
}

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente da aggiungere.

Invio

File: questo File, per l'accodamento.

Autorizzazione

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

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

addCommenter(user)

Aggiungi l'utente specificato all'elenco dei commentatori per File. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco. 

// 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: questo File, per l'accodamento.

Autorizzazione

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

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

addCommenters(emailAddresses)

Aggiungi l'array di utenti specificato all'elenco dei commentatori per File. Se alcuni degli utenti erano già nell'elenco degli spettatori, questo metodo li rimuove dall'elenco. 

// 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: questo File, per l'accodamento.

Autorizzazione

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

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

addEditor(emailAddress)

Aggiunge l'utente specificato all'elenco degli editor di File. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente da aggiungere.

Invio

File: questo File, per l'accodamento.

Autorizzazione

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

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

addEditor(user)

Aggiunge l'utente specificato all'elenco degli editor di File. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente da aggiungere.

Invio

File: questo File, per l'accodamento.

Autorizzazione

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

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

addEditors(emailAddresses)

Aggiunge l'array di utenti specificato all'elenco degli editor di File. Se uno degli utenti faceva già parte dell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.

Parametri

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

Invio

File: questo File, per l'accodamento.

Autorizzazione

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

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

addViewer(emailAddress)

Aggiunge l'utente specificato all'elenco degli spettatori del 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: questo File, per l'accodamento.

Autorizzazione

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

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

addViewer(user)

Aggiunge l'utente specificato all'elenco degli spettatori del 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: questo File, per l'accodamento.

Autorizzazione

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

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

addViewers(emailAddresses)

Aggiunge l'array di utenti specificato all'elenco degli spettatori per File. Se uno degli utenti faceva già parte dell'elenco degli editor, questo metodo non ha alcun effetto su di lui.

Parametri

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

Invio

File: questo File, per l'accodamento.

Autorizzazione

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

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

getAccess(email)

Recupera l'autorizzazione concessa a un utente specifico. Il metodo non supporta il ritorno delle autorizzazioni per un gruppo Google o le autorizzazioni ereditate tramite Google Gruppi.

Parametri

NomeTipoDescrizione
emailStringL'indirizzo email dell'utente di cui devono essere controllate le autorizzazioni. Google Gruppi non è supportato.

Invio

Permission: le autorizzazioni concesse all'utente.

Autorizzazione

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

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

getAccess(user)

Recupera l'autorizzazione concessa a un utente specifico. Il metodo non supporta il ritorno delle autorizzazioni per un gruppo Google o le autorizzazioni ereditate tramite Google Gruppi.

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente di cui devono essere controllate le autorizzazioni.

Invio

Permission: le autorizzazioni concesse all'utente.

Autorizzazione

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

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

getAs(contentType)

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

Per visualizzare le quote giornaliere per le conversioni, consulta Quote per i servizi Google. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a quote più severe.

Parametri

NomeTipoDescrizione
contentTypeStringIl tipo MIME a 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, sono validi anche 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'. Per un documento di Documenti Google, è valido anche 'text/markdown'.

Invio

Blob: i dati come blob.

getBlob()

Restituisce i dati all'interno di questo oggetto come blob.

Invio

Blob: i dati come blob.

getDateCreated()

Recupera la data di creazione del File.

Invio

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

getDescription()

Recupera la descrizione di 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 che dispongono dell'autorizzazione per aprire il file su Google Drive possono accedere all'URL. Puoi utilizzare questo URL in un browser per scaricare il file, ma non per recuperarlo con UrlFetchApp. Se vuoi inserire i contenuti del file nello script, utilizza 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()

Recupera l'elenco degli editor di questo File. Se l'utente che esegue lo script non ha 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 dispone dell'accesso in modifica per questo File, viene restituito l'elenco degli editor. Se l'utente non dispone dell'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 del File.

Invio

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

getLastUpdated()

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

Recupera 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 che sono le cartelle principali immediate di File.

Invio

FolderIterator: una raccolta di cartelle che sono cartelle principali 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 della risorsa del File necessaria per accedere agli elementi che sono stati condivisi utilizzando un link.

Invio

String: la chiave della risorsa 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

getSecurityUpdateEligible()

Indica se questo File è idoneo per l'applicazione dell'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa quando viene condiviso tramite un link.

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

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

Invio

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

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

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

Invio

Boolean: indica se il requisito della chiave della risorsa è abilitato per questo 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()

Restituisce la classe di utenti che può accedere al File, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.

Invio

Access: la classe di utenti che può accedere a 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()

Recupera l'autorizzazione concessa agli utenti che possono accedere a File, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.

Invio

Permission: le autorizzazioni concesse agli utenti che possono accedere a 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 il file File su Drive. Tieni presente che i file delle applicazioni Google Workspace non vengono conteggiati ai fini del calcolo dei limiti di spazio di archiviazione di Drive e quindi restituiscono 0 byte.

Invio

Integer: il numero di byte utilizzati per archiviare il 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 articolo di destinazione.

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

getTargetResourceKey()

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

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: la 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()

Restituisce un'immagine in miniatura del file o null se non esiste alcuna 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 il 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()

Recupera l'elenco di visualizzatori e commentatori per questo File. Se l'utente che esegue lo script non ha 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 (const viewer of viewers) {
    console.log(viewer.getEmail());
  }
}

Invio

User[]: se l'utente dispone dell'accesso in modifica per questo User[], viene restituito l'elenco di visualizzatori e commentatori.File Se l'utente non dispone dell'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()

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

Invio

Boolean - true se gli utenti con autorizzazioni di modifica sono autorizzati a condividere con altri utenti o modificare le autorizzazioni; false in caso contrario

Autorizzazione

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

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

isStarred()

Determina se File è stato aggiunto ai preferiti su Drive dell'utente.

Invio

Boolean - true se File è contrassegnato come preferito in Drive dell'utente; false in caso contrario

Autorizzazione

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

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

isTrashed()

Determina se File si trova nel cestino di Drive dell'utente.

Invio

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

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 la rinomina con 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 del 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 la rinomina con 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 del 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 specificata.

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

Parametri

NomeTipoDescrizione
destinationFolderLa cartella che diventa la nuova cartella principale.

Invio

File: questo File, per l'accodamento.

Autorizzazione

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

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

removeCommenter(emailAddress)

Rimuove l'utente specificato dall'elenco dei commentatori per il 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 dell'utente.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();

  // 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: questo File, per l'accodamento.

Autorizzazione

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

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

removeCommenter(user)

Rimuove l'utente specificato dall'elenco dei commentatori per il 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 dell'utente.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();

  // 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: questo File, per l'accodamento.

Autorizzazione

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

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

removeEditor(emailAddress)

Rimuove l'utente specificato dall'elenco degli editor di 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 è condiviso con l'intero dominio dell'utente 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 spettatori.

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente da rimuovere.

Invio

File: questo File, per l'accodamento.

Autorizzazione

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

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

removeEditor(user)

Rimuove l'utente specificato dall'elenco degli editor di 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 è condiviso con l'intero dominio dell'utente 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 spettatori.

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente da rimuovere.

Invio

File: questo File, per l'accodamento.

Autorizzazione

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

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

removeViewer(emailAddress)

Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il File. Questo metodo non ha alcun effetto se l'utente è un editor, non uno spettatore o un commentatore. Inoltre, questo metodo non impedisce agli utenti di accedere a File se appartengono a una classe di utenti che hanno accesso generale, ad esempio se File è condiviso con l'intero dominio dell'utente 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: questo File per l'accodamento.

Autorizzazione

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

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

removeViewer(user)

Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il File. Questo metodo non ha alcun effetto se l'utente è un editor e non un visualizzatore. Inoltre, questo metodo non impedisce agli utenti di accedere a File se appartengono a una classe di utenti con accesso generale, ad esempio se File è condiviso con l'intero dominio dell'utente 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
userUserUna rappresentazione dell'utente da rimuovere.

Invio

File: questo File per l'accodamento.

Autorizzazione

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

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

revokePermissions(emailAddress)

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

Parametri

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

Invio

File: questo File, per l'accodamento.

Autorizzazione

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

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

revokePermissions(user)

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

Parametri

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

Invio

File: questo File, per l'accodamento.

Autorizzazione

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

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

setContent(content)

Sostituisce i contenuti del file con una determinata sostituzione. Viene lanciata un'eccezione se content è superiore a 10 MB. 

// Creates a text file with the content 'Hello, world!'
const 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 del file.

Invio

File: questo File, per l'accodamento.

Autorizzazione

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

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

setDescription(description)

Imposta la descrizione per File.

Parametri

NomeTipoDescrizione
descriptionStringla nuova descrizione per il File

Invio

File - questo File, per l'accodamento

Autorizzazione

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

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

setName(name)

Imposta il nome del File.

Parametri

NomeTipoDescrizione
nameStringil nuovo nome del File

Invio

File - questo File, per l'accodamento

Autorizzazione

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

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

setOwner(emailAddress)

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

Parametri

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

Invio

File - questo File, per l'accodamento

Autorizzazione

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

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

setOwner(user)

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

Parametri

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

Invio

File - questo File, per l'accodamento

Autorizzazione

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

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

setSecurityUpdateEnabled(enabled)

Imposta se File richiede una chiave della risorsa per l'accesso quando viene condivisa utilizzando un link. I file e le cartelle idonei sono attivati per impostazione predefinita.

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

Parametri

NomeTipoDescrizione
enabledBooleanSe abilitare il requisito della chiave della risorsa per File.

Invio

File: questo File, per l'accodamento.

Autorizzazione

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

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

setShareableByEditors(shareable)

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

Parametri

NomeTipoDescrizione
shareableBooleantrue se gli utenti con autorizzazioni di modifica devono poter condividere con altri utenti o modificare le autorizzazioni; false in caso contrario

Invio

File - questo File, per l'accodamento

Autorizzazione

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

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

setSharing(accessType, permissionType)

Imposta la classe di utenti che può accedere a File e le autorizzazioni concesse a questi utenti, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente. 

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

Parametri

NomeTipoDescrizione
accessTypeAccessLa classe di utenti che deve poter accedere a File
permissionTypePermissionle autorizzazioni che devono essere concesse agli utenti che possono accedere a File

Invio

File - questo File, per l'accodamento

Autorizzazione

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

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

setStarred(starred)

Imposta se File è contrassegnato come preferito in Drive dell'utente. Il valore predefinito per i nuovi File è false.

Parametri

NomeTipoDescrizione
starredBooleantrue se File deve essere contrassegnato come preferito su Drive dell'utente; false in caso contrario

Invio

File - questo File, per l'accodamento

Autorizzazione

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

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

setTrashed(trashed)

Imposta se File si trova nel cestino di Drive dell'utente. Solo il proprietario può eliminare il File. Il valore predefinito per i nuovi File è false.

Parametri

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

Invio

File - questo File, per l'accodamento

Autorizzazione

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

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