Un file su Google Drive. È possibile accedere ai file o crearli da Drive.
// 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
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
add | File | Aggiungi l'utente specificato all'elenco dei commentatori per File. |
add | File | Aggiungi l'utente specificato all'elenco dei commentatori per File. |
add | File | Aggiungi l'array di utenti specificato all'elenco dei commentatori per File. |
add | File | Aggiunge l'utente specificato all'elenco degli editor di File. |
add | File | Aggiunge l'utente specificato all'elenco degli editor di File. |
add | File | Aggiunge l'array di utenti specificato all'elenco degli editor di File. |
add | File | Aggiunge l'utente specificato all'elenco degli spettatori del File. |
add | File | Aggiunge l'utente specificato all'elenco degli spettatori del File. |
add | File | Aggiunge l'array di utenti specificato all'elenco degli spettatori per File. |
get | Permission | Recupera l'autorizzazione concessa a un utente specifico. |
get | Permission | Recupera l'autorizzazione concessa a un utente specifico. |
get | Blob | Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato. |
get | Blob | Restituisce i dati all'interno di questo oggetto come blob. |
get | Date | Recupera la data di creazione del File. |
get | String | Recupera la descrizione di File. |
get | String | Recupera l'URL che può essere utilizzato per scaricare il file. |
get | User[] | Recupera l'elenco degli editor di questo File. |
get | String | Recupera l'ID del File. |
get | Date | Recupera la data dell'ultimo aggiornamento di File. |
get | String | Recupera il tipo MIME del file. |
get | String | Recupera il nome del File. |
get | User | Recupera il proprietario del file. |
get | Folder | Recupera una raccolta di cartelle che sono le cartelle principali immediate di File. |
get | String | Recupera la chiave della risorsa del File necessaria per accedere agli elementi che sono stati condivisi utilizzando un link. |
get | Boolean | 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. |
get | Boolean | Indica se questo File richiede una chiave della risorsa per l'accesso quando viene condiviso utilizzando un link. |
get | Access | Restituisce la classe di utenti che può accedere al File, oltre ai singoli
utenti a cui è stato concesso l'accesso esplicitamente. |
get | Permission | Recupera l'autorizzazione concessa agli utenti che possono accedere a File, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente. |
get | Integer | Recupera il numero di byte utilizzati per archiviare il file File su Drive. |
get | String | Se si tratta di una scorciatoia, restituisce l'ID dell'elemento a cui rimanda. |
get | String | Se si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui rimanda. |
get | String | Se il file è una scorciatoia, restituisce la chiave della risorsa dell'elemento a cui rimanda. |
get | Blob | Restituisce un'immagine in miniatura del file o null se non esiste alcuna miniatura. |
get | String | Recupera l'URL che può essere utilizzato per aprire il File in un'app Google come Drive o Documenti. |
get | User[] | Recupera l'elenco di visualizzatori e commentatori per questo File. |
is | Boolean | Determina se gli utenti con autorizzazioni di modifica per il File possono condividerlo con altri utenti o modificarne le autorizzazioni. |
is | Boolean | Determina se File è stato aggiunto ai preferiti su Drive dell'utente. |
is | Boolean | Determina se File si trova nel cestino di Drive dell'utente. |
make | File | Crea una copia del file. |
make | File | Crea una copia del file nella directory di destinazione. |
make | File | Crea una copia del file e la rinomina con il nome fornito. |
make | File | Crea una copia del file nella directory di destinazione e la rinomina con il nome fornito. |
move | File | Sposta questo elemento nella cartella di destinazione specificata. |
remove | File | Rimuove l'utente specificato dall'elenco dei commentatori per il File. |
remove | File | Rimuove l'utente specificato dall'elenco dei commentatori per il File. |
remove | File | Rimuove l'utente specificato dall'elenco degli editor di File. |
remove | File | Rimuove l'utente specificato dall'elenco degli editor di File. |
remove | File | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il File. |
remove | File | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il File. |
revoke | File | Revoca l'accesso a File concesso all'utente specificato. |
revoke | File | Revoca l'accesso a File concesso all'utente specificato. |
set | File | Sostituisce i contenuti del file con una determinata sostituzione. |
set | File | Imposta la descrizione per File. |
set | File | Imposta il nome del File. |
set | File | Modifica il proprietario del File. |
set | File | Modifica il proprietario del File. |
set | File | Imposta se File richiede una chiave della risorsa per l'accesso quando viene condivisa utilizzando un link. |
set | File | Imposta se gli utenti con autorizzazioni di modifica per il File possono condividerlo con altri utenti o modificare le autorizzazioni. |
set | File | 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. |
set | File | Imposta se File è contrassegnato come preferito in Drive dell'utente. |
set | File | Imposta se File si trova nel cestino di Drive dell'utente. |
Documentazione dettagliata
add Commenter(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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'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
add Commenter(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
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | Una 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
add Commenters(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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String[] | 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
add Editor(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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'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
add Editor(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
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | Una 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
add Editors(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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String[] | 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
add Viewer(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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'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
add Viewer(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
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | Una 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
add Viewers(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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String[] | 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
get Access(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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'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
get Access(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
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | Una 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
get As(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
| Nome | Tipo | Descrizione |
|---|---|---|
content | String | Il 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.
get Blob()
get Date Created()
get Description()
get Download Url()
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 Url. Se vuoi inserire i contenuti del
file nello script, utilizza get.
// 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
get Editors()
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
get Id()
get Last Updated()
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
get Mime Type()
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
get Name()
get Owner()
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
get Parents()
Recupera una raccolta di cartelle che sono le cartelle principali immediate di File.
Invio
Folder: 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
get Resource Key()
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
get Security Update Eligible()
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
set.
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
get Security Update Enabled()
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
get Sharing Access()
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
get Sharing Permission()
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
get Size()
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
get Target Id()
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.
get Target Mime Type()
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.
get Target Resource Key()
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
get Thumbnail()
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
get Url()
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
get Viewers()
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
is Starred()
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
is Trashed()
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
make Copy()
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
make Copy(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
| Nome | Tipo | Descrizione |
|---|---|---|
destination | Folder | La 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
make Copy(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
| Nome | Tipo | Descrizione |
|---|---|---|
name | String | Il 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
make Copy(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
| Nome | Tipo | Descrizione |
|---|---|---|
name | String | Il nome del file da applicare alla nuova copia. |
destination | Folder | La 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
move To(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
| Nome | Tipo | Descrizione |
|---|---|---|
destination | Folder | La 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
remove Commenter(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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'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
remove Commenter(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
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | Una 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
remove Editor(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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'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
remove Editor(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
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | Una 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
remove Viewer(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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'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
remove Viewer(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
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | Una 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
revoke Permissions(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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'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
revoke Permissions(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
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | Una 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
set Content(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
| Nome | Tipo | Descrizione |
|---|---|---|
content | String | I 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
set Description(description)
Imposta la descrizione per File.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
description | String | la 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
set Name(name)
set Owner(emailAddress)
Modifica il proprietario del File. Questo metodo concede inoltre al proprietario precedente accesso in modifica esplicito a File.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'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
set Owner(user)
Modifica il proprietario del File. Questo metodo concede inoltre al proprietario precedente accesso in modifica esplicito a File.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | una 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
set Security Update Enabled(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
| Nome | Tipo | Descrizione |
|---|---|---|
enabled | Boolean | Se 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
set Sharing(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
| Nome | Tipo | Descrizione |
|---|---|---|
access | Access | La classe di utenti che deve poter accedere a File |
permission | Permission | le 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
set Starred(starred)
Imposta se File è contrassegnato come preferito in Drive dell'utente. Il valore predefinito per i nuovi File è false.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
starred | Boolean | true 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
set Trashed(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
| Nome | Tipo | Descrizione |
|---|---|---|
trashed | Boolean | true 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