Esta página foi traduzida pela API Cloud Translation.

Interface Element

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

Nome	Breve descrição
`Body`	O conteúdo de uma guia em um arquivo do Documentos Google.
`ContainerElement`	Um elemento genérico que pode conter outros elementos.
`Date`	Elemento que representa uma data formatada.
`Equation`	Um elemento que representa uma expressão matemática.
`EquationFunction`	Um elemento que representa uma função em um `Equation` matemático.
`EquationFunctionArgumentSeparator`	Um elemento que representa um separador de função em um `Equation` matemático.
`EquationSymbol`	Um elemento que representa um símbolo em uma `Equation` matemática.
`FooterSection`	Um elemento que representa uma seção de rodapé.
`Footnote`	Um elemento que representa uma nota de rodapé.
`FootnoteSection`	Um elemento que representa uma seção de nota de rodapé.
`HeaderSection`	Um elemento que representa uma seção de cabeçalho.
`HorizontalRule`	Um elemento que representa uma regra horizontal.
`InlineDrawing`	Um elemento que representa um desenho incorporado.
`InlineImage`	Um elemento que representa uma imagem incorporada.
`ListItem`	Um elemento que representa um item da lista.
`PageBreak`	Um elemento que representa uma quebra de página.
`Paragraph`	Um elemento que representa um parágrafo.
`Person`	Um elemento que representa um link para uma pessoa.
`RichLink`	Um elemento que representa um link para um recurso do Google, como um arquivo do Drive ou um vídeo do YouTube.
`Table`	Um elemento que representa uma tabela.
`TableCell`	Um elemento que representa uma célula da tabela.
`TableOfContents`	Um elemento que contém um sumário.
`TableRow`	Um elemento que representa uma linha da tabela.
`Text`	Um elemento que representa uma região de rich text.
`UnsupportedElement`	Um 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étodo	Tipo de retorno	Breve descrição
`asBody()`	`Body`	Retorna o elemento atual como uma `Body`.
`asDate()`	`Date`	Retorna o elemento atual como uma `Date`.
`asEquation()`	`Equation`	Retorna o elemento atual como uma `Equation`.
`asEquationFunction()`	`EquationFunction`	Retorna o elemento atual como uma `EquationFunction`.
`asEquationFunctionArgumentSeparator()`	`EquationFunctionArgumentSeparator`	Retorna o elemento atual como uma `EquationFunctionArgumentSeparator`.
`asEquationSymbol()`	`EquationSymbol`	Retorna o elemento atual como uma `EquationSymbol`.
`asFooterSection()`	`FooterSection`	Retorna o elemento atual como uma `FooterSection`.
`asFootnote()`	`Footnote`	Retorna o elemento atual como uma `Footnote`.
`asFootnoteSection()`	`FootnoteSection`	Retorna o elemento atual como uma `FootnoteSection`.
`asHeaderSection()`	`HeaderSection`	Retorna o elemento atual como uma `HeaderSection`.
`asHorizontalRule()`	`HorizontalRule`	Retorna o elemento atual como uma `HorizontalRule`.
`asInlineDrawing()`	`InlineDrawing`	Retorna o elemento atual como uma `InlineDrawing`.
`asInlineImage()`	`InlineImage`	Retorna o elemento atual como uma `InlineImage`.
`asListItem()`	`ListItem`	Retorna o elemento atual como uma `ListItem`.
`asPageBreak()`	`PageBreak`	Retorna o elemento atual como uma `PageBreak`.
`asParagraph()`	`Paragraph`	Retorna o elemento atual como uma `Paragraph`.
`asPerson()`	`Person`	Retorna o elemento atual como uma `Person`.
`asRichLink()`	`RichLink`	Retorna o elemento atual como uma `RichLink`. Por exemplo, um link para um arquivo do Planilhas Google.
`asTable()`	`Table`	Retorna o elemento atual como uma `Table`.
`asTableCell()`	`TableCell`	Retorna o elemento atual como uma `TableCell`.
`asTableOfContents()`	`TableOfContents`	Retorna o elemento atual como uma `TableOfContents`.
`asTableRow()`	`TableRow`	Retorna o elemento atual como uma `TableRow`.
`asText()`	`Text`	Retorna o elemento atual como uma `Text`.
`copy()`	`Element`	Retorna uma cópia detalhada e removida do elemento atual.
`getAttributes()`	`Object`	Recupera os atributos do elemento.
`getNextSibling()`	`Element`	Recupera o próximo elemento irmão do elemento.
`getParent()`	`ContainerElement`	Recupera o elemento pai do elemento.
`getPreviousSibling()`	`Element`	Recupera o elemento irmão anterior do elemento.
`getType()`	`ElementType`	Recupera o `ElementType` do elemento.
`isAtDocumentEnd()`	`Boolean`	Determina se o elemento está no final do `Document`.
`merge()`	`Element`	Mescla o elemento com o irmão anterior do mesmo tipo.
`removeFromParent()`	`Element`	Remove o elemento do pai.
`setAttributes(attributes)`	`Element`	Define 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

`asRichLink()`

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

Nome	Tipo	Descrição
`attributes`	`Object`	Os 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