Interface Element

Elemento

Um elemento genérico. Document conteúdo está representados como elementos. Por exemplo, ListItem, Paragraph e Table são e herdam todos os métodos definidos pelo Element, como getType().

Implementação de classes

NomeBreve descrição
BodyO conteúdo de uma guia em um arquivo do Documentos Google.
ContainerElementUm elemento genérico que pode conter outros elementos.
DateElemento que representa uma data formatada.
EquationUm elemento que representa uma expressão matemática.
EquationFunctionUm elemento que representa uma função em um Equation matemático.
EquationFunctionArgumentSeparatorUm elemento que representa um separador de função em um Equation matemático.
EquationSymbolUm elemento que representa um símbolo em uma Equation matemática.
FooterSectionUm elemento que representa uma seção de rodapé.
FootnoteUm elemento que representa uma nota de rodapé.
FootnoteSectionUm elemento que representa uma seção de nota de rodapé.
HeaderSectionUm elemento que representa uma seção de cabeçalho.
HorizontalRuleUm elemento que representa uma regra horizontal.
InlineDrawingUm elemento que representa um desenho incorporado.
InlineImageUm elemento que representa uma imagem incorporada.
ListItemUm elemento que representa um item da lista.
PageBreakUm elemento que representa uma quebra de página.
ParagraphUm elemento que representa um parágrafo.
PersonUm elemento que representa um link para uma pessoa.
RichLinkUm elemento que representa um link para um recurso do Google, como um arquivo do Drive ou um vídeo do YouTube.
TableUm elemento que representa uma tabela.
TableCellUm elemento que representa uma célula da tabela.
TableOfContentsUm elemento que contém um sumário.
TableRowUm elemento que representa uma linha da tabela.
TextUm elemento que representa uma região de rich text.
UnsupportedElementUm elemento que representa uma região desconhecida ou que não pode ser afetada por um script, como um da página de destino.

Métodos

MétodoTipo de retornoBreve descrição
asBody()BodyRetorna o elemento atual como uma Body.
asDate()DateRetorna o elemento atual como uma Date.
asEquation()EquationRetorna o elemento atual como uma Equation.
asEquationFunction()EquationFunctionRetorna o elemento atual como uma EquationFunction.
asEquationFunctionArgumentSeparator()EquationFunctionArgumentSeparatorRetorna o elemento atual como uma EquationFunctionArgumentSeparator.
asEquationSymbol()EquationSymbolRetorna o elemento atual como uma EquationSymbol.
asFooterSection()FooterSectionRetorna o elemento atual como uma FooterSection.
asFootnote()FootnoteRetorna o elemento atual como uma Footnote.
asFootnoteSection()FootnoteSectionRetorna o elemento atual como uma FootnoteSection.
asHeaderSection()HeaderSectionRetorna o elemento atual como uma HeaderSection.
asHorizontalRule()HorizontalRuleRetorna o elemento atual como uma HorizontalRule.
asInlineDrawing()InlineDrawingRetorna o elemento atual como uma InlineDrawing.
asInlineImage()InlineImageRetorna o elemento atual como uma InlineImage.
asListItem()ListItemRetorna o elemento atual como uma ListItem.
asPageBreak()PageBreakRetorna o elemento atual como uma PageBreak.
asParagraph()ParagraphRetorna o elemento atual como uma Paragraph.
asPerson()PersonRetorna o elemento atual como uma Person.
asRichLink()RichLinkRetorna o elemento atual como uma RichLink. Por exemplo, um link para um arquivo do Planilhas Google.
asTable()TableRetorna o elemento atual como uma Table.
asTableCell()TableCellRetorna o elemento atual como uma TableCell.
asTableOfContents()TableOfContentsRetorna o elemento atual como uma TableOfContents.
asTableRow()TableRowRetorna o elemento atual como uma TableRow.
asText()TextRetorna o elemento atual como uma Text.
copy()ElementRetorna uma cópia detalhada e removida do elemento atual.
getAttributes()ObjectRecupera os atributos do elemento.
getNextSibling()ElementRecupera o próximo elemento irmão do elemento.
getParent()ContainerElementRecupera o elemento pai do elemento.
getPreviousSibling()ElementRecupera o elemento irmão anterior do elemento.
getType()ElementTypeRecupera o ElementType do elemento.
isAtDocumentEnd()BooleanDetermina se o elemento está no final do Document.
merge()ElementMescla o elemento com o irmão anterior do mesmo tipo.
removeFromParent()ElementRemove o elemento do pai.
setAttributes(attributes)ElementDefine os atributos do elemento.

Documentação detalhada

asBody()

Retorna o elemento atual como uma Body.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

Body: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asDate()

Retorna o elemento atual como uma Date.

Quando você souber que um elemento é um Date, use esse método para definir o tipo dele como Date. Isso permite que o preenchimento automático do editor do Apps Script mostre os métodos que você pode usar com um Date.

Retornar

Date: o elemento atual com o tipo definido como Date.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asEquation()

Retorna o elemento atual como uma Equation.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

Equation: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asEquationFunction()

Retorna o elemento atual como uma EquationFunction.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

EquationFunction: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asEquationFunctionArgumentSeparator()

Retorna o elemento atual como uma EquationFunctionArgumentSeparator.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

EquationFunctionArgumentSeparator: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asEquationSymbol()

Retorna o elemento atual como uma EquationSymbol.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

EquationSymbol: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asFooterSection()

Retorna o elemento atual como uma FooterSection.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

FooterSection: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asFootnote()

Retorna o elemento atual como uma Footnote.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

Footnote: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asFootnoteSection()

Retorna o elemento atual como uma FootnoteSection.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

FootnoteSection: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asHeaderSection()

Retorna o elemento atual como uma HeaderSection.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

HeaderSection: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asHorizontalRule()

Retorna o elemento atual como uma HorizontalRule.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

HorizontalRule: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asInlineDrawing()

Retorna o elemento atual como uma InlineDrawing.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

InlineDrawing: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asInlineImage()

Retorna o elemento atual como uma InlineImage.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

InlineImage: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asListItem()

Retorna o elemento atual como uma ListItem.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

ListItem: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asPageBreak()

Retorna o elemento atual como uma PageBreak.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

PageBreak: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asParagraph()

Retorna o elemento atual como uma Paragraph.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

Paragraph: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asPerson()

Retorna o elemento atual como uma Person.

Quando você souber que um elemento é uma Person, use esse método para definir o tipo dele como uma pessoa. Isso permite que o preenchimento automático do editor do Apps Script mostre os métodos que você pode usar com uma elemento pessoal.

Retornar

Person: o elemento atual com o tipo definido como Person.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

Retorna o elemento atual como uma RichLink. Por exemplo, um link para um arquivo do Planilhas Google.

Quando você souber que um elemento é um RichLink, use esse método para definir o tipo dele como RichLink. Isso permite que o preenchimento automático do editor do Apps Script mostre os métodos que você pode usar com um RichLink.

Retornar

RichLink: o elemento atual com o tipo definido como RichLink.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asTable()

Retorna o elemento atual como uma Table.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

Table: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asTableCell()

Retorna o elemento atual como uma TableCell.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

TableCell: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asTableOfContents()

Retorna o elemento atual como uma TableOfContents.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

TableOfContents: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asTableRow()

Retorna o elemento atual como uma TableRow.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

TableRow: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

asText()

Retorna o elemento atual como uma Text.

Use este método para auxiliar o preenchimento automático sempre que um elemento for conhecido como sendo de um não é válido.

Retornar

Text: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

copy()

Retorna uma cópia detalhada e removida do elemento atual.

Todos os elementos filhos presentes no elemento também são copiados. O novo elemento não tem pai

Retornar

Element: a nova cópia.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

getAttributes()

Recupera os atributos do elemento.

O resultado é um objeto que contém uma propriedade para cada atributo de elemento válido, em que cada nome da propriedade corresponde a um item na enumeração DocumentApp.Attribute.

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

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

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

// Log the paragraph attributes.
for (var att in atts) {
  Logger.log(att + ":" + atts[att]);
}

Retornar

Object: os atributos do elemento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

getNextSibling()

Recupera o próximo elemento irmão do elemento.

O próximo irmão tem o mesmo pai e segue o elemento atual.

Retornar

Element: o próximo elemento irmão.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

getParent()

Recupera o elemento pai do elemento.

O elemento pai contém o elemento atual.

Retornar

ContainerElement: o elemento pai.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

getPreviousSibling()

Recupera o elemento irmão anterior do elemento.

O irmão anterior tem o mesmo pai e precede o elemento atual.

Retornar

Element: o elemento irmão anterior.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

getType()

Recupera o ElementType do elemento.

Use getType() para determinar o tipo exato de um determinado elemento.

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

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

var 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.');
}

Retornar

ElementType: o tipo de elemento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

isAtDocumentEnd()

Determina se o elemento está no final do Document.

Retornar

Boolean: se o elemento está no final da guia.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

merge()

Mescla o elemento com o irmão anterior do mesmo tipo.

Somente elementos do mesmo ElementType podem ser mesclados. Todos os elementos filhos contidos o elemento atual são movidos para o elemento irmão anterior.

O elemento atual é removido do documento.

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

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
var par1 = body.appendParagraph('Paragraph 1.');
var 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.
var cells = [
['Row 1, Cell 1', 'Row 1, Cell 2'],
['Row 2, Cell 1', 'Row 2, Cell 2']
];
// Build a table from the array.
var table = body.appendTable(cells);
// Get the first row in the table.
 var row = table.getRow(0);
// Get the two cells in this row.
var cell1 = row.getCell(0);
var cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
var merged = cell2.merge();

Retornar

Element: o elemento mesclado.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

removeFromParent()

Remove o elemento do pai.

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

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

Retornar

Element: o elemento removido.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

setAttributes(attributes)

Define os atributos do elemento.

O parâmetro de atributos especificado precisa ser um objeto em que cada nome de propriedade é um item a enumeração DocumentApp.Attribute e cada valor de propriedade é o novo valor a ser aplicada.

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

// Define a custom paragraph style.
var 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.
var par = body.appendParagraph('A paragraph with custom style.');

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

Parâmetros

NomeTipoDescrição
attributesObjectOs atributos do elemento.

Retornar

Element: o elemento atual.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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