Class Document

Aggiunge un Bookmark al Position specificato alla prima scheda o, per gli script vincolati a un documento, alla scheda attiva. Per aggiungere un segnalibro a qualsiasi scheda, utilizza il metodo DocumentTab.addBookmark(position).

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the active or first tab's body and adds a paragraph.
const paragraph = doc.getBody().appendParagraph('My new paragraph.');

// Creates a position at the first character of the paragraph text.
const position = doc.newPosition(paragraph.getChild(0), 0);

// Adds a bookmark at the first character of the paragraph text.
const bookmark = doc.addBookmark(position);

// Logs the bookmark ID to the console.
console.log(bookmark.getId());

Parametri

Indietro

Bookmark: il nuovo segnalibro.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

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

Parametri

Indietro

Document — This Document, for chaining.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

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

Parametri

Indietro

Document — This Document, for chaining.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Aggiunge l'array di utenti specificato all'elenco degli editor del Document. Se alcuni utenti erano già presenti nell'elenco degli spettatori, questo metodo li rimuove dall'elenco.

Parametri

Indietro

Document — This Document, for chaining.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Aggiunge una sezione del piè di pagina, se non esiste, alla prima scheda o, per gli script vincolati a un documento, alla scheda attiva. Per aggiungere una sezione di piè di pagina a qualsiasi scheda, utilizza il metodo DocumentTab.addFooter().

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Adds a footer to the document's active or first tab.
const footer = doc.addFooter();

// Sets the footer text to 'This is a footer.'
footer.setText('This is a footer');

Indietro

FooterSection: il piè di pagina della scheda.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Aggiunge una sezione di intestazione, se non esiste, alla prima scheda o, per gli script vincolati a un documento, alla scheda attiva. Per aggiungere una sezione di intestazione a qualsiasi scheda, utilizza il metodo DocumentTab.addHeader().

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Adds a header to the document's active or first tab.
const header = doc.addHeader();

// Sets the header text to 'This is a header.'
header.setText('This is a header');

Indietro

HeaderSection: l'intestazione della scheda.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Aggiunge un NamedRange, ovvero un Range con un nome e un ID da utilizzare per il recupero successivo, nella prima scheda o, per gli script vincolati a un documento, nella scheda attiva. Per aggiungere un NamedRange in qualsiasi scheda, utilizza il metodo DocumentTab.addNamedRange(name, range). I nomi non sono necessariamente univoci; diversi intervalli nello stesso documento possono condividere lo stesso nome, proprio come una classe in HTML. Al contrario, gli ID sono univoci all'interno del documento, come un ID in HTML. Dopo aver aggiunto un NamedRange a un documento, non puoi modificarlo, ma solo rimuoverlo.

Qualsiasi script che accede al documento può accedere a un NamedRange. Per evitare conflitti involontari tra gli script, valuta la possibilità di aggiungere un prefisso ai nomi degli intervalli con una stringa univoca.

// Creates a named range that includes every table in the active tab.
const doc = DocumentApp.getActiveDocument();
const rangeBuilder = doc.newRange();
const tables = doc.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
// Adds the named range to the document's active tab.
doc.addNamedRange('Document tables', rangeBuilder.build());

Parametri

Indietro

NamedRange: il NamedRange.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

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

Parametri

Indietro

Document — This Document, for chaining.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

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

Parametri

Indietro

Document — This Document, for chaining.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Aggiunge l'array di utenti specificato all'elenco dei visualizzatori di Document. Se alcuni degli utenti erano già presenti nell'elenco degli editor, questo metodo non ha alcun effetto.

Parametri

Indietro

Document — This Document, for chaining.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera il Tab attualmente attivo dell'utente nel documento. Uno script può accedere solo alla scheda attiva dell'utente che lo esegue e solo se lo script è associato al documento.

// Display a dialog box that shows the title of the tab that the
// user is currently viewing.
const tab = DocumentApp.getActiveDocument().getActiveTab();
DocumentApp.getUi().alert(`ID of selected tab: ${tab.getTitle()}`);

Indietro

Tab: il Tab attualmente attivo dell'utente o null se lo script non è associato al documento.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera i contenuti correnti di Document come blob del tipo specificato.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the document as a PDF.
const pdf = doc.getAs('application/pdf');

// Logs the name of the PDF to the console.
console.log(pdf.getName());

Parametri

Indietro

Blob: il documento corrente come blob.

Recupera i contenuti correnti di Document come blob.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Retrieves the current document's contents as a blob and logs it to the
// console.
console.log(doc.getBlob().getContentType());

Indietro

Blob: il documento corrente come blob.

Recupera il Body della prima scheda o, per gli script vincolati a un documento, il DocumentBodySection della scheda attiva. Per ottenere l'DocumentBodySection di una scheda, utilizza il metodo DocumentTab.getBody().

Le schede possono contenere diversi tipi di sezioni (ad esempio HeaderSection, FooterSection). La sezione attiva di una scheda è Body.

I metodi degli elementi in Document vengono delegati all'elemento Body attivo.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the active or first tab's body.
const body = doc.getBody();

// Gets the body text and logs it to the console.
console.log(body.getText());

Indietro

Body: la sezione del corpo della scheda.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera Bookmark con l'ID specificato nella prima scheda o, per gli script vincolati a un documento, nella scheda attiva. Per ottenere un segnalibro in qualsiasi scheda, utilizza il metodo DocumentTab.getBookmark(id). Questo metodo restituisce null se non esiste alcun Bookmark all'interno della scheda.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the bookmark by its ID in the document's active or first tab.
const bookmark = doc.getBookmark('id.xyz654321');

// If the bookmark exists, logs the character offset of its position to the
// console. otherwise, logs 'No bookmark exists with the given ID.' to the
// console.
if (bookmark) {
  console.log(bookmark.getPosition().getOffset());
} else {
  console.log('No bookmark exists with the given ID.');
}

Parametri

Indietro

Bookmark|null: il Bookmark con l'ID specificato o null se non esiste alcun Bookmark nella scheda.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera tutti gli oggetti Bookmark nella prima scheda o, per gli script vincolati a un documento, la scheda attiva. Per ottenere tutti i preferiti in qualsiasi scheda, utilizza il metodo DocumentTab.getBookmarks().

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
const doc = DocumentApp.openById('123abc');

// Gets all of the bookmarks in the document's active or first tab.
const bookmarks = doc.getBookmarks();

// Logs the number of bookmarks in the tab to the console.
console.log(bookmarks.length);

Indietro

Bookmark[]: un array degli oggetti Bookmark nella scheda.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera il cursore dell'utente nella scheda attiva. Uno script può accedere al cursore dell'utente che lo esegue solo se lo script è associato al documento.

// Insert some text at the cursor position and make it bold.
const cursor = DocumentApp.getActiveDocument().getCursor();
if (cursor) {
  // Attempt to insert text at the cursor position. If the insertion returns
  // null, the cursor's containing element doesn't allow insertions, so show the
  // user an error message.
  const element = cursor.insertText('ಠ‿ಠ');
  if (element) {
    element.setBold(true);
  } else {
    DocumentApp.getUi().alert('Cannot insert text here.');
  }
} else {
  DocumentApp.getUi().alert('Cannot find a cursor.');
}

Indietro

Position|null: una rappresentazione del cursore dell'utente o null se l'utente non ha posizionato un cursore nella scheda o se lo script non è associato al documento.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera l'elenco degli editor per questo Document.

Indietro

User[]: un array di utenti con autorizzazione di modifica.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera la sezione del piè di pagina della prima scheda o, per gli script vincolati a un documento, la sezione del piè di pagina della scheda attiva. Per ottenere la sezione del piè di pagina di una scheda, utilizza il metodo DocumentTab.getFooter().

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the text of the active or first tab's footer and logs it to the console.
console.log(doc.getFooter().getText());

Indietro

FooterSection|null: il piè di pagina della scheda.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera tutti gli elementi Footnote nel corpo della prima scheda o, per gli script vincolati a un documento, nel corpo della scheda attiva. Per visualizzare tutte le note a piè di pagina in una scheda, utilizza il metodo DocumentTab.getFootnotes().

Le chiamate a getFootnotes causano un'iterazione sugli elementi della scheda. Per le schede di grandi dimensioni, evita chiamate non necessarie a questo metodo.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the first footnote in the active or first tab's body.
const footnote = doc.getFootnotes()[0];

// Logs footnote contents to the console.
console.log(footnote.getFootnoteContents().getText());

Indietro

Footnote[]|null: le note a piè di pagina della scheda.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera la sezione di intestazione della prima scheda o, per gli script vincolati a un documento, la sezione di intestazione della scheda attiva. Per ottenere la sezione dell'intestazione di una scheda, utilizza il metodo DocumentTab.getHeader().

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('123abc');

// Gets the text of the active or first tab's header and logs it to the console.
console.log(doc.getHeader().getText());

Indietro

HeaderSection|null: l'intestazione della scheda.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera l'identificatore univoco del documento. L'ID documento viene utilizzato con DocumentApp.openById() per aprire una specifica istanza del documento.

Indietro

String: l'ID del documento.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera il codice lingua del documento. Questa è la lingua mostrata in File > Lingua dell'editor di documenti, che potrebbe non essere la lingua effettiva contenuta nel documento.

Indietro

String: la lingua del documento o null se non è definita.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera il titolo del documento.

Indietro

String: il titolo del documento.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera NamedRange con l'ID specificato nella prima scheda o, per gli script vincolati a un documento, nella scheda attiva. Per ottenere NamedRange con l'ID specificato in qualsiasi scheda, utilizza il metodo DocumentTab.getNamedRangeById(id). Questo metodo restituisce null se non esiste alcun NamedRange nella scheda. I nomi non sono necessariamente univoci, nemmeno tra le schede; diversi intervalli nella stessa scheda possono condividere lo stesso nome, proprio come una classe in HTML. Al contrario, gli ID sono univoci all'interno della scheda, come un ID in HTML.

Parametri

Indietro

NamedRange|null: il NamedRange con l'ID specificato o null se non esiste un intervallo di questo tipo nella scheda.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera tutti gli oggetti NamedRange nella prima scheda o, per gli script vincolati a un documento, la scheda attiva. Per ottenere tutti gli oggetti NamedRange in qualsiasi scheda, utilizza il metodo DocumentTab.getNamedRanges().

Un NamedRange può essere accessibile da qualsiasi script che accede alla scheda. Per evitare conflitti indesiderati tra gli script, valuta la possibilità di aggiungere un prefisso ai nomi degli intervalli con una stringa univoca.

Indietro

NamedRange[]: un array degli oggetti NamedRange nella scheda, che potrebbe includere più intervalli con lo stesso nome.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera tutti gli oggetti NamedRange con il nome specificato nella prima scheda o, per gli script associati a un documento, nella scheda attiva. Per ottenere tutti gli oggetti NamedRange in qualsiasi scheda, utilizza il metodo DocumentTab.getNamedRanges(name). I nomi non sono necessariamente univoci, nemmeno nelle schede. Diversi intervalli nella stessa scheda possono condividere lo stesso nome, proprio come una classe in HTML. Al contrario, gli ID sono univoci all'interno della scheda, come un ID in HTML.

Un NamedRange può essere accessibile a qualsiasi script che accede al documento. Per evitare conflitti indesiderati tra gli script, valuta la possibilità di aggiungere un prefisso ai nomi degli intervalli con una stringa univoca.

Parametri

Indietro

NamedRange[]: un array degli oggetti NamedRange nella scheda con il nome specificato.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera la selezione dell'utente nella scheda attiva. Uno script può accedere solo alla selezione dell'utente che lo esegue e solo se lo script è associato al documento.

// Display a dialog box that tells the user how many elements are included in
// the selection.
const selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
  const elements = selection.getRangeElements();
  DocumentApp.getUi().alert(`Number of selected elements: ${elements.length}`);
} else {
  DocumentApp.getUi().alert('Nothing is selected.');
}

Indietro

Range|null: una rappresentazione della selezione dell'utente o null se l'utente non ha selezionato nulla nella scheda, se è selezionata solo la fine di un paragrafo, se sono selezionate solo la fine di un paragrafo e una nuova riga o se lo script non è associato al documento.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera tutti i codici lingua supportati nei file Google Docs.

Indietro

String[]: un array di codici lingua.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera Tab con l'ID specificato. Questo metodo restituisce null se non esiste alcun Tab. Può accedere alle schede a qualsiasi livello di nidificazione.

Parametri

Indietro

Tab: il Tab con l'ID specificato o null se non esiste alcun Tab.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera tutti i Tab non nidificati che fanno parte del documento.

Le schede possono contenere schede secondarie, ovvero schede nidificate all'interno di un'altra scheda. Le schede per bambini sono accessibili utilizzando Tab.getChildTabs().

Indietro

Tab[]: l'elenco di tutti i Tab che fanno parte del documento.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera l'URL per accedere al documento corrente.

const doc = DocumentApp.getActiveDocument();

// Send out the link to open the document.
MailApp.sendEmail('<email-address>', doc.getName(), doc.getUrl());

Indietro

String: l'URL per accedere al documento corrente.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Recupera l'elenco di visualizzatori e commentatori per questo Document.

Indietro

User[]: un array di utenti con autorizzazione di visualizzazione o commento.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Crea un nuovo Position, ovvero un riferimento a una posizione nella scheda, relativa a un elemento specifico nella prima scheda o, per gli script vincolati a un documento, alla scheda attiva. Per creare un Position relativo a una posizione in qualsiasi scheda, utilizza il metodo DocumentTab.newPosition(element, offset). Il cursore dell'utente è rappresentato da un Position, tra gli altri utilizzi.

// Append a paragraph to the active tab, then place the user's cursor after the
// first word of the new paragraph.
const doc = DocumentApp.getActiveDocument();
const paragraph = doc.getBody().appendParagraph('My new paragraph.');
const position = doc.newPosition(paragraph.getChild(0), 2);
doc.setCursor(position);

Parametri

Indietro

Position — Il nuovo Position.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Crea un builder utilizzato per costruire oggetti Range dagli elementi delle schede nella prima scheda o, per gli script associati a un documento, nella scheda attiva. Per creare un builder utilizzato per costruire oggetti DocumentRange da elementi scheda in qualsiasi scheda, utilizza il metodo DocumentTab.newRange().

// Change the user's selection to a range that includes every table in the
// active tab.
const doc = DocumentApp.getActiveDocument();
const rangeBuilder = doc.newRange();
const tables = doc.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Indietro

RangeBuilder: il nuovo builder.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Rimuove l'utente specificato dall'elenco degli editor per Document. Questo metodo non impedisce agli utenti di accedere a Document se appartengono a una classe di utenti che dispone di accesso generale, ad esempio se Document è condiviso con l'intero dominio dell'utente o se Document 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

Indietro

Document — This Document, for chaining.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Rimuove l'utente specificato dall'elenco degli editor per Document. Questo metodo non impedisce agli utenti di accedere a Document se appartengono a una classe di utenti che dispone di accesso generale, ad esempio se Document è condiviso con l'intero dominio dell'utente o se Document 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

Indietro

Document — This Document, for chaining.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del Document. 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 Document se appartengono a una classe di utenti che hanno accesso generale, ad esempio se Document è condiviso con l'intero dominio dell'utente o se Document 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

Indietro

Document — Questo Document 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/documents.currentonly
• https://www.googleapis.com/auth/documents

Rimuove l'utente specificato dall'elenco di visualizzatori e commentatori del Document. Questo metodo non ha effetto se l'utente è un editor, non un visualizzatore. Questo metodo non impedisce agli utenti di accedere a Document se appartengono a una classe di utenti che hanno accesso generale, ad esempio se Document è condiviso con l'intero dominio dell'utente o se Document 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

Indietro

Document — Questo Document 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/documents.currentonly
• https://www.googleapis.com/auth/documents

Salva l'Document corrente. Causa lo svuotamento e l'applicazione degli aggiornamenti in attesa.

Il metodo saveAndClose() viene richiamato automaticamente al termine dell'esecuzione dello script per ogni Document modificabile aperto.

Un Document chiuso non può essere modificato. Utilizza DocumentApp.openById() per riaprire un documento specifico per la modifica.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Imposta il Tab selezionato dall'utente nel documento corrente sulla scheda con l'ID specificato.

const doc = DocumentApp.getActiveDocument();

// Sets the user's selected tab by its ID.
// TODO(developer): Replace the ID with your own.
const tab = doc.setActiveTab('123abc');

Parametri

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Imposta il cursore dell'utente, dato un Position. Uno script può accedere al cursore solo dell'utente che lo esegue e solo se lo script è associato al documento.

Se fornisci un Position da un Tab inattivo, la scheda attiva dell'utente viene cambiata.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();

// Append a paragraph, then place the user's cursor after the first word of the
// new paragraph.
const paragraph = documentTab.getBody().appendParagraph('My new paragraph.');
const position = documentTab.newPosition(paragraph.getChild(0), 2);
doc.setCursor(position);

Parametri

Indietro

Document — This Document, for chaining.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Imposta il codice della lingua del documento. Questa è la lingua mostrata in File > Lingua dell'editor di documenti, che potrebbe non essere la lingua effettiva contenuta nel documento. Utilizza getSupportedLanguageCodes() per ottenere tutti i codici lingua validi.

Parametri

Indietro

Document — This Document, for chaining.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Imposta il titolo del documento.

Parametri

Indietro

Document: il documento corrente.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

Imposta la selezione dell'utente nella scheda attiva, dato un Range. Uno script può accedere solo alla selezione dell'utente che lo esegue e solo se lo script è associato al documento.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();

// Change the user's selection to a range that includes every table in the
// document.
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Parametri

Indietro

Document — This Document, for chaining.

Autorizzazione

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

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents