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 per File. |
add | File | Aggiunge l'utente specificato all'elenco degli editor per File. |
add | File | Aggiunge l'array di utenti specificato all'elenco degli editor del File. |
add | File | Aggiunge l'utente specificato all'elenco degli spettatori di File. |
add | File | Aggiunge l'utente specificato all'elenco degli spettatori di File. |
add | File | Aggiunge l'array di utenti specificato all'elenco dei visualizzatori di 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 di File. |
get | String | Recupera la descrizione di File. |
get | String | Restituisce l'URL che può essere utilizzato per scaricare il file. |
get | User[] | Recupera l'elenco degli editor per questo File. |
get | String | Recupera l'ID di File. |
get | Date | Recupera la data dell'ultimo aggiornamento di File. |
get | String | Recupera il tipo MIME del file. |
get | String | Recupera il nome di File. |
get | User | Recupera il proprietario del file. |
get | Folder | Recupera una raccolta di cartelle che sono i genitori immediati di File. |
get | String | Recupera la chiave della risorsa del File necessaria per accedere agli elementi
che sono stati condivisi tramite un link. |
get | Boolean | Indica se questo File è idoneo per applicare l'aggiornamento della sicurezza che
richiede una chiave di accesso alla risorsa per l'accesso quando viene condiviso tramite un link. |
get | Boolean | Indica se questo File richiede una chiave risorsa per l'accesso quando viene
condiviso tramite un link. |
get | Access | Recupera la classe di utenti che possono accedere a File, oltre a tutti gli utenti
individuali a cui è stato concesso esplicitamente l'accesso. |
get | Permission | Recupera l'autorizzazione concessa agli utenti che possono accedere a File,
oltre a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso. |
get | Integer | Restituisce il numero di byte utilizzati per archiviare File in Drive. |
get | String | Se si tratta di una scorciatoia, restituisce l'ID dell'elemento a cui punta. |
get | String | Se si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui punta. |
get | String | Se il file è una scorciatoia, restituisce la chiave della risorsa dell'elemento a cui punta. |
get | Blob|null | Recupera un'immagine miniatura per il file o null se non esiste alcuna miniatura. |
get | String | Recupera l'URL che può essere utilizzato per aprire 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 File possono
condividere con altri utenti o modificare le autorizzazioni. |
is | Boolean | Determina se File è stato aggiunto ai preferiti nell'unità 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 denomina con il nome fornito. |
make | File | Crea una copia del file nella directory di destinazione e la denomina con il nome fornito. |
move | File | Sposta l'elemento nella cartella di destinazione fornita. |
remove | File | Rimuove l'utente specificato dall'elenco dei commentatori per File. |
remove | File | Rimuove l'utente specificato dall'elenco dei commentatori per File. |
remove | File | Rimuove l'utente specificato dall'elenco degli editor per File. |
remove | File | Rimuove l'utente specificato dall'elenco degli editor per File. |
remove | File | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del File. |
remove | File | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del 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 | Sovrascrive i contenuti del file con una sostituzione specificata. |
set | File | Imposta la descrizione per File. |
set | File | Imposta il nome di File. |
set | File | Modifica il proprietario di File. |
set | File | Modifica il proprietario di File. |
set | File | Imposta se File richiede una chiave risorsa per l'accesso quando viene
condiviso tramite un link. |
set | File | Determina se gli utenti con autorizzazioni di modifica per File possono condividere
con altri utenti o modificare le autorizzazioni. |
set | File | Definisce la classe di utenti che può accedere a File e le autorizzazioni
concesse a questi utenti, oltre a eventuali singoli utenti a cui è stato concesso esplicitamente l'accesso. |
set | File | Determina se File è aggiunto ai preferiti nel Drive dell'utente. |
set | File | Indica 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à presente 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. |
Indietro
File — This File, for chaining.
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à presente 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. |
Indietro
File — This File, for chaining.
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à presenti nell'elenco degli spettatori, questo metodo li rimuove 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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Indietro
File — This File, for chaining.
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 per 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. |
Indietro
File — This File, for chaining.
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 per 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. |
Indietro
File — This File, for chaining.
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 del File. Se alcuni utenti erano già presenti nell'elenco degli spettatori, questo metodo li rimuove dall'elenco.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
email | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Indietro
File — This File, for chaining.
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 di File. Se l'utente era già
nell'elenco degli editor, questo metodo non ha effetto.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'indirizzo email dell'utente da aggiungere. |
Indietro
File — This File, for chaining.
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 di File. Se l'utente era già
nell'elenco degli editor, questo metodo non ha effetto.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | Una rappresentazione dell'utente da aggiungere. |
Indietro
File — This File, for chaining.
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 dei visualizzatori di File. Se alcuni degli
utenti erano già presenti nell'elenco degli editor, questo metodo non ha alcun effetto.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
email | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Indietro
File — This File, for chaining.
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 la restituzione delle autorizzazioni per un gruppo Google o delle 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. |
Indietro
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 la restituzione delle autorizzazioni per un gruppo Google o delle autorizzazioni ereditate tramite Google Gruppi.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | Una rappresentazione dell'utente di cui devono essere controllate le autorizzazioni. |
Indietro
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, presuppone 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ù rigide.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
content | String | Il 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, sono validi anche 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'. Per un documento Google, è valido anche 'text/markdown'. |
Indietro
Blob: i dati come blob.
get Blob()
get Date Created()
get Description()
get Download Url()
Restituisce l'URL che può essere utilizzato per scaricare il file. Solo gli utenti con l'autorizzazione 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 Url. Se vuoi che i contenuti del
file siano 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()); }
Indietro
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 per questo File. Se l'utente che esegue lo script
non dispone dell'accesso in modifica a File, questo metodo restituisce un array vuoto.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Adds the email addresses in the array as editors of each file. // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' // and 'baklavainthebalkans@gmail.com' with valid email addresses. file.addEditors([ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]); // Gets a list of the file editors. const editors = file.getEditors(); // For each file, logs the editors' email addresses to the console. for (const editor of editors) { console.log(editor.getEmail()); } }
Indietro
User[]: se l'utente dispone dell'accesso in modifica per questo File, restituisce 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.
Indietro
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()); }
Indietro
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()); }
Indietro
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 i genitori immediati di File.
Indietro
Folder: una raccolta di cartelle che sono i genitori immediati 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 tramite un link.
Indietro
String: la chiave della risorsa 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 Security Update Eligible()
Indica se questo File è idoneo per applicare l'aggiornamento della sicurezza che
richiede una chiave di accesso alla risorsa per l'accesso 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 risorsa per i file idonei, utilizza
set.
Scopri di più sull'aggiornamento della sicurezza per Google Drive.
Indietro
Boolean: indica se il requisito della chiave della risorsa può essere applicato 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 Security Update Enabled()
Indica se questo File richiede una chiave 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 della chiave della risorsa per i file idonei, utilizza
setSecurityUpdateEnabled.
Scopri di più sull'aggiornamento della sicurezza per Google Drive.
Indietro
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()
Recupera la classe di utenti che possono accedere a File, oltre a tutti gli utenti
individuali a cui è stato concesso esplicitamente l'accesso.
Indietro
Access: quale classe di utenti 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 a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso.
Indietro
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()
Restituisce il numero di byte utilizzati per archiviare File in Drive. Tieni presente che
i file delle applicazioni Google Workspace non vengono conteggiati ai fini dei limiti di spazio di archiviazione di Drive e pertanto restituiscono
0 byte.
Indietro
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
get Target Id()
Se si tratta di una scorciatoia, restituisce l'ID dell'elemento a cui punta.
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()}`);
Indietro
String: l'ID articolo di destinazione.
get Target Mime Type()
Se si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui punta.
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()}`);
Indietro
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 punta. Una chiave risorsa è un parametro aggiuntivo che devi trasmettere per accedere ai file condivisi tramite 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());
Indietro
String: la chiave di 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()
Recupera un'immagine miniatura per il 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()); }
Indietro
Blob|null: l'immagine 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 File in un'app Google come
Drive o Documenti.
Indietro
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 dispone dell'accesso in modifica a File, questo metodo
restituisce un array vuoto.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // For each file, logs the viewers' email addresses to the console. const viewers = file.getViewers(); for (const viewer of viewers) { console.log(viewer.getEmail()); } }
Indietro
User[]: se l'utente dispone dell'accesso in modifica per questo File, restituisce l'elenco di
visualizzatori e commentatori. 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 nell'unità Drive dell'utente.
Indietro
Boolean: true se File è stato aggiunto ai preferiti 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
is Trashed()
Determina se File si trova nel cestino di Drive dell'utente.
Indietro
Boolean: true se 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()); }
Indietro
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. |
Indietro
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 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 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. |
Indietro
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 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
| Nome | Tipo | Descrizione |
|---|---|---|
name | String | Il nome del file da applicare alla nuova copia. |
destination | Folder | La directory in cui copiare il file. |
Indietro
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 l'elemento nella cartella di destinazione fornita.
L'utente attuale deve essere il proprietario del file o disporre almeno dell'accesso in modifica alla cartella principale attuale dell'elemento per poterlo spostare nella cartella di destinazione.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
destination | Folder | La cartella che diventa la nuova cartella principale. |
Indietro
File — This File, for chaining.
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 File. Questo metodo
non impedisce agli utenti di accedere a File se appartengono a una classe di utenti
che dispongono dell'accesso generale, ad esempio se 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
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'indirizzo email dell'utente da rimuovere. |
Indietro
File — This File, for chaining.
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 File. Questo metodo
non impedisce agli utenti di accedere a File se appartengono a una classe di utenti
che dispongono dell'accesso generale, ad esempio se 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
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | Una rappresentazione dell'utente da rimuovere. |
Indietro
File — This File, for chaining.
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 per File. Questo metodo non
impedisce agli utenti di accedere a File se appartengono a una classe di utenti che dispone di
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 dei visualizzatori.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'indirizzo email dell'utente da rimuovere. |
Indietro
File — This File, for chaining.
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 per File. Questo metodo non
impedisce agli utenti di accedere a File se appartengono a una classe di utenti che dispone di
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 dei visualizzatori.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | Una rappresentazione dell'utente da rimuovere. |
Indietro
File — This File, for chaining.
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 del File. Questo
metodo non ha alcun 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 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. |
Indietro
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
remove Viewer(user)
Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del File. Questo metodo non ha effetto se l'utente è un editor, non un visualizzatore. 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 |
|---|---|---|
user | User | Una rappresentazione dell'utente da rimuovere. |
Indietro
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
revoke Permissions(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 che
hanno accesso generale, ad esempio se File è condiviso con l'intero
dominio dell'utente.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | L'indirizzo email dell'utente il cui accesso deve essere revocato. |
Indietro
File — This File, for chaining.
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 a File se appartengono a una classe di utenti che
hanno accesso generale, ad esempio se 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. |
Indietro
File — This File, for chaining.
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)
Sovrascrive i contenuti del file con una sostituzione specificata. Genera 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. |
Indietro
File — This File, for chaining.
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 di File |
Indietro
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
set Name(name)
set Owner(emailAddress)
Modifica il proprietario di File. Questo metodo concede inoltre al precedente proprietario
l'accesso esplicito in modifica a File.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
email | String | l'indirizzo email dell'utente che deve diventare il nuovo proprietario |
Indietro
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
set Owner(user)
Modifica il proprietario di File. Questo metodo concede inoltre al precedente proprietario
l'accesso esplicito in modifica a File.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
user | User | una rappresentazione dell'utente che deve diventare il nuovo proprietario |
Indietro
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
set Security Update Enabled(enabled)
Imposta se File richiede una chiave risorsa per l'accesso quando viene
condiviso tramite un link. I file e le cartelle idonei sono abilitati 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. |
Indietro
File — This File, for chaining.
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)
Definisce la classe di utenti che può accedere a File e le autorizzazioni
concesse a questi utenti, oltre a eventuali 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.) const folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
access | Access | quale classe di utenti deve poter accedere a File |
permission | Permission | le autorizzazioni da concedere agli utenti che possono accedere a File |
Indietro
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
set Starred(starred)
Determina se File è aggiunto ai preferiti nel Drive dell'utente. Il valore predefinito per
i nuovi File è false.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
starred | Boolean | true se File deve essere aggiunto ai preferiti nel Drive dell'utente; false in caso contrario |
Indietro
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
set Trashed(trashed)
Indica se File si trova nel cestino di Drive dell'utente. Solo il
proprietario può spostare File nel cestino. 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 |
Indietro
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