Class File

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.
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 per `File`.
`addEditor(user)`	`File`	Aggiunge l'utente specificato all'elenco degli editor per `File`.
`addEditors(emailAddresses)`	`File`	Aggiunge l'array di utenti specificato all'elenco degli editor del `File`.
`addViewer(emailAddress)`	`File`	Aggiunge l'utente specificato all'elenco degli spettatori di `File`.
`addViewer(user)`	`File`	Aggiunge l'utente specificato all'elenco degli spettatori di `File`.
`addViewers(emailAddresses)`	`File`	Aggiunge l'array di utenti specificato all'elenco degli spettatori di `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 di `File`.
`getDescription()`	`String`	Recupera la descrizione di `File`.
`getDownloadUrl()`	`String`	Restituisce l'URL che può essere utilizzato per scaricare il file.
`getEditors()`	`User[]`	Recupera l'elenco degli editor per questo `File`.
`getId()`	`String`	Recupera l'ID di `File`.
`getLastUpdated()`	`Date`	Recupera la data dell'ultimo aggiornamento di `File`.
`getMimeType()`	`String`	Recupera il tipo MIME del file.
`getName()`	`String`	Recupera il nome di `File`.
`getOwner()`	`User`	Recupera il proprietario del file.
`getParents()`	`FolderIterator`	Recupera una raccolta di cartelle che sono i genitori immediati di `File`.
`getResourceKey()`	`String`	Recupera la chiave della risorsa del `File` necessaria per accedere agli elementi che sono stati condivisi tramite un link.
`getSecurityUpdateEligible()`	`Boolean`	Indica se questo `File` è idoneo per applicare l'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa per l'accesso quando viene condiviso tramite un link.
`getSecurityUpdateEnabled()`	`Boolean`	Indica se questo `File` richiede una chiave risorsa per l'accesso quando viene condiviso tramite un link.
`getSharingAccess()`	`Access`	Recupera la classe di utenti che possono accedere a `File`, oltre a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso.
`getSharingPermission()`	`Permission`	Recupera l'autorizzazione concessa agli utenti che possono accedere a `File`, oltre a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso.
`getSize()`	`Integer`	Restituisce il numero di byte utilizzati per archiviare `File` in Drive.
`getTargetId()`	`String\|null`	Se si tratta di una scorciatoia, restituisce l'ID dell'elemento a cui punta.
`getTargetMimeType()`	`String\|null`	Se si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui punta.
`getTargetResourceKey()`	`String\|null`	Se il file è una scorciatoia, restituisce la chiave della risorsa dell'elemento a cui punta.
`getThumbnail()`	`Blob\|null`	Recupera un'immagine miniatura per il file o `null` se non esiste alcuna miniatura.
`getUrl()`	`String`	Recupera l'URL che può essere utilizzato per aprire `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 `File` possono condividere con altri utenti o modificare le autorizzazioni.
`isStarred()`	`Boolean`	Determina se `File` è stato aggiunto ai preferiti nell'unità 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 denomina con il 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 l'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 di visualizzatori e commentatori del `File`.
`removeViewer(user)`	`File`	Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del `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 i contenuti del file con una sostituzione specificata.
`setDescription(description)`	`File`	Imposta la descrizione per `File`.
`setName(name)`	`File`	Imposta il nome di `File`.
`setOwner(emailAddress)`	`File`	Modifica il proprietario di `File`.
`setOwner(user)`	`File`	Modifica il proprietario di `File`.
`setSecurityUpdateEnabled(enabled)`	`File`	Imposta se `File` richiede una chiave risorsa per l'accesso quando viene condiviso tramite un link.
`setShareableByEditors(shareable)`	`File`	Determina se gli utenti con autorizzazioni di modifica per `File` possono condividere con altri utenti o modificare le autorizzazioni.
`setSharing(accessType, permissionType)`	`File`	Definisce la classe di utenti che può accedere a `File` e le autorizzazioni concesse a questi utenti, oltre a eventuali singoli utenti a cui è stato concesso esplicitamente l'accesso.
`setStarred(starred)`	`File`	Determina se `File` è aggiunto ai preferiti nel Drive dell'utente.
`setTrashed(trashed)`	`File`	Indica 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à presente nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.

const files = DriveApp.getFilesByName('Test');

// Loops through the files
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter('hello@example.com');
}

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da aggiungere.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`addCommenter(user)`

Aggiungi l'utente specificato all'elenco dei commentatori per File. Se l'utente era già presente nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Adds the active user as a commenter.
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter(Session.getActiveUser());
}

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da aggiungere.

Indietro

File: 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 di utenti specificato all'elenco dei commentatori per File. Se alcuni degli utenti erano già presenti nell'elenco degli spettatori, questo metodo li rimuove dall'elenco degli spettatori.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

while (files.hasNext()) {
  const file = files.next();
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and
  // 'baklavainthebalkans@gmail.com' with the email addresses to add as
  // commenters.
  const emails = [
    'cloudysanfrancisco@gmail.com',
    'baklavainthebalkans@gmail.com',
  ];
  console.log(file.addCommenters(emails));
}

Parametri

Nome	Tipo	Descrizione
`emailAddresses`	`String[]`	Un array di indirizzi email degli utenti da aggiungere.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`addEditor(emailAddress)`

Aggiunge l'utente specificato all'elenco degli editor per File. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da aggiungere.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`addEditor(user)`

Aggiunge l'utente specificato all'elenco degli editor per File. Se l'utente era già nell'elenco degli spettatori, questo metodo lo rimuove dall'elenco.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da aggiungere.

Indietro

File: 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 di utenti specificato all'elenco degli editor del File. Se alcuni utenti erano già presenti nell'elenco degli spettatori, questo metodo li rimuove dall'elenco.

Parametri

Nome	Tipo	Descrizione
`emailAddresses`	`String[]`	Un array di indirizzi email degli utenti da aggiungere.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`addViewer(emailAddress)`

Aggiunge l'utente specificato all'elenco degli spettatori di File. Se l'utente era già nell'elenco degli editor, questo metodo non ha effetto.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da aggiungere.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`addViewer(user)`

Aggiunge l'utente specificato all'elenco degli spettatori di File. Se l'utente era già nell'elenco degli editor, questo metodo non ha effetto.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da aggiungere.

Indietro

File: 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 di utenti specificato all'elenco degli spettatori di File. Se alcuni degli utenti erano già presenti nell'elenco degli editor, questo metodo non ha alcun effetto.

Parametri

Nome	Tipo	Descrizione
`emailAddresses`	`String[]`	Un array di indirizzi email degli utenti da aggiungere.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`getAccess(email)`

Recupera l'autorizzazione concessa a un utente specifico. Il metodo non supporta la restituzione delle autorizzazioni per un gruppo Google o delle autorizzazioni ereditate tramite Google Gruppi.

Parametri

Nome	Tipo	Descrizione
`email`	`String`	L'indirizzo email dell'utente di cui devono essere controllate le autorizzazioni. Google Gruppi non è supportato.

Indietro

Permission: le autorizzazioni concesse all'utente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getAccess(user)`

Recupera l'autorizzazione concessa a un utente specifico. Il metodo non supporta la restituzione delle autorizzazioni per un gruppo Google o delle autorizzazioni ereditate tramite Google Gruppi.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente di cui devono essere controllate le autorizzazioni.

Indietro

Permission: le autorizzazioni concesse all'utente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`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, si presume che la parte del nome file che segue l'ultimo punto (se presente) sia un'estensione esistente che deve essere sostituita. Di conseguenza, "ShoppingList.12.25.2014" diventa "ShoppingList.12.25.pdf".

Per visualizzare le quote giornaliere per le conversioni, consulta Quote per i servizi Google. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a quote più rigide.

Parametri

Nome	Tipo	Descrizione
`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, sono validi anche `'image/bmp'`, `'image/gif'`, `'image/jpeg'` o `'image/png'`. Per un documento Google, è valido anche `'text/markdown'`.

Indietro

Blob: i dati come blob.

`getBlob()`

Restituisce i dati all'interno di questo oggetto come blob.

Indietro

Blob: i dati come blob.

`getDateCreated()`

Recupera la data di creazione di File.

Indietro

Date: la data di creazione 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

`getDescription()`

Recupera la descrizione di File.

Indietro

String: la descrizione 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

`getDownloadUrl()`

Restituisce l'URL che può essere utilizzato per scaricare il file. Solo gli utenti con l'autorizzazione ad aprire il file in Google Drive possono accedere all'URL. Puoi utilizzare questo URL in un browser per scaricare il file, ma non puoi utilizzarlo per recuperare il file con UrlFetchApp. Se vuoi che i contenuti del file siano 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());
}

Indietro

String: l'URL che può essere utilizzato per scaricare il file.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getEditors()`

Recupera l'elenco degli editor per questo File. Se l'utente che esegue lo script non dispone dell'accesso in modifica a File, questo metodo restituisce un array vuoto.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Adds the email addresses in the array as editors of each file.
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com'
  // and 'baklavainthebalkans@gmail.com' with valid email addresses.
  file.addEditors([
    'cloudysanfrancisco@gmail.com',
    'baklavainthebalkans@gmail.com',
  ]);

  // Gets a list of the file editors.
  const editors = file.getEditors();

  // For each file, logs the editors' email addresses to the console.
  for (const editor of editors) {
    console.log(editor.getEmail());
  }
}

Indietro

User[]: se l'utente dispone dell'accesso in modifica per questo File, restituisce l'elenco degli editor. Se l'utente non dispone dell'accesso in modifica, restituisce un array vuoto.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getId()`

Recupera l'ID di File.

Indietro

String: l'ID 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

`getLastUpdated()`

Recupera la data dell'ultimo aggiornamento di File.

Indietro

Date: la data dell'ultimo aggiornamento di File

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`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());
}

Indietro

String: il tipo MIME del file.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getName()`

Recupera il nome di File.

Indietro

String: il nome 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

`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());
}

Indietro

User: il proprietario del file.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getParents()`

Recupera una raccolta di cartelle che sono i genitori immediati di File.

Indietro

FolderIterator: una raccolta di cartelle che sono i genitori immediati di File

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getResourceKey()`

Recupera la chiave della risorsa del File necessaria per accedere agli elementi che sono stati condivisi tramite un link.

Indietro

String: la chiave della risorsa 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 applicare l'aggiornamento della sicurezza che richiede una chiave di accesso alla risorsa per l'accesso quando viene condiviso tramite un link.

Drive richiede una chiave della risorsa per accedere ad alcuni file o cartelle condivisi tramite un link. Questa modifica fa parte di un aggiornamento della sicurezza. L'aggiornamento è attivo per impostazione predefinita per i file e le cartelle idonei. Per attivare o disattivare il requisito della chiave risorsa per i file idonei, utilizza setSecurityUpdateEnabled.

Scopri di più sull'aggiornamento della sicurezza per Google Drive.

Indietro

Boolean: indica se il requisito della chiave della risorsa può essere applicato a File.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSecurityUpdateEnabled()`

Indica se questo File richiede una chiave risorsa per l'accesso quando viene condiviso tramite un link. Questo requisito è attivato per impostazione predefinita per i file e le cartelle idonei. Per attivare o disattivare il requisito della chiave della risorsa per i file idonei, utilizza setSecurityUpdateEnabled.

Scopri di più sull'aggiornamento della sicurezza per Google Drive.

Indietro

Boolean: indica se il requisito della chiave della risorsa è abilitato per questo File.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSharingAccess()`

Recupera la classe di utenti che possono accedere a File, oltre a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso.

Indietro

Access: quale classe di utenti può accedere a File

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSharingPermission()`

Recupera l'autorizzazione concessa agli utenti che possono accedere a File, oltre a tutti gli utenti individuali a cui è stato concesso esplicitamente l'accesso.

Indietro

Permission: le autorizzazioni concesse agli utenti che possono accedere a File

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSize()`

Restituisce il numero di byte utilizzati per archiviare File in Drive. Tieni presente che i file delle applicazioni Google Workspace non vengono conteggiati ai fini dei limiti di spazio di archiviazione di Drive e pertanto restituiscono 0 byte.

Indietro

Integer: il numero di byte utilizzati per archiviare File in Drive

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getTargetId()`

Se si tratta di una scorciatoia, restituisce l'ID dell'elemento a cui punta.

In caso contrario, restituisce null.

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the target ID of the shortcut.
console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);

Indietro

String|null: l'ID articolo di destinazione o null se il file non è una scorciatoia.

`getTargetMimeType()`

Se si tratta di una scorciatoia, restituisce il tipo MIME dell'elemento a cui punta.

In caso contrario, restituisce null.

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the MIME type of the file that the shortcut points to.
console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);

Indietro

String|null: il tipo MIME dell'elemento di destinazione o null se il file non è una scorciatoia.

`getTargetResourceKey()`

Se il file è una scorciatoia, restituisce la chiave della risorsa dell'elemento a cui punta. Una chiave risorsa è un parametro aggiuntivo che devi trasmettere per accedere ai file condivisi tramite un link.

Se il file non è una scorciatoia, 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());

Indietro

String|null: la chiave di risorsa dell'elemento di destinazione o null se il file non è una scorciatoia.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getThumbnail()`

Recupera un'immagine miniatura per il file o null se non esiste alcuna miniatura.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Logs the thumbnail image for each file to the console as a blob,
  // or null if no thumbnail exists.
  console.log(file.getThumbnail());
}

Indietro

Blob|null: l'immagine miniatura del file.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getUrl()`

Recupera l'URL che può essere utilizzato per aprire File in un'app Google come Drive o Documenti.

Indietro

String: l'URL che può essere utilizzato per visualizzare questo File in un'app Google come Drive o Documenti

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`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());
  }
}

Indietro

User[]: se l'utente dispone dell'accesso in modifica per questo File, restituisce l'elenco di visualizzatori e commentatori. Se l'utente non dispone dell'accesso in modifica, restituisce un array vuoto.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`isShareableByEditors()`

Determina se gli utenti con autorizzazioni di modifica per File possono condividere con altri utenti o modificare le autorizzazioni.

Indietro

Boolean — true se gli utenti con autorizzazioni di modifica possono condividere con altri utenti o modificare le autorizzazioni; 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

`isStarred()`

Determina se File è stato aggiunto ai preferiti nell'unità Drive dell'utente.

Indietro

Boolean: true se File è stato aggiunto ai preferiti nel Drive dell'utente; false in caso contrario

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`isTrashed()`

Determina se File si trova nel cestino di Drive dell'utente.

Indietro

Boolean: true se File si trova nel cestino di Drive dell'utente; false in caso contrario

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`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());
}

Indietro

File: la nuova copia.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`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.

Indietro

File: la nuova copia.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`makeCopy(name)`

Crea una copia del file e la denomina con il nome fornito.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and sets the name to 'Test-Copy.'
  const filename = file.makeCopy('Test-Copy');

  // Logs the copied file's name to the console.
  console.log(filename.getName());
}

Parametri

Nome	Tipo	Descrizione
`name`	`String`	Il nome del file da applicare alla nuova copia.

Indietro

File: la nuova copia.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`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 del file da applicare alla nuova copia.
`destination`	`Folder`	La directory in cui copiare il file.

Indietro

File: la nuova copia.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`moveTo(destination)`

Sposta l'elemento nella cartella di destinazione fornita.

L'utente attuale deve essere il proprietario del file o disporre almeno dell'accesso in modifica alla cartella principale attuale dell'elemento per poterlo spostare nella cartella di destinazione.

Parametri

Nome	Tipo	Descrizione
`destination`	`Folder`	La cartella che diventa la nuova cartella principale.

Indietro

File: 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 che dispongono dell'accesso generale, ad esempio se File è condiviso con l'intero dominio dell'utente.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  // TODO(developer): Replace the email with the email of the user you want to
  // remove.
  file.removeCommenter('cloudysanfrancisco@gmail.com');
}

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da rimuovere.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`removeCommenter(user)`

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  console.log(file.removeCommenter(Session.getActiveUser()));
}

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da rimuovere.

Indietro

File: 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 che dispone di accesso generale, ad esempio se File è condiviso con l'intero dominio dell'utente o se File si trova in un Drive condiviso a cui l'utente può accedere.

Per i file di Drive, l'utente viene rimosso anche dall'elenco dei visualizzatori.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da rimuovere.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`removeEditor(user)`

Per i file di Drive, l'utente viene rimosso anche dall'elenco dei visualizzatori.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da rimuovere.

Indietro

File: 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 di visualizzatori e commentatori del File. Questo metodo non ha alcun effetto se l'utente è un editor, non un visualizzatore o un commentatore. Questo metodo non impedisce inoltre agli utenti di accedere a File se appartengono a una classe di utenti che hanno accesso generale, ad esempio se File è condiviso con l'intero dominio dell'utente o se File si trova in un Drive condiviso a cui l'utente può accedere.

Per i file di Drive, l'utente viene rimosso anche dall'elenco degli editor.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente da rimuovere.

Indietro

File: questo File per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`removeViewer(user)`

Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del File. Questo metodo non ha effetto se l'utente è un editor, non un visualizzatore. Questo metodo non impedisce agli utenti di accedere a File se appartengono a una classe di utenti che hanno accesso generale, ad esempio se File è condiviso con l'intero dominio dell'utente o se File si trova in un Drive condiviso a cui l'utente può accedere.

Per i file di Drive, l'utente viene rimosso anche dall'elenco degli editor.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente da rimuovere.

Indietro

File: questo File per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`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 che hanno accesso generale, ad esempio se File è condiviso con l'intero dominio dell'utente.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente il cui accesso deve essere revocato.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`revokePermissions(user)`

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente a cui deve essere revocato l'accesso.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`setContent(content)`

Sovrascrive i contenuti del file con una sostituzione specificata. Genera un'eccezione se content è superiore a 10 MB.

// Creates a text file with the content 'Hello, world!'
const file = DriveApp.createFile('New Text File', 'Hello, world!');

// Logs the content of the text file to the console.
console.log(file.getBlob().getDataAsString());

// Updates the content of the text file to 'Updated text!'
file.setContent('Updated text!');

// Logs content of the text file to the console.
console.log(file.getBlob().getDataAsString());

Parametri

Nome	Tipo	Descrizione
`content`	`String`	I nuovi contenuti del file.

Indietro

File: 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)`

Imposta la descrizione per File.

Parametri

Nome	Tipo	Descrizione
`description`	`String`	la nuova descrizione di `File`

Indietro

File: questo File, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`setName(name)`

Imposta il nome di File.

Parametri

Nome	Tipo	Descrizione
`name`	`String`	il nuovo nome di `File`

Indietro

File: questo File, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`setOwner(emailAddress)`

Modifica il proprietario di File. Questo metodo concede inoltre al precedente proprietario l'accesso esplicito in modifica a File.

Drive non supporta il cambio di proprietà per gli elementi di proprietà di account gmail.com, ma è supportato per gli account Workspace.

Parametri

Nome	Tipo	Descrizione
`emailAddress`	`String`	L'indirizzo email dell'utente che deve diventare il nuovo proprietario.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`setOwner(user)`

Modifica il proprietario di File. Questo metodo concede inoltre al precedente proprietario l'accesso esplicito in modifica a File.

Drive non supporta il cambio di proprietà per gli elementi di proprietà di account gmail.com, ma è supportato per gli account Workspace.

Parametri

Nome	Tipo	Descrizione
`user`	`User`	Una rappresentazione dell'utente che deve diventare il nuovo proprietario.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`setSecurityUpdateEnabled(enabled)`

Imposta se File richiede una chiave risorsa per l'accesso quando viene condiviso tramite 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`.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`setShareableByEditors(shareable)`

Determina se gli utenti con autorizzazioni di modifica per File possono condividere con altri utenti o modificare le autorizzazioni. Il valore predefinito per un nuovo File è true.

Parametri

Nome	Tipo	Descrizione
`shareable`	`Boolean`	`true` se gli utenti con autorizzazioni di modifica devono essere autorizzati a condividere con altri utenti o modificare le autorizzazioni; `false` in caso contrario.

Indietro

File: questo File, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`setSharing(accessType, permissionType)`

Definisce la classe di utenti che può accedere a File e le autorizzazioni concesse a questi utenti, oltre a eventuali singoli utenti a cui è stato concesso esplicitamente l'accesso.

// Creates a folder that anyone on the Internet can read from and write to.
// (Domain administrators can prohibit this setting for users of a Google
// Workspace domain.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parametri

Nome	Tipo	Descrizione
`accessType`	`Access`	quale classe di utenti deve poter accedere a `File`
`permissionType`	`Permission`	le autorizzazioni da concedere agli utenti che possono accedere a `File`

Indietro

File: questo File, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`setStarred(starred)`

Determina se File è aggiunto ai preferiti nel Drive dell'utente. Il valore predefinito per i nuovi File è false.

Parametri

Nome	Tipo	Descrizione
`starred`	`Boolean`	`true` se `File` deve essere aggiunto ai preferiti nel Drive dell'utente; `false` in caso contrario

Indietro

File: questo File, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

`setTrashed(trashed)`

Indica se File si trova nel cestino di Drive dell'utente. Solo il proprietario può spostare File nel cestino. Il valore predefinito per i nuovi File è false.

Parametri

Nome	Tipo	Descrizione
`trashed`	`Boolean`	`true` se `File` deve essere spostato nel cestino di Drive dell'utente; `false` in caso contrario

Indietro

File: questo File, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/drive

Class File Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Metodi

Documentazione dettagliata

addCommenter(emailAddress)

Parametri

Indietro

Autorizzazione

addCommenter(user)

Parametri

Indietro

Autorizzazione

addCommenters(emailAddresses)

Parametri

Indietro

Autorizzazione

addEditor(emailAddress)

Parametri

Indietro

Autorizzazione

addEditor(user)

Parametri

Indietro

Autorizzazione

addEditors(emailAddresses)

Parametri

Indietro

Autorizzazione

addViewer(emailAddress)

Parametri

Indietro

Autorizzazione

addViewer(user)

Parametri

Indietro

Autorizzazione

addViewers(emailAddresses)

Parametri

Indietro

Autorizzazione

getAccess(email)

Parametri

Indietro

Autorizzazione

getAccess(user)

Parametri

Indietro

Autorizzazione

getAs(contentType)

Parametri

Indietro

getBlob()

Indietro

getDateCreated()

Indietro

Autorizzazione

getDescription()

Indietro

Autorizzazione

getDownloadUrl()

Indietro

Autorizzazione

getEditors()

Indietro

Autorizzazione

getId()

Indietro

Autorizzazione

getLastUpdated()

Indietro

Autorizzazione

getMimeType()

Indietro

Autorizzazione

getName()

Indietro

Autorizzazione

getOwner()

Indietro

Autorizzazione

getParents()

Class File

`addCommenter(emailAddress)`

`addCommenter(user)`

`addCommenters(emailAddresses)`

`addEditor(emailAddress)`

`addEditor(user)`

`addEditors(emailAddresses)`

`addViewer(emailAddress)`

`addViewer(user)`

`addViewers(emailAddresses)`

`getAccess(email)`

`getAccess(user)`

`getAs(contentType)`

`getBlob()`

`getDateCreated()`

`getDescription()`

`getDownloadUrl()`

`getEditors()`

`getId()`

`getLastUpdated()`

`getMimeType()`

`getName()`

`getOwner()`

`getParents()`

`getResourceKey()`

`getSecurityUpdateEligible()`

`getSecurityUpdateEnabled()`

`getSharingAccess()`

`getSharingPermission()`

`getSize()`

`getTargetId()`

`getTargetMimeType()`

`getTargetResourceKey()`

`getThumbnail()`

`getUrl()`

`getViewers()`

`isShareableByEditors()`

`isStarred()`

`isTrashed()`

`makeCopy()`

`makeCopy(destination)`

`makeCopy(name)`

`makeCopy(name, destination)`

`moveTo(destination)`

`removeCommenter(emailAddress)`

`removeCommenter(user)`