Un file su Google Drive. Puoi accedere ai file o crearli da DriveApp
.
// Trash every untitled spreadsheet that hasn't been updated in a week. const files = DriveApp.getFilesByName('Untitled spreadsheet'); while (files.hasNext()) { const file = files.next(); if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) { file.setTrashed(true); } }
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
addCommenter(emailAddress) | File | Aggiungi l'utente specificato all'elenco dei commentatori per File . |
addCommenter(user) | File | Aggiungi l'utente specificato all'elenco dei commentatori per File . |
addCommenters(emailAddresses) | File | Aggiungi l'array di utenti specificato all'elenco dei commentatori per File . |
addEditor(emailAddress) | File | Aggiunge l'utente specificato all'elenco degli editor di File . |
addEditor(user) | File | Aggiunge l'utente specificato all'elenco degli editor di File . |
addEditors(emailAddresses) | File | Aggiunge l'array di utenti specificato all'elenco degli editor di File . |
addViewer(emailAddress) | File | Aggiunge l'utente specificato all'elenco degli spettatori del File . |
addViewer(user) | File | Aggiunge l'utente specificato all'elenco degli spettatori del File . |
addViewers(emailAddresses) | File | Aggiunge l'array di utenti specificato all'elenco degli spettatori per File . |
getAccess(email) | Permission | Recupera l'autorizzazione concessa a un utente specifico. |
getAccess(user) | Permission | Recupera l'autorizzazione concessa a un utente specifico. |
getAs(contentType) | Blob | Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato. |
getBlob() | Blob | Restituisce i dati all'interno di questo oggetto come blob. |
getDateCreated() | Date | Recupera la data di creazione del File . |
getDescription() | String | Recupera la descrizione di File . |
getDownloadUrl() | String | Recupera l'URL che può essere utilizzato per scaricare il file. |
getEditors() | User[] | Recupera l'elenco degli editor di questo File . |
getId() | String | Recupera l'ID del File . |
getLastUpdated() | Date | Recupera la data dell'ultimo aggiornamento di File . |
getMimeType() | String | Recupera il tipo MIME del file. |
getName() | String | Recupera il nome del File . |
getOwner() | User | Recupera il proprietario del file. |
getParents() | FolderIterator | Recupera una raccolta di cartelle che sono le cartelle principali immediate di File . |
getResourceKey() | String | Recupera la chiave della risorsa del File necessaria per accedere agli elementi che sono stati condivisi utilizzando un link. |
getSecurityUpdateEligible() | 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. |
getSecurityUpdateEnabled() | Boolean | Indica se questo File richiede una chiave della risorsa per l'accesso quando viene condiviso utilizzando un link. |
getSharingAccess() | Access | Restituisce la classe di utenti che può accedere al File , oltre ai singoli
utenti a cui è stato concesso l'accesso esplicitamente. |
getSharingPermission() | Permission | Recupera l'autorizzazione concessa agli utenti che possono accedere a File , oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente. |
getSize() | Integer | Recupera il numero di byte utilizzati per archiviare il file File su Drive. |
getTargetId() | String | Se si tratta di una scorciatoia, restituisce l'ID dell'elemento a cui rimanda. |
getTargetMimeType() | String | Se si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui rimanda. |
getTargetResourceKey() | String | Se il file è una scorciatoia, restituisce la chiave della risorsa dell'elemento a cui rimanda. |
getThumbnail() | Blob | Restituisce un'immagine in miniatura del file o null se non esiste alcuna miniatura. |
getUrl() | String | Recupera l'URL che può essere utilizzato per aprire il File in un'app Google come Drive o Documenti. |
getViewers() | User[] | Recupera l'elenco di visualizzatori e commentatori per questo File . |
isShareableByEditors() | Boolean | Determina se gli utenti con autorizzazioni di modifica per il File possono condividerlo con altri utenti o modificarne le autorizzazioni. |
isStarred() | Boolean | Determina se File è stato aggiunto ai preferiti su Drive dell'utente. |
isTrashed() | Boolean | Determina se File si trova nel cestino di Drive dell'utente. |
makeCopy() | File | Crea una copia del file. |
makeCopy(destination) | File | Crea una copia del file nella directory di destinazione. |
makeCopy(name) | File | Crea una copia del file e la rinomina con il nome fornito. |
makeCopy(name, destination) | File | Crea una copia del file nella directory di destinazione e la rinomina con il nome fornito. |
moveTo(destination) | File | Sposta questo elemento nella cartella di destinazione specificata. |
removeCommenter(emailAddress) | File | Rimuove l'utente specificato dall'elenco dei commentatori per il File . |
removeCommenter(user) | File | Rimuove l'utente specificato dall'elenco dei commentatori per il File . |
removeEditor(emailAddress) | File | Rimuove l'utente specificato dall'elenco degli editor di File . |
removeEditor(user) | File | Rimuove l'utente specificato dall'elenco degli editor di File . |
removeViewer(emailAddress) | File | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il File . |
removeViewer(user) | File | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il File . |
revokePermissions(emailAddress) | File | Revoca l'accesso a File concesso all'utente specificato. |
revokePermissions(user) | File | Revoca l'accesso a File concesso all'utente specificato. |
setContent(content) | File | Sostituisce i contenuti del file con una determinata sostituzione. |
setDescription(description) | File | Imposta la descrizione per File . |
setName(name) | File | Imposta il nome del File . |
setOwner(emailAddress) | File | Modifica il proprietario del File . |
setOwner(user) | File | Modifica il proprietario del File . |
setSecurityUpdateEnabled(enabled) | File | Imposta se File richiede una chiave della risorsa per l'accesso quando viene condivisa utilizzando un link. |
setShareableByEditors(shareable) | File | Imposta se gli utenti con autorizzazioni di modifica per il File possono condividerlo con altri utenti o modificare le autorizzazioni. |
setSharing(accessType, permissionType) | 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. |
setStarred(starred) | File | Imposta se File è contrassegnato come preferito in Drive dell'utente. |
setTrashed(trashed) | File | Imposta se File si trova nel cestino di Drive dell'utente. |
Documentazione dettagliata
addCommenter(emailAddress)
Aggiungi l'utente specificato all'elenco dei commentatori per File
. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.
const files = DriveApp.getFilesByName('Test'); // Loops through the files while (files.hasNext()) { const file = files.next(); file.addCommenter('hello@example.com'); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | 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
addCommenter(user)
Aggiungi l'utente specificato all'elenco dei commentatori per File
. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Adds the active user as a commenter. while (files.hasNext()) { const file = files.next(); file.addCommenter(Session.getActiveUser()); }
Parametri
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
addCommenters(emailAddresses)
Aggiungi l'array di utenti specificato all'elenco dei commentatori per File
. Se alcuni degli utenti erano già nell'elenco degli spettatori, questo metodo li rimuove dall'elenco.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); while (files.hasNext()) { const file = files.next(); // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and // 'baklavainthebalkans@gmail.com' with the email addresses to add as // commenters. const emails = [ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]; console.log(file.addCommenters(emails)); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddresses | 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
addEditor(emailAddress)
Aggiunge l'utente specificato all'elenco degli editor di File
. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | 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
addEditor(user)
Aggiunge l'utente specificato all'elenco degli editor di File
. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.
Parametri
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
addEditors(emailAddresses)
Aggiunge l'array di utenti specificato all'elenco degli editor di File
. Se uno degli utenti faceva già parte dell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddresses | 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
addViewer(emailAddress)
Aggiunge l'utente specificato all'elenco degli spettatori del File
. Se l'utente era già nell'elenco degli editor, questo metodo non ha alcun effetto.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | 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
addViewer(user)
Aggiunge l'utente specificato all'elenco degli spettatori del File
. Se l'utente era già nell'elenco degli editor, questo metodo non ha alcun effetto.
Parametri
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
addViewers(emailAddresses)
Aggiunge l'array di utenti specificato all'elenco degli spettatori per File
. Se uno degli utenti faceva già parte dell'elenco degli editor, questo metodo non ha alcun effetto su di lui.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddresses | 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
getAccess(email)
Recupera l'autorizzazione concessa a un utente specifico. Il metodo non supporta il ritorno delle autorizzazioni per un gruppo Google o le autorizzazioni ereditate tramite Google Gruppi.
Parametri
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
getAccess(user)
Recupera l'autorizzazione concessa a un utente specifico. Il metodo non supporta il ritorno delle autorizzazioni per un gruppo Google o le autorizzazioni ereditate tramite Google Gruppi.
Parametri
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
getAs(contentType)
Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato. Questo metodo aggiunge l'estensione appropriata al nome file, ad esempio "myfile.pdf". Tuttavia, assume che la parte del nome file che segue l'ultimo punto (se presente) sia un'estensione esistente che deve essere sostituita. Di conseguenza, "ShoppingList.12.25.2014" diventa "ShoppingList.12.25.pdf".
Per visualizzare le quote giornaliere per le conversioni, consulta Quote per i servizi Google. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a quote più severe.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
contentType | 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.
getBlob()
getDateCreated()
getDescription()
getDownloadUrl()
Recupera l'URL che può essere utilizzato per scaricare il file. Solo gli utenti che dispongono dell'autorizzazione per aprire il file su Google Drive possono accedere all'URL. Puoi utilizzare questo URL in un browser per scaricare il file, ma non per recuperarlo con UrlFetchApp
. Se vuoi inserire i contenuti del
file nello script, utilizza getBlob()
.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the download URLs to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getDownloadUrl()); }
Invio
String
: l'URL che può essere utilizzato per scaricare il file.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getEditors()
Recupera l'elenco degli editor di questo File
. Se l'utente che esegue lo script non ha accesso in modifica a File
, questo metodo restituisce un array vuoto.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Adds the email addresses in the array as editors of each file. // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' // and 'baklavainthebalkans@gmail.com' with valid email addresses. file.addEditors([ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]); // Gets a list of the file editors. const editors = file.getEditors(); // For each file, logs the editors' email addresses to the console. for (const editor of editors) { console.log(editor.getEmail()); } }
Invio
User[]
: se l'utente dispone dell'accesso in modifica per questo File
, viene restituito l'elenco degli editor. Se l'utente non dispone dell'accesso in modifica, restituisce un array vuoto.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getId()
getLastUpdated()
Recupera la data dell'ultimo aggiornamento di File
.
Invio
Date
: la data dell'ultimo aggiornamento di File
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getMimeType()
Recupera il tipo MIME del file.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the MIME type to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getMimeType()); }
Invio
String
: il tipo MIME del file.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getName()
getOwner()
Recupera il proprietario del file.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the names of the file owners to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getOwner().getName()); }
Invio
User
: il proprietario del file.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getParents()
Recupera una raccolta di cartelle che sono le cartelle principali immediate di File
.
Invio
FolderIterator
: una raccolta di cartelle che sono cartelle principali immediate di File
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getResourceKey()
Recupera la chiave della risorsa del File
necessaria per accedere agli elementi che sono stati condivisi utilizzando un link.
Invio
String
: la chiave della risorsa del File
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEligible()
Indica se questo File
è idoneo per l'applicazione dell'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa quando viene condiviso tramite un link.
Drive richiede una chiave della risorsa per accedere ad alcuni file o cartelle condivisi tramite un link. Questa modifica fa parte di un aggiornamento della sicurezza. L'aggiornamento è attivo per impostazione predefinita per i file e le cartelle idonei. Per attivare o disattivare il requisito della chiave della risorsa per i file idonei, utilizza
setSecurityUpdateEnabled
.
Scopri di più sull'aggiornamento della sicurezza per Google Drive.
Invio
Boolean
: indica se il requisito della chiave della risorsa può essere applicato per File
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEnabled()
Indica se questo File
richiede una chiave della risorsa per l'accesso quando viene condiviso utilizzando un link. Questo requisito è attivo per impostazione predefinita per i file e le cartelle idonei.
Per attivare o disattivare il requisito della chiave della risorsa per i file idonei, utilizza
setSecurityUpdateEnabled
.
Scopri di più sull'aggiornamento della sicurezza per Google Drive.
Invio
Boolean
: indica se il requisito della chiave della risorsa è abilitato per questo File
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingAccess()
Restituisce la classe di utenti che può accedere al File
, oltre ai singoli
utenti a cui è stato concesso l'accesso esplicitamente.
Invio
Access
: la classe di utenti che può accedere a File
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingPermission()
Recupera l'autorizzazione concessa agli utenti che possono accedere a File
, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
Invio
Permission
: le autorizzazioni concesse agli utenti che possono accedere a File
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSize()
Recupera il numero di byte utilizzati per archiviare il file File
su Drive. Tieni presente che
i file delle applicazioni Google Workspace non vengono conteggiati ai fini del calcolo dei limiti di spazio di archiviazione di Drive e quindi restituiscono
0
byte.
Invio
Integer
: il numero di byte utilizzati per archiviare il File
su Drive
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getTargetId()
Se si tratta di una scorciatoia, restituisce l'ID dell'elemento a cui rimanda.
In caso contrario, restituisce null
.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the target ID of the shortcut. console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);
Invio
String
: l'ID articolo di destinazione.
getTargetMimeType()
Se si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui rimanda.
In caso contrario, restituisce null
.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the MIME type of the file that the shortcut points to. console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);
Invio
String
: il tipo MIME dell'elemento di destinazione.
getTargetResourceKey()
Se il file è una scorciatoia, restituisce la chiave della risorsa dell'elemento a cui rimanda. Una chiave della risorsa è un parametro aggiuntivo che devi passare per accedere ai file condivisi utilizzando un link.
Se il file non è una scorciatoia, viene restituito null
.
// Gets a file by its ID. // TODO(developer): Replace 'abc123456' with your file ID. const file = DriveApp.getFileById('abc123456'); // If the file is a shortcut, returns the resource key of the file that it // points to. console.log(file.getTargetResourceKey());
Invio
String
: la chiave della risorsa dell'elemento di destinazione o null
se il file non è una scorciatoia.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getThumbnail()
Restituisce un'immagine in miniatura del file o null
se non esiste alcuna miniatura.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Logs the thumbnail image for each file to the console as a blob, // or null if no thumbnail exists. console.log(file.getThumbnail()); }
Invio
Blob
: l'immagine in miniatura del file.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getUrl()
Recupera l'URL che può essere utilizzato per aprire il File
in un'app Google come Drive o Documenti.
Invio
String
: l'URL che può essere utilizzato per visualizzare questo File
in un'app Google come Drive o Documenti
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getViewers()
Recupera l'elenco di visualizzatori e commentatori per questo File
. Se l'utente che esegue lo script non ha accesso in modifica a File
, questo metodo restituisce un array vuoto.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // For each file, logs the viewers' email addresses to the console. const viewers = file.getViewers(); for (const viewer of viewers) { console.log(viewer.getEmail()); } }
Invio
User[]
: se l'utente dispone dell'accesso in modifica per questo User[]
, viene restituito l'elenco di visualizzatori e commentatori.File
Se l'utente non dispone dell'accesso in modifica, restituisce un array vuoto.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isStarred()
Determina se File
è stato aggiunto ai preferiti su Drive dell'utente.
Invio
Boolean
- true
se File
è contrassegnato come preferito in Drive dell'utente; false
in caso contrario
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isTrashed()
Determina se File
si trova nel cestino di Drive dell'utente.
Invio
Boolean
- true
se il File
si trova nel cestino di Drive dell'utente;
false
in caso contrario
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
makeCopy()
Crea una copia del file.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and logs the file name to the console. console.log(file.makeCopy().getName()); }
Invio
File
: la nuova copia.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
makeCopy(destination)
Crea una copia del file nella directory di destinazione.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and adds it to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy(destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Parametri
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
makeCopy(name)
Crea una copia del file e la rinomina con il nome fornito.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and sets the name to 'Test-Copy.' const filename = file.makeCopy('Test-Copy'); // Logs the copied file's name to the console. console.log(filename.getName()); }
Parametri
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
makeCopy(name, destination)
Crea una copia del file nella directory di destinazione e la rinomina con il nome fornito.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file, sets the file name, and adds the copied file // to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy('Test-Copy', destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Parametri
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
moveTo(destination)
Sposta questo elemento nella cartella di destinazione specificata.
Per spostare l'elemento nella cartella di destinazione, l'utente corrente deve essere il proprietario del file o disporre almeno dell'accesso in modifica alla cartella principale corrente dell'elemento.
Parametri
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
removeCommenter(emailAddress)
Rimuove l'utente specificato dall'elenco dei commentatori per il File
. Questo metodo
non impedisce agli utenti di accedere a File
se appartengono a una classe di utenti
che hanno accesso generale, ad esempio se File
è condiviso con l'intero
dominio dell'utente.File
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. // TODO(developer): Replace the email with the email of the user you want to // remove. file.removeCommenter('cloudysanfrancisco@gmail.com'); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | 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
removeCommenter(user)
Rimuove l'utente specificato dall'elenco dei commentatori per il File
. Questo metodo
non impedisce agli utenti di accedere a File
se appartengono a una classe di utenti
che hanno accesso generale, ad esempio se File
è condiviso con l'intero
dominio dell'utente.File
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. console.log(file.removeCommenter(Session.getActiveUser())); }
Parametri
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
removeEditor(emailAddress)
Rimuove l'utente specificato dall'elenco degli editor di File
. Questo metodo non impedisce agli utenti di accedere a File
se appartengono a una classe di utenti con accesso generale, ad esempio se File
è condiviso con l'intero dominio dell'utente o se File
si trova in un Drive condiviso a cui l'utente può accedere.
Per i file di Drive, l'utente viene rimosso anche dall'elenco degli spettatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | 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
removeEditor(user)
Rimuove l'utente specificato dall'elenco degli editor di File
. Questo metodo non impedisce agli utenti di accedere a File
se appartengono a una classe di utenti con accesso generale, ad esempio se File
è condiviso con l'intero dominio dell'utente o se File
si trova in un Drive condiviso a cui l'utente può accedere.
Per i file di Drive, l'utente viene rimosso anche dall'elenco degli spettatori.
Parametri
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
removeViewer(emailAddress)
Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il File
. Questo metodo non ha alcun effetto se l'utente è un editor, non uno spettatore o un commentatore. Inoltre, questo metodo
non impedisce agli utenti di accedere a File
se appartengono a una classe di utenti che
hanno accesso generale, ad esempio se File
è condiviso con l'intero
dominio dell'utente o se File
si trova in un Drive condiviso a cui l'utente può accedere.
Per i file di Drive, l'utente viene rimosso anche dall'elenco degli editor.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | 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
removeViewer(user)
Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per il File
. Questo metodo non ha alcun effetto se l'utente è un editor e non un visualizzatore. Inoltre, questo metodo non impedisce agli utenti di accedere a File
se appartengono a una classe di utenti con accesso generale, ad esempio se File
è condiviso con l'intero dominio dell'utente o se File
si trova in un Drive condiviso a cui l'utente può accedere.
Per i file di Drive, l'utente viene rimosso anche dall'elenco degli editor.
Parametri
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
revokePermissions(emailAddress)
Revoca l'accesso a File
concesso all'utente specificato. Questo metodo non impedisce agli utenti di accedere al File
se appartengono a una classe di utenti che hanno accesso generale, ad esempio se il File
è condiviso con l'intero dominio dell'utente.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | 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
revokePermissions(user)
Revoca l'accesso a File
concesso all'utente specificato. Questo metodo non impedisce agli utenti di accedere al File
se appartengono a una classe di utenti che hanno accesso generale, ad esempio se il File
è condiviso con l'intero dominio dell'utente.
Parametri
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
setContent(content)
Sostituisce i contenuti del file con una determinata sostituzione. Viene lanciata un'eccezione se content
è superiore a 10 MB.
// Creates a text file with the content 'Hello, world!' const file = DriveApp.createFile('New Text File', 'Hello, world!'); // Logs the content of the text file to the console. console.log(file.getBlob().getDataAsString()); // Updates the content of the text file to 'Updated text!' file.setContent('Updated text!'); // Logs content of the text file to the console. console.log(file.getBlob().getDataAsString());
Parametri
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
setDescription(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
setName(name)
setOwner(emailAddress)
Modifica il proprietario del File
. Questo metodo concede inoltre al proprietario precedente accesso in modifica esplicito a File
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | 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
setOwner(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
setSecurityUpdateEnabled(enabled)
Imposta se File
richiede una chiave della risorsa per l'accesso quando viene condivisa utilizzando un link. I file e le cartelle idonei sono attivati per impostazione predefinita.
Scopri di più sull'aggiornamento della sicurezza per Google Drive.
Parametri
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
setSharing(accessType, permissionType)
Imposta la classe di utenti che può accedere a File
e le autorizzazioni concesse a questi utenti, oltre ai singoli utenti a cui è stato concesso l'accesso esplicitamente.
// Creates a folder that anyone on the Internet can read from and write to. // (Domain administrators can prohibit this setting for users of a Google // Workspace domain.) const folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
accessType | Access | La classe di utenti che deve poter accedere a File |
permissionType | 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
setStarred(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
setTrashed(trashed)
Imposta se File
si trova nel cestino di Drive dell'utente. Solo il
proprietario può eliminare il File
. Il valore predefinito per i nuovi File
è false
.
Parametri
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