Class DocumentApp

Appdocumento

Il servizio di documenti crea e apre Documents che possono essere modificati.

// Open a document by ID.
// TODO(developer): Replace the ID with your own.
let doc = DocumentApp.openById('DOCUMENT_ID');

// Create and open a document.
doc = DocumentApp.create('Document Name');

Proprietà

Proprietà	Tipo	Descrizione
Attribute	Attribute	L'enumerazione Attribute.
ElementType	ElementType	L'enumerazione ElementType.
FontFamily	FontFamily	L'enumerazione FontFamily.
GlyphType	GlyphType	L'enumerazione GlyphType.
HorizontalAlignment	HorizontalAlignment	L'enumerazione HorizontalAlignment.
ParagraphHeading	ParagraphHeading	L'enumerazione ParagraphHeading.
PositionedLayout	PositionedLayout	L'enumerazione PositionedLayout.
TextAlignment	TextAlignment	L'enumerazione TextAlignment.
VerticalAlignment	VerticalAlignment	L'enumerazione VerticalAlignment.

Metodi

Metodo	Tipo restituito	Breve descrizione
create(name)	Document	Crea e restituisce un nuovo documento.
getActiveDocument()	Document	Restituisce il documento a cui lo script è legato al contenitore.
getUi()	Ui	Restituisce un'istanza dell'ambiente dell'interfaccia utente del documento che consente allo script di aggiungere funzionalità come menu, finestre di dialogo e barre laterali.
openById(id)	Document	Restituisce il documento con l'ID specificato.
openByUrl(url)	Document	Apre e restituisce il documento con l'URL specificato.

Documentazione dettagliata

create(name)

Crea e restituisce un nuovo documento.

// Create and open a new document.
const doc = DocumentApp.create('Document Name');

Parametri

Nome	Tipo	Descrizione
name	String	Il nome del nuovo documento.

Invio

Document: la nuova istanza 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

---

getActiveDocument()

Restituisce il documento a cui lo script è legato al contenitore. Per interagire con il documento a cui lo script non è associato al contenitore, utilizza openById(id) o openByUrl(url).

// Get the document to which this script is bound.
const doc = DocumentApp.getActiveDocument();

Invio

Document: l'istanza 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

---

getUi()

Restituisce un'istanza dell'ambiente dell'interfaccia utente del documento che consente allo script di aggiungere funzionalità come menu, finestre di dialogo e barre laterali. Uno script può interagire con l'interfaccia utente solo per l'istanza corrente di un documento aperto e solo se è legato al documento. Per ulteriori informazioni, consulta le guide ai menu e alle finestre di dialogo e alle barre laterali.

// Add a custom menu to the active document, including a separator and a
// sub-menu.
function onOpen(e) {
  DocumentApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(
          DocumentApp.getUi()
              .createMenu('My sub-menu')
              .addItem('One sub-menu item', 'mySecondFunction')
              .addItem('Another sub-menu item', 'myThirdFunction'),
          )
      .addToUi();
}

Invio

Ui: un'istanza dell'ambiente dell'interfaccia utente di questo documento

---

openById(id)

Restituisce il documento con l'ID specificato. Se lo script è associato al contenitore del documento, utilizza invece getActiveDocument().

// Open a document by ID.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('DOCUMENT_ID');

Parametri

Nome	Tipo	Descrizione
id	String	L'ID del documento da aprire.

Invio

Document: l'istanza 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

---

openByUrl(url)

Apre e restituisce il documento con l'URL specificato. Se lo script è associato al contenitore del documento, utilizza invece getActiveDocument().

// Open a document by URL.
const doc = DocumentApp.openByUrl(
    'https://docs.google.com/document/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit',
);

Parametri

Nome	Tipo	Descrizione
url	String	l'URL del documento da aprire

Invio

Document: l'istanza 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