Un file su Google Drive. È possibile accedere o creare file da DriveApp
.
// Trash every untitled spreadsheet that hasn't been updated in a week. var files = DriveApp.getFilesByName('Untitled spreadsheet'); while (files.hasNext()) { var file = files.next(); if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) { file.setTrashed(true); } }
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
addCommenter(emailAddress) | File | Aggiungi l'utente specificato all'elenco di commentatori per File . |
addCommenter(user) | File | Aggiungi l'utente specificato all'elenco di 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 di editor per File . |
addEditor(user) | File | Aggiunge l'utente specificato all'elenco di editor per File . |
addEditors(emailAddresses) | File | Aggiunge l'array di utenti specificato all'elenco di editor per File . |
addViewer(emailAddress) | File | Aggiunge l'utente specificato all'elenco di visualizzatori per File . |
addViewer(user) | File | Aggiunge l'utente specificato all'elenco di visualizzatori per File . |
addViewers(emailAddresses) | File | Aggiunge l'array specificato di utenti all'elenco di visualizzatori per File . |
getAccess(email) | Permission | Consente di ottenere l'autorizzazione concessa all'utente specificato. |
getAccess(user) | Permission | Consente di ottenere l'autorizzazione concessa all'utente specificato. |
getAs(contentType) | Blob | Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. |
getBlob() | Blob | Restituisce i dati all'interno dell'oggetto sotto forma di blob. |
getDateCreated() | Date | Recupera la data di creazione di File . |
getDescription() | String | Recupera la descrizione del File . |
getDownloadUrl() | String | Recupera l'URL che può essere utilizzato per scaricare il file. |
getEditors() | User[] | Ottiene l'elenco degli editor per questo File . |
getId() | String | Recupera l'ID di File . |
getLastUpdated() | Date | Ottiene la data dell'ultimo aggiornamento di File . |
getMimeType() | String | Recupera il tipo MIME del file. |
getName() | String | Ottiene il nome del File . |
getOwner() | User | Recupera il proprietario del file. |
getParents() | FolderIterator | Recupera una raccolta di cartelle padre immediate di File . |
getResourceKey() | String | Recupera la chiave risorsa di File necessaria per accedere agli elementi che
sono stati condivisi tramite link. |
getSecurityUpdateEligible() | Boolean | Riconosce se il File è idoneo per applicare l'aggiornamento della sicurezza che
richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link. |
getSecurityUpdateEnabled() | Boolean | Riconosce se questo File richiede una chiave risorsa per l'accesso quando
condiviso tramite link. |
getSharingAccess() | Access | Trova la classe di utenti che può accedere all'File , oltre a qualsiasi individuo
agli utenti a cui è stato concesso esplicitamente l'accesso. |
getSharingPermission() | Permission | Consente di concedere l'autorizzazione agli utenti che possono accedere a File ,
accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso. |
getSize() | Integer | Recupera il numero di byte utilizzati per archiviare 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 risorsa dell'elemento a cui rimanda. |
getThumbnail() | Blob | Recupera un'immagine in miniatura per il file o null se non esiste una miniatura. |
getUrl() | String | Recupera l'URL che può essere utilizzato per aprire File in un'app Google come
Drive o Documenti. |
getViewers() | User[] | Consente di acquisire l'elenco di visualizzatori e commentatori di File . |
isShareableByEditors() | Boolean | Consente di stabilire se gli utenti con autorizzazioni di modifica per File possono
condividere con altri utenti o modificare le autorizzazioni. |
isStarred() | Boolean | Determina se File è stato aggiunto a Speciali nel Drive dell'utente. |
isTrashed() | Boolean | Determina se l'elemento File si trova nel cestino del 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 gli assegna il nome fornito. |
makeCopy(name, destination) | File | Crea una copia del file nella directory di destinazione e le assegna il nome fornito. |
moveTo(destination) | File | Sposta questo elemento nella cartella di destinazione fornita. |
removeCommenter(emailAddress) | File | Rimuove l'utente specificato dall'elenco degli autori di commenti per File . |
removeCommenter(user) | File | Rimuove l'utente specificato dall'elenco degli autori di commenti per File . |
removeEditor(emailAddress) | File | Rimuove l'utente specificato dall'elenco degli editor per File . |
removeEditor(user) | File | Rimuove l'utente specificato dall'elenco degli editor per File . |
removeViewer(emailAddress) | File | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per File . |
removeViewer(user) | File | Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per File . |
revokePermissions(emailAddress) | File | Revoca l'accesso al File concesso all'utente specificato. |
revokePermissions(user) | File | Revoca l'accesso al File concesso all'utente specificato. |
setContent(content) | File | Sovrascrive i contenuti del file con una determinata sostituzione. |
setDescription(description) | File | Consente di impostare la descrizione per File . |
setName(name) | File | Consente di impostare il nome dell'elemento File . |
setOwner(emailAddress) | File | Modifica il proprietario di File . |
setOwner(user) | File | Modifica il proprietario di File . |
setSecurityUpdateEnabled(enabled) | File | Consente di impostare se File richiede una chiave risorsa per l'accesso quando
condiviso tramite link. |
setShareableByEditors(shareable) | File | Consente di stabilire se gli utenti con autorizzazioni di modifica per File possono condividere
con altri utenti o modificare le autorizzazioni. |
setSharing(accessType, permissionType) | File | Imposta la classe di utenti che può accedere all'File e le autorizzazioni
a questi utenti, oltre a quelli individuali a cui è stato esplicitamente concesso l'accesso. |
setStarred(starred) | File | Consente di impostare se File viene aggiunto a Speciali nel Drive dell'utente. |
setTrashed(trashed) | File | Consente di impostare se l'elemento File si trova nel cestino del Drive dell'utente. |
Documentazione dettagliata
addCommenter(emailAddress)
Aggiungi l'utente specificato all'elenco di commentatori per File
. Se l'utente era
già presente nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' with the email address that you // want to add as a commenter. while (files.hasNext()) { const file = files.next(); email = 'cloudysanfrancisco@gmail.com'; console.log(file.addCommenter(email)); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da aggiungere. |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addCommenter(user)
Aggiungi l'utente specificato all'elenco di commentatori per File
. Se l'utente era
già presente nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori.
// 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
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addCommenters(emailAddresses)
Aggiungi l'array di utenti specificato all'elenco dei commentatori per File
. Se presente
utenti erano già presenti nell'elenco dei visualizzatori, questo metodo li promuove dall'elenco dei
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 |
---|---|---|
emailAddresses | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addEditor(emailAddress)
Aggiunge l'utente specificato all'elenco di editor per File
. Se l'utente era già
nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da aggiungere. |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addEditor(user)
Aggiunge l'utente specificato all'elenco di editor per File
. Se l'utente era già
nell'elenco dei visualizzatori, questo metodo promuove l'utente all'esterno dell'elenco dei visualizzatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente da aggiungere. |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addEditors(emailAddresses)
Aggiunge l'array di utenti specificato all'elenco di editor per File
. Se uno dei
utenti erano già presenti nell'elenco dei visualizzatori, questo metodo li promuove dall'elenco dei
spettatori.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddresses | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addViewer(emailAddress)
Aggiunge l'utente specificato all'elenco di visualizzatori per 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
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addViewer(user)
Aggiunge l'utente specificato all'elenco di visualizzatori per 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
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
addViewers(emailAddresses)
Aggiunge l'array specificato di utenti all'elenco di visualizzatori per File
. Se uno dei
utenti erano già presenti nell'elenco degli editor, questo metodo non ha alcun effetto su di loro.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddresses | String[] | Un array di indirizzi email degli utenti da aggiungere. |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
getAccess(email)
Consente di ottenere l'autorizzazione concessa all'utente specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
email | String | L'indirizzo email dell'utente di cui è necessario verificare 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
getAccess(user)
Consente di ottenere l'autorizzazione concessa all'utente specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | una rappresentazione dell'utente di cui è necessario verificare 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 contenuto specificato. Questo aggiunge l'estensione appropriata al nome del file, ad esempio "miofile.pdf". Tuttavia, presuppone che la parte del nome file che segue l'ultimo punto (se presente) sia una un'estensione che deve essere sostituita. Di conseguenza, "ShoppingList.25.12.2014" diventa "ShoppingList.12.25.pdf".
Per visualizzare le quote giornaliere per le conversioni, consulta Quote per Google Servizi. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a restrizioni quote.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
contentType | 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, vengono visualizzati anche i valori 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png'
valida. 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 con l'autorizzazione per aprire il file
su Google Drive possono accedere all'URL. Puoi usare questo URL in un browser per scaricare il file, ma
non puoi utilizzare per recuperare il file con UrlFetchApp
. Se vuoi che i contenuti
nello script, usa 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()
Ottiene 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()); } }
Invio
User[]
: se l'utente ha accesso in modifica per questo File
, restituisce l'elenco di
editor. Se l'utente non ha accesso in modifica, restituisce un array vuoto.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getId()
getLastUpdated()
Ottiene 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 padre immediate di File
.
Invio
FolderIterator
: una raccolta di cartelle padre 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 risorsa di File
necessaria per accedere agli elementi che
sono stati condivisi tramite link.
Invio
String
: la chiave risorsa del valore File
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEligible()
Riconosce se il File
è idoneo per applicare l'aggiornamento della sicurezza che
richiede una chiave della risorsa per l'accesso quando viene condivisa tramite link.
Drive richiede una chiave della risorsa per accedere ad alcuni file o cartelle che sono stati condivisi utilizzando un
. Questa modifica fa parte di un aggiornamento della sicurezza. L'aggiornamento è attivo per impostazione predefinita per i contenuti
e cartelle. 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()
Riconosce se questo File
richiede una chiave risorsa per l'accesso quando
condiviso tramite 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()
Trova la classe di utenti che può accedere all'File
, oltre a qualsiasi individuo
agli utenti a cui è stato concesso esplicitamente l'accesso.
Invio
Access
: la classe di utenti che può accedere all'app 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()
Consente di concedere l'autorizzazione agli utenti che possono accedere a File
,
accanto a ogni singolo utente a cui è stato esplicitamente concesso l'accesso.
Invio
Permission
: le autorizzazioni concesse agli utenti che possono accedere all'app 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 File
su Drive. Tieni presente che
I file dell'applicazione Google Workspace non concorrono al raggiungimento dei limiti di spazio di archiviazione di Drive e quindi vengono restituiti
0
byte.
Invio
Integer
: il numero di byte utilizzati per archiviare 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 dell'elemento target.
getTargetMimeType()
Se si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui rimanda.
In caso contrario, restituisce null
.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the MIME type of the file that the shortcut points to. console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);
Invio
String
: il tipo MIME dell'elemento target.
getTargetResourceKey()
Se il file è una scorciatoia, restituisce la chiave risorsa dell'elemento a cui rimanda. Una chiave della risorsa è parametro aggiuntivo che devi passare per accedere ai file condivisi utilizzando .
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
: 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()
Recupera un'immagine in miniatura per il file o null
se non esiste una miniatura.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Logs the thumbnail image for each file to the console as a blob, // or null if no thumbnail exists. console.log(file.getThumbnail()); }
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 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()
Consente di acquisire l'elenco di visualizzatori e commentatori di File
. Se l'utente
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 (viewer of viewers) { console.log(viewer.getEmail()); } }
Invio
User[]
: se l'utente ha accesso in modifica per questo File
, restituisce l'elenco di
spettatori e commentatori. Se l'utente non ha accesso in modifica, restituisce un array vuoto.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isStarred()
Determina se File
è stato aggiunto a Speciali nel Drive dell'utente.
Invio
Boolean
: true
se File
è stato aggiunto a Speciali nel Drive dell'utente; false
in caso contrario
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isTrashed()
Determina se l'elemento File
si trova nel cestino del Drive dell'utente.
Invio
Boolean
: true
se File
si trova nel cestino del Drive dell'utente;
false
in caso contrario
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
makeCopy()
Crea una copia del file.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and logs the file name to the console. console.log(file.makeCopy().getName()); }
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 gli assegna 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 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 le assegna 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 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 fornita.
L'utente corrente deve essere il proprietario del file o disporre almeno dell'accesso in modifica alla proprietà cartella principale corrente per spostare l'elemento nella cartella di destinazione.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
destination | Folder | La cartella che diventa la nuova cartella principale. |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
removeCommenter(emailAddress)
Rimuove l'utente specificato dall'elenco degli autori di commenti per 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.
// 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
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
removeCommenter(user)
Rimuove l'utente specificato dall'elenco degli autori di commenti per 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.
// 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
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
removeEditor(emailAddress)
Rimuove l'utente specificato dall'elenco degli editor per File
. Questo metodo non
impedisce agli utenti di accedere a File
se appartengono a una classe di utenti con
accesso generale, ad esempio se File
viene condiviso con l'intera organizzazione
dominio 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 |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente da rimuovere. |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
removeEditor(user)
Rimuove l'utente specificato dall'elenco degli editor per File
. Questo metodo non
impedisce agli utenti di accedere a File
se appartengono a una classe di utenti con
accesso generale, ad esempio se File
viene condiviso con l'intera organizzazione
dominio 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. |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
removeViewer(emailAddress)
Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per File
. Questo
non ha effetto se l'utente è un editor, non un visualizzatore o un commentatore. Questo metodo
non impedisce agli utenti di accedere a File
se appartengono a una classe di utenti che
dispongono di accesso generale, ad esempio, se File
è condiviso con
l'intero dominio 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
: File
per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
removeViewer(user)
Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori per File
. Questo
non ha effetto se l'utente è un editor, non un visualizzatore. Inoltre, questo metodo non blocca
agli utenti di accedere a File
se appartengono a una classe di utenti con
accesso, ad esempio se File
è condiviso con l'intero dominio dell'utente oppure
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
: File
per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
revokePermissions(emailAddress)
Revoca l'accesso al File
concesso all'utente specificato. Questo metodo non
impedisce agli utenti di accedere a File
se appartengono a una classe di utenti che
dispongono di accesso generale, ad esempio, se File
è condiviso con
l'intero dominio.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente di cui deve essere revocato l'accesso. |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
Revoca l'accesso al File
concesso all'utente specificato. Questo metodo non
impedisce agli utenti di accedere a File
se appartengono a una classe di utenti che
dispongono di accesso generale, ad esempio, se File
è condiviso con
l'intero dominio.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | Una rappresentazione dell'utente di cui deve essere revocato l'accesso. |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setContent(content)
Sovrascrive i contenuti del file con una determinata sostituzione. Genera un'eccezione se content
è superiore a 10 MB.
// Creates a text file with the content 'Hello, world!' file = DriveApp.createFile('New Text File', 'Hello, world!'); // Logs the content of the text file to the console. console.log(file.getBlob().getDataAsString()); // Updates the content of the text file to 'Updated text!' file.setContent('Updated text!') // Logs content of the text file to the console. console.log(file.getBlob().getDataAsString());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
content | String | I nuovi contenuti per il file. |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setDescription(description)
Consente di impostare la descrizione per File
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
description | String | la nuova descrizione per File |
Invio
File
: File
, per concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setName(name)
Consente di impostare il nome dell'elemento File
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nuovo nome di File |
Invio
File
: File
, per concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setOwner(emailAddress)
Modifica il proprietario di File
. Questo metodo fornisce anche al proprietario precedente
accesso in modifica esplicito al File
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
emailAddress | String | L'indirizzo email dell'utente che dovrebbe diventare il nuovo proprietario |
Invio
File
: File
, per concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setOwner(user)
Modifica il proprietario di File
. Questo metodo fornisce anche al proprietario precedente
accesso in modifica esplicito al File
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
user | User | una rappresentazione dell'utente che dovrebbe diventare il nuovo proprietario |
Invio
File
: File
, per concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setSecurityUpdateEnabled(enabled)
Consente di impostare se File
richiede una chiave risorsa per l'accesso quando
condiviso tramite 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 . |
Invio
File
: File
, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setSharing(accessType, permissionType)
Imposta la classe di utenti che può accedere all'File
e le autorizzazioni
a questi utenti, oltre a quelli individuali a cui è stato esplicitamente concesso l'accesso.
// Creates a folder that anyone on the Internet can read from and write to. (Domain // administrators can prohibit this setting for users of a Google Workspace domain.) var folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
accessType | Access | quale classe di utenti deve essere in grado di accedere all'File |
permissionType | Permission | le autorizzazioni che devono essere concesse agli utenti che possono accedere all'File |
Invio
File
: File
, per concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setStarred(starred)
Consente di impostare se File
viene aggiunto a Speciali nel Drive dell'utente. L'impostazione predefinita per
i nuovi File
sono false
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
starred | Boolean | true se File deve essere aggiunto a Speciali nella cartella
Drive; false in caso contrario |
Invio
File
: File
, per concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive
setTrashed(trashed)
Consente di impostare se l'elemento File
si trova nel cestino del Drive dell'utente. Solo il
proprietario può spostare nel cestino File
. Il valore predefinito per i nuovi File
è false
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
trashed | Boolean | true se File deve essere spostato nel cestino di
il Drive dell'utente; false in caso contrario |
Invio
File
: File
, per concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/drive