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