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.
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 specificato di utenti all'elenco di commentatori per File.
addEditor(emailAddress)FileAggiunge l'utente specificato all'elenco degli editor per File.
addEditor(user)FileAggiunge l'utente specificato all'elenco degli editor per File.
addEditors(emailAddresses)FileAggiunge l'array specificato di utenti all'elenco degli editor per File.
addViewer(emailAddress)FileAggiunge l'utente specificato all'elenco dei visualizzatori per File.
addViewer(user)FileAggiunge l'utente specificato all'elenco dei visualizzatori per File.
addViewers(emailAddresses)FileAggiunge l'array specificato di utenti all'elenco dei 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 sotto forma di blob convertito nel tipo di contenuto specificato.
getBlob()BlobRestituisce i dati all'interno di questo oggetto sotto forma di blob.
getDateCreated()DateRecupera la data di creazione di File.
getDescription()StringRecupera la descrizione di File.
getDownloadUrl()StringConsente di acquisire l'URL che può essere utilizzato per scaricare il file.
getEditors()User[]Consente di acquisire l'elenco degli editor di File.
getId()StringRecupera l'ID di File.
getLastUpdated()DateVisualizza la data dell'ultimo aggiornamento di File.
getMimeType()StringRestituisce il tipo MIME del file.
getName()StringRecupera il nome di File.
getOwner()UserOttieni il proprietario del file.
getParents()FolderIteratorRecupera una raccolta di cartelle che sono elementi padre stretti di File.
getResourceKey()StringRecupera la chiave risorsa di File necessaria per accedere agli elementi condivisi utilizzando un link.
getSecurityUpdateEligible()BooleanRiconosce se questo File è idoneo ad applicare l'aggiornamento della sicurezza che richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link.
getSecurityUpdateEnabled()BooleanRiconosce se questo File richiede una chiave della risorsa per l'accesso quando viene condiviso tramite un link.
getSharingAccess()AccessRestituisce la classe di utenti che può accedere a File, oltre a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
getSharingPermission()PermissionOttieni l'autorizzazione concessa agli utenti che possono accedere a File, oltre ai singoli utenti a cui è stato concesso esplicitamente l'accesso.
getSize()IntegerRestituisce il numero di byte utilizzati per archiviare File in 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()BlobRestituisce 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[]Visualizza l'elenco di spettatori e commentatori per File.
isShareableByEditors()BooleanDetermina se gli utenti con autorizzazioni di modifica per File sono autorizzati a condividere contenuti con altri utenti o a modificare le autorizzazioni.
isStarred()BooleanDetermina se File è stato aggiunto a Speciali nel Drive dell'utente.
isTrashed()BooleanDetermina se 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 lo assegna al nome fornito.
makeCopy(name, destination)FileCrea una copia del file nella directory di destinazione e la denomina con il nome fornito.
moveTo(destination)FileSposta questo elemento nella cartella di destinazione fornita.
removeCommenter(emailAddress)FileRimuove l'utente specificato dall'elenco dei commentatori per File.
removeCommenter(user)FileRimuove l'utente specificato dall'elenco dei commentatori 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 dei visualizzatori e commentatori per File.
removeViewer(user)FileRimuove l'utente specificato dall'elenco dei visualizzatori e commentatori per 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)FileSovrascrive il contenuto del file con una determinata sostituzione.
setDescription(description)FileConsente di impostare la descrizione dell'elemento File.
setName(name)FileImposta il nome dell'oggetto File.
setOwner(emailAddress)FileCambia il proprietario di File.
setOwner(user)FileCambia il proprietario di File.
setSecurityUpdateEnabled(enabled)FileConsente di impostare se File richiede una chiave della risorsa per l'accesso quando viene condivisa tramite un 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 a File e le autorizzazioni concesse a tali utenti, oltre ai singoli utenti a cui è stato concesso esplicitamente l'accesso.
setStarred(starred)FileConsente di impostare se l'elemento File viene aggiunto a Speciali nel Drive dell'utente.
setTrashed(trashed)FileConsente di impostare se 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 degli spettatori, utilizza questo metodo per escluderlo.

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

Ritorni

File - Questo 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 degli spettatori, utilizza questo metodo per escluderlo.

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

Ritorni

File - Questo 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 specificato di utenti all'elenco di commentatori per File. Se uno degli utenti era già presente nell'elenco degli spettatori, questo metodo lo promuove fuori dall'elenco degli 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.

Ritorni

File - Questo 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 degli editor per File. Se l'utente era già nell'elenco degli spettatori, scegli questo metodo per escluderlo.

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente da aggiungere.

Ritorni

File - Questo 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 degli editor per File. Se l'utente era già nell'elenco degli spettatori, scegli questo metodo per escluderlo.

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente da aggiungere.

Ritorni

File - Questo 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 specificato di utenti all'elenco degli editor per File. Se uno degli utenti era già presente nell'elenco degli spettatori, questo metodo lo promuove fuori dall'elenco degli spettatori.

Parametri

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

Ritorni

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

Parametri

NomeTipoDescrizione
emailAddressStringL'indirizzo email dell'utente da aggiungere.

Ritorni

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

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente da aggiungere.

Ritorni

File - Questo 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 dei visualizzatori per File. Se qualcuno degli utenti era già presente nell'elenco degli editor, questo metodo non produce alcun effetto.

Parametri

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

Ritorni

File - Questo 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 le cui autorizzazioni devono essere controllate

Ritorni

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 devono essere verificate le autorizzazioni

Ritorni

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 sotto forma di blob convertito nel tipo di contenuto specificato. Questo metodo aggiunge l'estensione appropriata al nome del file, ad esempio "myfile.pdf". Tuttavia, si presuppone che la parte del nome del 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 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, è valido anche qualsiasi formato 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'.

Ritorni

Blob: i dati sotto forma di blob.


getBlob()

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

Ritorni

Blob: i dati sotto forma di blob.


getDateCreated()

Recupera la data di creazione di File.

Ritorni

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

Ritorni

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

Consente di acquisire l'URL che può essere utilizzato per scaricare il file. Solo gli utenti autorizzati ad aprire il file in Google Drive possono accedere all'URL. Puoi utilizzare questo URL in un browser per scaricare il file, ma non puoi utilizzarlo per recuperare il file con UrlFetchApp. Se vuoi che 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());
}

Ritorni

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

Consente di acquisire l'elenco degli editor di 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());
  }
}

Ritorni

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

Ritorni

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

Visualizza la data dell'ultimo aggiornamento di File.

Ritorni

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

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

Ritorni

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

Ritorni

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

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

Ritorni

User: 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 elementi padre stretti di File.

Ritorni

FolderIterator: una raccolta di cartelle che sono elementi principali stretti 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 condivisi utilizzando un link.

Ritorni

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

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

Drive richiede una chiave di 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 delle chiavi delle risorse per i file idonei, utilizza setSecurityUpdateEnabled.

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

Ritorni

Boolean: indica se è possibile applicare il requisito della chiave della risorsa 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 della risorsa per l'accesso quando viene condiviso tramite un link. Questo requisito è attivo per impostazione predefinita per i file e le cartelle idonei. Per attivare o disattivare il requisito delle chiavi delle risorse per i file idonei, utilizza setSecurityUpdateEnabled.

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

Ritorni

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

Ritorni

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

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

Ritorni

Permission: le autorizzazioni concesse agli utenti che possono accedere al 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()

Restituisce il numero di byte utilizzati per archiviare File in Drive. Tieni presente che i file dell'applicazione Google Workspace non vengono conteggiati ai fini dei limiti di spazio di archiviazione di Drive e, pertanto, restituiscono 0 byte.

Ritorni

Integer: il numero di byte utilizzati per archiviare File in Drive

Autorizzazione

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

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

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

Ritorni

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

Ritorni

String: il tipo MIME dell'elemento target.


getTargetResourceKey()

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

Se il file non è una scorciatoia, restituisce 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());

Ritorni

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

Ritorni

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.

Ritorni

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

Visualizza l'elenco di spettatori e commentatori per 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 (viewer of viewers) {
    console.log(viewer.getEmail());
  }
}

Ritorni

User[]: se l'utente ha accesso in modifica a questo File, restituisce l'elenco di visualizzatori 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()

Determina se gli utenti con autorizzazioni di modifica per File sono autorizzati a condividere contenuti con altri utenti o a modificare le autorizzazioni.

Ritorni

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

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.

Ritorni

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 File si trova nel cestino del Drive dell'utente.

Ritorni

Boolean: true se File è 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());
}

Ritorni

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.

Ritorni

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 lo assegna al 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.

Ritorni

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 denomina 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 file da applicare alla nuova copia.
destinationFolderLa directory in cui copiare il file.

Ritorni

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 cartella principale dell'elemento per spostare l'elemento nella cartella di destinazione.

Parametri

NomeTipoDescrizione
destinationFolderLa cartella che diventa la nuova cartella principale.

Ritorni

File - Questo 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 dei commentatori 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 il File è condiviso con l'intero dominio dell'utente.

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

Ritorni

File - Questo 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 dei commentatori 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 il File è condiviso con l'intero dominio dell'utente.

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

Ritorni

File - Questo 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 è condiviso con l'intero dominio dell'utente o se File si trova su 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.

Ritorni

File - Questo 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 è condiviso con l'intero dominio dell'utente o se File si trova su 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.

Ritorni

File - Questo 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 dei visualizzatori e commentatori per File. Questo metodo non ha effetto se l'utente è un editor, non un visualizzatore o un commentatore. Questo metodo non impedisce inoltre 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
emailAddressStringL'indirizzo email dell'utente da rimuovere.

Ritorni

File - Questo 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 dei visualizzatori e commentatori per File. Questo metodo non ha effetto se l'utente è un editor, non un visualizzatore. Questo metodo non impedisce inoltre 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 su 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.

Ritorni

File - Questo 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 a File concesso all'utente specificato. 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.

Parametri

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

Ritorni

File - Questo 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 a File concesso all'utente specificato. 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.

Parametri

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

Ritorni

File - Questo 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 il contenuto 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 del file.

Ritorni

File - Questo 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 dell'elemento File.

Parametri

NomeTipoDescrizione
descriptionStringla nuova descrizione per File

Ritorni

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

setName(name)

Imposta il nome dell'oggetto File.

Parametri

NomeTipoDescrizione
nameStringil nuovo nome di File

Ritorni

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

setOwner(emailAddress)

Cambia il proprietario di File. Questo metodo concede inoltre al proprietario precedente l'accesso in modifica esplicita a File.

Parametri

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

Ritorni

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

setOwner(user)

Cambia il proprietario di File. Questo metodo concede inoltre al proprietario precedente l'accesso in modifica esplicita a File.

Parametri

NomeTipoDescrizione
userUserUna rappresentazione dell'utente che deve diventare il nuovo proprietario.

Ritorni

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

setSecurityUpdateEnabled(enabled)

Consente di impostare se File richiede una chiave della risorsa per l'accesso quando viene condivisa tramite un link. Le cartelle e i file idonei sono attivati per impostazione predefinita.

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

Parametri

NomeTipoDescrizione
enabledBooleanIndica se abilitare il requisito della chiave della risorsa per File.

Ritorni

File - Questo 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 di un nuovo File è true.

Parametri

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

Ritorni

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

setSharing(accessType, permissionType)

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

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

Parametri

NomeTipoDescrizione
accessTypeAccessla classe di utenti che deve essere in grado di accedere al File
permissionTypePermissionle autorizzazioni da concedere agli utenti che possono accedere a File

Ritorni

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

setStarred(starred)

Consente di impostare se l'elemento File viene aggiunto a Speciali nel Drive dell'utente. Il valore predefinito per i nuovi File è false.

Parametri

NomeTipoDescrizione
starredBooleantrue se File deve essere aggiunto a Speciali nel Drive dell'utente; false in caso contrario

Ritorni

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

setTrashed(trashed)

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

Parametri

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

Ritorni

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