Interface Element

Elemento

Es un elemento genérico. El contenido de Document se representa como elementos. Por ejemplo, ListItem, Paragraph y Table son elementos y heredan todos los métodos definidos por Element, como getType().

Implementa clases

Nombre	Descripción breve
Body	Es el contenido de una pestaña en un documento de Documentos de Google.
ContainerElement	Es un elemento genérico que puede contener otros elementos.
Date	Un elemento que representa una fecha con formato
Equation	Un elemento que representa una expresión matemática.
EquationFunction	Un elemento que representa una función en un Equation matemático.
EquationFunctionArgumentSeparator	Un elemento que representa un separador de funciones en un Equation matemático.
EquationSymbol	Es un elemento que representa un símbolo en un Equation matemático.
FooterSection	Es un elemento que representa una sección de pie de página.
Footnote	Es un elemento que representa una nota al pie.
FootnoteSection	Es un elemento que representa una sección de notas al pie.
HeaderSection	Es un elemento que representa una sección de encabezado.
HorizontalRule	Es un elemento que representa una regla horizontal.
InlineDrawing	Es un elemento que representa un dibujo incorporado.
InlineImage	Es un elemento que representa una imagen incorporada.
ListItem	Es un elemento que representa un elemento de lista.
PageBreak	Es un elemento que representa un salto de página.
Paragraph	Es un elemento que representa un párrafo.
Person	Es un elemento que representa un vínculo a una persona.
RichLink	Es un elemento que representa un vínculo a un recurso de Google, como un archivo de Drive o un video de YouTube.
Table	Un elemento que representa una tabla.
TableCell	Un elemento que representa una celda de tabla.
TableOfContents	Es un elemento que contiene un índice.
TableRow	Un elemento que representa una fila de la tabla.
Text	Es un elemento que representa una región de texto enriquecido.
UnsupportedElement	Un elemento que representa una región que es desconocida o que no puede verse afectada por una secuencia de comandos, como un número de página.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
asBody()	Body	Muestra el elemento actual como un Body.
asDate()	Date	Muestra el elemento actual como un Date.
asEquation()	Equation	Muestra el elemento actual como un Equation.
asEquationFunction()	EquationFunction	Muestra el elemento actual como un EquationFunction.
asEquationFunctionArgumentSeparator()	EquationFunctionArgumentSeparator	Muestra el elemento actual como un EquationFunctionArgumentSeparator.
asEquationSymbol()	EquationSymbol	Muestra el elemento actual como un EquationSymbol.
asFooterSection()	FooterSection	Muestra el elemento actual como un FooterSection.
asFootnote()	Footnote	Muestra el elemento actual como un Footnote.
asFootnoteSection()	FootnoteSection	Muestra el elemento actual como un FootnoteSection.
asHeaderSection()	HeaderSection	Muestra el elemento actual como un HeaderSection.
asHorizontalRule()	HorizontalRule	Muestra el elemento actual como un HorizontalRule.
asInlineDrawing()	InlineDrawing	Muestra el elemento actual como un InlineDrawing.
asInlineImage()	InlineImage	Muestra el elemento actual como un InlineImage.
asListItem()	ListItem	Muestra el elemento actual como un ListItem.
asPageBreak()	PageBreak	Muestra el elemento actual como un PageBreak.
asParagraph()	Paragraph	Muestra el elemento actual como un Paragraph.
asPerson()	Person	Muestra el elemento actual como un Person.
asRichLink()	RichLink	Muestra el elemento actual como un RichLink, por ejemplo, un vínculo a un archivo de Hojas de cálculo de Google.
asTable()	Table	Muestra el elemento actual como un Table.
asTableCell()	TableCell	Muestra el elemento actual como un TableCell.
asTableOfContents()	TableOfContents	Muestra el elemento actual como un TableOfContents.
asTableRow()	TableRow	Muestra el elemento actual como un TableRow.
asText()	Text	Muestra el elemento actual como un Text.
copy()	Element	Muestra una copia profunda y separada del elemento actual.
getAttributes()	Object	Recupera los atributos del elemento.
getNextSibling()	Element	Recupera el siguiente elemento hermano del elemento.
getParent()	ContainerElement	Recupera el elemento superior del elemento.
getPreviousSibling()	Element	Recupera el elemento hermano anterior del elemento.
getType()	ElementType	Recupera el ElementType del elemento.
isAtDocumentEnd()	Boolean	Determina si el elemento está al final de Document.
merge()	Element	Combina el elemento con el hermano anterior del mismo tipo.
removeFromParent()	Element	Quita el elemento de su elemento superior.
setAttributes(attributes)	Element	Establece los atributos del elemento.

Documentación detallada

asBody()

Muestra el elemento actual como un Body.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

Body: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asDate()

Muestra el elemento actual como un Date.

Cuando sepas que un elemento es un Date, usa este método para establecer su tipo como Date. De esta manera, el autocompletado en el editor de Apps Script te muestra los métodos que puedes usar con un Date.

Volver

Date: Es el elemento actual con su tipo establecido como Date.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asEquation()

Muestra el elemento actual como un Equation.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

Equation: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asEquationFunction()

Muestra el elemento actual como un EquationFunction.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

EquationFunction: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asEquationFunctionArgumentSeparator()

Muestra el elemento actual como un EquationFunctionArgumentSeparator.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

EquationFunctionArgumentSeparator: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asEquationSymbol()

Muestra el elemento actual como un EquationSymbol.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

EquationSymbol: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asFooterSection()

Muestra el elemento actual como un FooterSection.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

FooterSection: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asFootnote()

Muestra el elemento actual como un Footnote.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

Footnote: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asFootnoteSection()

Muestra el elemento actual como un FootnoteSection.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

FootnoteSection: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asHeaderSection()

Muestra el elemento actual como un HeaderSection.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

HeaderSection: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asHorizontalRule()

Muestra el elemento actual como un HorizontalRule.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

HorizontalRule: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asInlineDrawing()

Muestra el elemento actual como un InlineDrawing.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

InlineDrawing: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asInlineImage()

Muestra el elemento actual como un InlineImage.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

InlineImage: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asListItem()

Muestra el elemento actual como un ListItem.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

ListItem: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asPageBreak()

Muestra el elemento actual como un PageBreak.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

PageBreak: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asParagraph()

Muestra el elemento actual como un Paragraph.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

Paragraph: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asPerson()

Muestra el elemento actual como un Person.

Cuando sepas que un elemento es un Person, usa este método para establecer su tipo como una persona. De esta manera, el autocompletado en el editor de Apps Script te mostrará los métodos que puedes usar con un elemento de persona.

Volver

Person: Es el elemento actual con su tipo establecido como Person.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asRichLink()

Muestra el elemento actual como un RichLink, por ejemplo, un vínculo a un archivo de Hojas de cálculo de Google.

Cuando sepas que un elemento es un RichLink, usa este método para establecer su tipo como RichLink. De esta manera, el autocompletado en el editor de Apps Script te muestra los métodos que puedes usar con un RichLink.

Volver

RichLink: Es el elemento actual con su tipo establecido como RichLink.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asTable()

Muestra el elemento actual como un Table.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

Table: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asTableCell()

Muestra el elemento actual como un TableCell.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

TableCell: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asTableOfContents()

Muestra el elemento actual como un TableOfContents.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

TableOfContents: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asTableRow()

Muestra el elemento actual como un TableRow.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

TableRow: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

asText()

Muestra el elemento actual como un Text.

Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.

Volver

Text: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

copy()

Muestra una copia profunda y separada del elemento actual.

También se copian los elementos secundarios presentes en el elemento. El elemento nuevo no tiene un elemento superior.

Volver

Element: Es la copia nueva.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

getAttributes()

Recupera los atributos del elemento.

El resultado es un objeto que contiene una propiedad para cada atributo de elemento válido, en el que cada nombre de propiedad corresponde a un elemento de la enumeración DocumentApp.Attribute.

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

// Append a styled paragraph.
const par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
const atts = par.getAttributes();

// Log the paragraph attributes.
for (const att in atts) {
  Logger.log(`${att}:${atts[att]}`);
}

Volver

Object: Son los atributos del elemento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

getNextSibling()

Recupera el siguiente elemento hermano del elemento.

El siguiente hermano tiene el mismo elemento superior y sigue al elemento actual.

Volver

Element: Es el siguiente elemento hermano.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

getParent()

Recupera el elemento superior del elemento.

El elemento superior contiene el elemento actual.

Volver

ContainerElement: Es el elemento superior.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

getPreviousSibling()

Recupera el elemento hermano anterior del elemento.

El hermano anterior tiene el mismo elemento superior y precede al elemento actual.

Volver

Element: Es el elemento hermano anterior.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

getType()

Recupera el ElementType del elemento.

Usa getType() para determinar el tipo exacto de un elemento determinado.

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

// Obtain the first element in the active tab's body.

const firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

Volver

ElementType: Es el tipo de elemento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

isAtDocumentEnd()

Determina si el elemento está al final de Document.

Volver

Boolean: Indica si el elemento está al final de la pestaña.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

merge()

Combina el elemento con el hermano anterior del mismo tipo.

Solo se pueden combinar elementos del mismo ElementType. Todos los elementos secundarios que se encuentran en el elemento actual se mueven al elemento hermano anterior.

Se quita el elemento actual del documento.

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

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
const par1 = body.appendParagraph('Paragraph 1.');
const par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
const cells = [
  ['Row 1, Cell 1', 'Row 1, Cell 2'],
  ['Row 2, Cell 1', 'Row 2, Cell 2'],
];
// Build a table from the array.
const table = body.appendTable(cells);
// Get the first row in the table.
const row = table.getRow(0);
// Get the two cells in this row.
const cell1 = row.getCell(0);
const cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
const merged = cell2.merge();

Volver

Element: Es el elemento combinado.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

removeFromParent()

Quita el elemento de su elemento superior.

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

// Remove all images in the active tab's body.
const imgs = body.getImages();
for (let i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

Volver

Element: Es el elemento que se quitó.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

---

setAttributes(attributes)

Establece los atributos del elemento.

El parámetro de atributos especificado debe ser un objeto en el que cada nombre de propiedad sea un elemento de la enumeración DocumentApp.Attribute y cada valor de propiedad sea el valor nuevo que se aplicará.

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

// Define a custom paragraph style.
const style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
const par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

Parámetros

Nombre	Tipo	Descripción
attributes	Object	Los atributos del elemento

Volver

Element: Es el elemento actual.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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