Class Text

Text

Un elemento que representa una región de texto enriquecido. Todo el texto de un Document se encuentra dentro de elementos Text. Un elemento Text puede estar dentro de Equation, EquationFunction, ListItem o Paragraph, pero no puede contener ningún otro elemento. Si deseas obtener más información sobre la estructura del documento, consulta la guía para extender Documentos de Google.

var body = DocumentApp.getActiveDocument().getBody();

// Use editAsText to obtain a single text element containing
// all the characters in the document.
var text = body.editAsText();

// Insert text at the beginning of the document.
text.insertText(0, 'Inserted text.\n');

// Insert text at the end of the document.
text.appendText('\nAppended text.');

// Make the first half of the document blue.
text.setForegroundColor(0, text.getText().length / 2, '#00FFFF');

Métodos

MétodoTipo de datos que se muestraDescripción breve
appendText(text)TextAgrega el texto especificado al final de esta región de texto.
copy()TextMuestra una copia profunda y separada del elemento actual.
deleteText(startOffset, endOffsetInclusive)TextBorra un rango de texto.
editAsText()TextObtiene una versión Text del elemento actual para edición.
findText(searchPattern)RangeElementBusca expresiones en el contenido del elemento según el patrón de texto especificado.
findText(searchPattern, from)RangeElementBusca el contenido del elemento para el patrón de texto especificado a partir de un resultado de búsqueda determinado.
getAttributes()ObjectRecupera los atributos del elemento.
getAttributes(offset)ObjectRecupera los atributos en el desplazamiento de caracteres especificado.
getBackgroundColor()StringRecupera la configuración de color del fondo.
getBackgroundColor(offset)StringRecupera el color de fondo del desplazamiento de caracteres especificado.
getFontFamily()StringRecupera la configuración de familia de fuentes.
getFontFamily(offset)StringRecupera la familia de fuentes en el desplazamiento de caracteres especificado.
getFontSize()NumberRecupera la configuración del tamaño de la fuente.
getFontSize(offset)NumberRecupera el tamaño de la fuente con el desplazamiento de caracteres especificado.
getForegroundColor()StringRecupera la configuración de color del primer plano.
getForegroundColor(offset)StringRecupera el color del primer plano en el desplazamiento de caracteres especificado.
getLinkUrl()StringRecupera la URL del vínculo.
getLinkUrl(offset)StringRecupera la URL del vínculo en la compensación de caracteres especificada.
getNextSibling()ElementRecupera el siguiente elemento secundario del elemento.
getParent()ContainerElementRecupera el elemento principal del elemento.
getPreviousSibling()ElementRecupera el elemento del mismo nivel anterior del elemento.
getText()StringRecupera el contenido del elemento como una string de texto.
getTextAlignment()TextAlignmentObtiene la alineación del texto.
getTextAlignment(offset)TextAlignmentObtiene la alineación del texto para un solo carácter.
getTextAttributeIndices()Integer[]Recupera el conjunto de índices de texto que corresponden al inicio de distintas ejecuciones de formato de texto.
getType()ElementTypeRecupera el objeto ElementType del elemento.
insertText(offset, text)TextInserta el texto especificado en el desplazamiento de caracteres determinado.
isAtDocumentEnd()BooleanDetermina si el elemento está al final de Document.
isBold()BooleanRecupera la configuración de negrita.
isBold(offset)BooleanRecupera la configuración de negrita del desplazamiento de caracteres especificado.
isItalic()BooleanRecupera la configuración de la cursiva.
isItalic(offset)BooleanRecupera la configuración de cursiva en la compensación de caracteres especificada.
isStrikethrough()BooleanRecupera la configuración de tachado.
isStrikethrough(offset)BooleanRecupera la configuración de tachado en el desplazamiento de caracteres especificado.
isUnderline()BooleanRecupera la configuración de subrayado.
isUnderline(offset)BooleanRecupera la configuración de subrayado con el desplazamiento de caracteres especificado.
merge()TextCombina el elemento con el elemento hermano anterior del mismo tipo.
removeFromParent()TextQuita el elemento de su elemento superior.
replaceText(searchPattern, replacement)ElementReemplaza todas las apariciones de un patrón de texto dado con una string de reemplazo determinada mediante expresiones regulares.
setAttributes(startOffset, endOffsetInclusive, attributes)TextAplica los atributos especificados al rango de caracteres determinado.
setAttributes(attributes)TextEstablece los atributos del elemento.
setBackgroundColor(startOffset, endOffsetInclusive, color)TextEstablece el color de fondo para el rango de caracteres especificado.
setBackgroundColor(color)TextEstablece el color de fondo.
setBold(bold)TextEstablece la configuración de negrita.
setBold(startOffset, endOffsetInclusive, bold)TextEstablece la configuración de negrita para el rango de caracteres especificado.
setFontFamily(startOffset, endOffsetInclusive, fontFamilyName)TextConfigura la familia de fuentes del rango de caracteres especificado.
setFontFamily(fontFamilyName)TextEstablece la familia de fuentes.
setFontSize(startOffset, endOffsetInclusive, size)TextEstablece el tamaño de fuente para el rango de caracteres especificado.
setFontSize(size)TextEstablece el tamaño de la fuente.
setForegroundColor(startOffset, endOffsetInclusive, color)TextEstablece el color de primer plano para el rango de caracteres especificado.
setForegroundColor(color)TextEstablece el color de primer plano.
setItalic(italic)TextEstablece la configuración de cursiva.
setItalic(startOffset, endOffsetInclusive, italic)TextEstablece la configuración de cursiva para el rango de caracteres especificado.
setLinkUrl(startOffset, endOffsetInclusive, url)TextEstablece la URL del vínculo para el rango de caracteres especificado.
setLinkUrl(url)TextConfigura la URL del vínculo.
setStrikethrough(strikethrough)TextEstablece la configuración de tachado.
setStrikethrough(startOffset, endOffsetInclusive, strikethrough)TextEstablece la configuración de tachado para el rango de caracteres especificado.
setText(text)TextEstablece el contenido del texto.
setTextAlignment(startOffset, endOffsetInclusive, textAlignment)TextEstablece la alineación del texto para un rango de caracteres determinado.
setTextAlignment(textAlignment)TextEstablece la alineación del texto.
setUnderline(underline)TextEstablece la configuración de subrayado.
setUnderline(startOffset, endOffsetInclusive, underline)TextEstablece la configuración de subrayado del rango de caracteres especificado.

Documentación detallada

appendText(text)

Agrega el texto especificado al final de esta región de texto.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Adds the text, 'Sample body text,' to the end of the document body.
const text = body.editAsText().appendText('Sample body text');

Parámetros

NombreTipoDescripción
textStringTexto que se agregará.

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 alcances:

  • 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 todos los elementos secundarios presentes en el elemento. El elemento nuevo no tiene un elemento superior.

Volver

Text: 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 alcances:

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

deleteText(startOffset, endOffsetInclusive)

Borra un rango de texto.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
 const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Deletes the first 10 characters in the body.
 const text = body.editAsText().deleteText(0, 9);

Parámetros

NombreTipoDescripción
startOffsetIntegerEl desplazamiento de caracteres del primer carácter que se borrará.
endOffsetInclusiveIntegerEl desplazamiento de caracteres del último carácter que se borrará.

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 alcances:

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

editAsText()

Obtiene una versión Text del elemento actual para edición.

Usa editAsText para manipular el contenido de los elementos como texto enriquecido. El modo editAsText ignora los elementos no textuales (como InlineImage y HorizontalRule).

Los elementos secundarios completamente contenidos en un rango de texto borrado se quitan del elemento.

var body = DocumentApp.getActiveDocument().getBody();

// Insert two paragraphs separated by a paragraph containing an
// horizontal rule.
body.insertParagraph(0, "An editAsText sample.");
body.insertHorizontalRule(0);
body.insertParagraph(0, "An example.");

// Delete " sample.\n\n An" removing the horizontal rule in the process.
body.editAsText().deleteText(14, 25);

Volver

Text: Es una versión de texto del elemento actual.


findText(searchPattern)

Busca expresiones en el contenido del elemento según el patrón de texto especificado.

Un subconjunto de las funciones de expresión regular de JavaScript no son totalmente compatibles, como los grupos de captura y los modificadores de modo.

El patrón de expresión regular proporcionado se compara de forma independiente con cada bloque de texto que se encuentra en el elemento actual.

Parámetros

NombreTipoDescripción
searchPatternStringel patrón que se debe buscar

Volver

RangeElement: Es un resultado de la búsqueda que indica la posición del texto de la búsqueda o un valor nulo si no hay coincidencia.

Autorización

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

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

findText(searchPattern, from)

Busca el contenido del elemento para el patrón de texto especificado a partir de un resultado de búsqueda determinado.

Un subconjunto de las funciones de expresión regular de JavaScript no son totalmente compatibles, como los grupos de captura y los modificadores de modo.

El patrón de expresión regular proporcionado se compara de forma independiente con cada bloque de texto que se encuentra en el elemento actual.

Parámetros

NombreTipoDescripción
searchPatternStringel patrón que se debe buscar
fromRangeElementel resultado de la búsqueda

Volver

RangeElement: Es un resultado de la búsqueda que indica la siguiente posición del texto de la búsqueda o un valor nulo si no hay coincidencia.

Autorización

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

  • 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 corresponde a un elemento en la enumeración DocumentApp.Attribute.

var body = DocumentApp.getActiveDocument().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]);
}

Volver

Object: 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 alcances:

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

getAttributes(offset)

Recupera los atributos en el desplazamiento de caracteres especificado.

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

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Declares style attributes.
const style = {}
style[DocumentApp.Attribute.BOLD] = true;
style[DocumentApp.Attribute.ITALIC] = true;
style[DocumentApp.Attribute.FONT_SIZE] = 29;

// Sets the style attributes to the document body.
const text = body.editAsText();
text.setAttributes(style);

// Gets the style attributes applied to the eleventh character in the
// body and logs them to the console.
const attributes = text.getAttributes(10);
console.log(attributes);

Parámetros

NombreTipoDescripción
offsetIntegerEl desplazamiento de caracteres.

Volver

Object: 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 alcances:

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

getBackgroundColor()

Recupera la configuración de color del fondo.

Volver

String: Es el color de fondo con formato de notación CSS (como '#ffffff') o nulo si el elemento contiene varios valores para este atributo.

Autorización

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

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

getBackgroundColor(offset)

Recupera el color de fondo del desplazamiento de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456');

// Gets the document body.
const body = doc.getBody();

// Sets the background color of the first 3 characters in the body.
const text = body.editAsText().setBackgroundColor(0, 2, '#FFC0CB');

// Gets the background color of the first character in the body.
const backgroundColor = text.getBackgroundColor(0);

// Logs the background color to the console.
console.log(backgroundColor);

Parámetros

NombreTipoDescripción
offsetIntegerEl desplazamiento de caracteres.

Volver

String: Es el color de fondo con formato de notación CSS (como '#ffffff').

Autorización

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

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

getFontFamily()

Recupera la configuración de familia de fuentes. El nombre puede ser cualquier fuente del menú de fuente en Documentos o Google Fonts, y distingue entre mayúsculas y minúsculas. Los métodos getFontFamily() y setFontFamily(fontFamilyName) ahora usan nombres de strings para las fuentes en lugar de la enumeración FontFamily. Aunque esta enumeración es obsoleta, seguirá disponible para brindar compatibilidad con secuencias de comandos más antiguas.

Volver

String: Es la familia de fuentes o nula si el elemento contiene varios valores para este atributo.

Autorización

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

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

getFontFamily(offset)

Recupera la familia de fuentes en el desplazamiento de caracteres especificado. El nombre puede ser cualquier fuente del menú de fuente en Documentos o Google Fonts, y distingue entre mayúsculas y minúsculas. Los métodos getFontFamily() y setFontFamily(fontFamilyName) ahora usan nombres de strings para las fuentes en lugar de la enumeración FontFamily. Aunque esta enumeración es obsoleta, seguirá disponible para brindar compatibilidad con secuencias de comandos más antiguas.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the font of the first 16 characters to Impact.
const text = body.editAsText().setFontFamily(0, 15, 'Impact');

// Gets the font family of the 16th character in the document body.
const fontFamily = text.getFontFamily(15);

// Logs the font family to the console.
console.log(fontFamily);

Parámetros

NombreTipoDescripción
offsetIntegerEl desplazamiento de caracteres.

Volver

String: Es la familia de fuentes.

Autorización

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

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

getFontSize()

Recupera la configuración del tamaño de la fuente.

Volver

Number: El tamaño de la fuente o un valor nulo si el elemento contiene varios valores para este atributo

Autorización

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

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

getFontSize(offset)

Recupera el tamaño de la fuente con el desplazamiento de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the font size of the first 13 characters to 15.
const text = body.editAsText().setFontSize(0, 12, 15);

// Gets the font size of the first character.
const fontSize = text.getFontSize(0);

// Logs the font size to the console.
console.log(fontSize);

Parámetros

NombreTipoDescripción
offsetIntegerEl desplazamiento de caracteres.

Volver

Number: Es el tamaño de la fuente.

Autorización

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

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

getForegroundColor()

Recupera la configuración de color del primer plano.

Volver

String: Es el color de primer plano, con formato CSS (como '#ffffff') o nulo si el elemento contiene varios valores para este atributo.

Autorización

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

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

getForegroundColor(offset)

Recupera el color del primer plano en el desplazamiento de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the foreground color of the first 3 characters in the document body.
const text = body.editAsText().setForegroundColor(0, 2, '#0000FF');

// Gets the foreground color of the first character in the document body.
const foregroundColor = text.getForegroundColor(0);

// Logs the foreground color to the console.
console.log(foregroundcolor);

Parámetros

NombreTipoDescripción
offsetIntegerEl desplazamiento de caracteres.

Volver

String: Es el color de primer plano, con formato CSS (como '#ffffff').

Autorización

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

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

getLinkUrl()

Recupera la URL del vínculo.

Volver

String: Es la URL del vínculo o un valor nulo si el elemento contiene varios valores para este atributo.

Autorización

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

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

getLinkUrl(offset)

Recupera la URL del vínculo en la compensación de caracteres especificada.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Applies a link to the first 10 characters in the body.
const text = body.editAsText().setLinkUrl(0, 9, 'https://www.example.com/');

// Gets the URL of the link from the first character.
const link = text.getLinkUrl(0);

// Logs the link URL to the console.
console.log(link);

Parámetros

NombreTipoDescripción
offsetIntegerEl desplazamiento de caracteres.

Volver

String: Es la URL del vínculo.

Autorización

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

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

getNextSibling()

Recupera el siguiente elemento secundario del elemento.

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

Volver

Element: Es el siguiente elemento del mismo nivel.

Autorización

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

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

getParent()

Recupera el elemento principal del elemento.

El elemento principal contiene el elemento actual.

Volver

ContainerElement: Es el elemento principal.

Autorización

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

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

getPreviousSibling()

Recupera el elemento del mismo nivel anterior del elemento.

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

Volver

Element: Es el elemento del mismo nivel anterior.

Autorización

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

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

getText()

Recupera el contenido del elemento como una string de texto.

Volver

String: Es el contenido del elemento como una string de texto.

Autorización

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

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

getTextAlignment()

Obtiene la alineación del texto. Los tipos de alineación disponibles son DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT y DocumentApp.TextAlignment.SUPERSCRIPT.

Volver

TextAlignment: Es el tipo de alineación del texto o null si el texto contiene varios tipos de alineaciones o si la alineación nunca se estableció.

Autorización

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

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

getTextAlignment(offset)

Obtiene la alineación del texto para un solo carácter. Los tipos de alineación disponibles son DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT y DocumentApp.TextAlignment.SUPERSCRIPT.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the text alignment of the document body to NORMAL.
const text = body.editAsText().setTextAlignment(DocumentApp.TextAlignment.NORMAL);

// Gets the text alignment of the ninth character.
const alignment = text.getTextAlignment(8);

// Logs the text alignment to the console.
console.log(alignment.toString());

Parámetros

NombreTipoDescripción
offsetIntegerEl desplazamiento del carácter.

Volver

TextAlignment: Es el tipo de alineación del texto, o null si la alineación del texto nunca se estableció.

Autorización

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

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

getTextAttributeIndices()

Recupera el conjunto de índices de texto que corresponden al inicio de distintas ejecuciones de formato de texto.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Gets the text indices at which text formatting changes.
const indices = body.editAsText().getTextAttributeIndices();

// Logs the indices to the console.
console.log(indices.toString());

Volver

Integer[]: Es el conjunto de índices de texto en el que cambia el formato del texto.

Autorización

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

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

getType()

Recupera el objeto ElementType del elemento.

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

var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document 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.');
}

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 alcances:

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

insertText(offset, text)

Inserta el texto especificado en el desplazamiento de caracteres determinado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Inserts the text, 'Sample inserted text', at the start of the body content.
const text = body.editAsText().insertText(0, 'Sample inserted text');

Parámetros

NombreTipoDescripción
offsetIntegerEl desplazamiento de caracteres en el que se inserta el texto.
textStringTexto que se va a insertar

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 alcances:

  • 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 se encuentra al final del documento.

Autorización

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

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

isBold()

Recupera la configuración de negrita.

Volver

Boolean: Indica si el texto está en negrita o si es nulo si el elemento contiene varios valores para este atributo.

Autorización

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

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

isBold(offset)

Recupera la configuración de negrita del desplazamiento de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Bolds the first 4 characters in the document body.
const text = body.editAsText().setBold(0, 3, true);

// Gets whether or not the text is bold.
const bold = text.editAsText().isBold(0);

// Logs the text's bold setting to the console
console.log(bold);

Parámetros

NombreTipoDescripción
offsetIntegerEl desplazamiento de caracteres.

Volver

Boolean: Es la configuración de negrita.

Autorización

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

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

isItalic()

Recupera la configuración de la cursiva.

Volver

Boolean: Indica si el texto está en cursiva o nulo si el elemento contiene varios valores para este atributo.

Autorización

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

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

isItalic(offset)

Recupera la configuración de cursiva en la compensación de caracteres especificada.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 13 characters of the document body to italic.
const text = body.editAsText().setItalic(0, 12, true);

// Gets whether the fifth character in the document body is set to
// italic and logs it to the console.
const italic = text.isItalic(4);
console.log(italic);

Parámetros

NombreTipoDescripción
offsetIntegerEl desplazamiento de caracteres.

Volver

Boolean: Es la configuración de cursiva.

Autorización

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

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

isStrikethrough()

Recupera la configuración de tachado.

Volver

Boolean: Indica si el texto está tachado o nulo si el elemento contiene varios valores para este atributo.

Autorización

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

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

isStrikethrough(offset)

Recupera la configuración de tachado en el desplazamiento de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 17 characters of the document body to strikethrough.
const text = body.editAsText().setStrikethrough(0, 16, true);

// Gets whether the first character in the document body is set to
// strikethrough and logs it to the console.
const strikethrough = text.isStrikethrough(0);
console.log(strikethrough);

Parámetros

NombreTipoDescripción
offsetIntegerEl desplazamiento de caracteres.

Volver

Boolean: Es la configuración de tachado.

Autorización

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

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

isUnderline()

Recupera la configuración de subrayado.

Volver

Boolean: Indica si el texto está subrayado o es nulo si el elemento contiene varios valores para este atributo.

Autorización

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

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

isUnderline(offset)

Recupera la configuración de subrayado con el desplazamiento de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 13 characters of the document body to underline.
const text = body.editAsText().setUnderline(0, 12, false);

// Gets whether the first character in the document body is set to
// underline and logs it to the console
const underline = text.editAsText().isUnderline(0);
console.log(underline);

Parámetros

NombreTipoDescripción
offsetIntegerEl desplazamiento de caracteres.

Volver

Boolean: Es la configuración de subrayado.

Autorización

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

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

merge()

Combina el elemento con el elemento hermano anterior del mismo tipo.

Solo se pueden combinar elementos de la misma ElementType. Cualquier elemento secundario contenido en el elemento actual se mueve al elemento del mismo nivel anterior.

El elemento actual se quita del documento.

var body = DocumentApp.getActiveDocument().getBody();
// Example 1: Merge paragraphs
// Append two paragraphs to the document.
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();

Volver

Text: 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 alcances:

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

removeFromParent()

Quita el elemento de su elemento superior.

var body = DocumentApp.getActiveDocument().getBody();

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

Volver

Text: 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 alcances:

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

replaceText(searchPattern, replacement)

Reemplaza todas las apariciones de un patrón de texto dado con una string de reemplazo determinada mediante expresiones regulares.

El patrón de búsqueda se pasa como una string y no como un objeto de expresión regular de JavaScript. Por este motivo, deberás escapar cualquier barra invertida en el patrón.

Este método usa la biblioteca de expresiones regulares RE2 de Google, que limita la sintaxis admitida.

El patrón de expresión regular proporcionado se compara de forma independiente con cada bloque de texto que se encuentra en el elemento actual.

var body = DocumentApp.getActiveDocument().getBody();

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText("^.*Apps ?Script.*$", "Apps Script");

Parámetros

NombreTipoDescripción
searchPatternStringel patrón de regex que se buscará
replacementStringel texto que se usará como reemplazo

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 alcances:

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

setAttributes(startOffset, endOffsetInclusive, attributes)

Aplica los atributos especificados al rango de caracteres determinado.

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

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body and edits as text.
const body = doc.getBody().editAsText();

// Declares style attributes for font size and font family.
const style = {}
style[DocumentApp.Attribute.FONT_SIZE] = 20 ;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Impact';

// Sets the style attributes to the first 9 characters in the document body.
const text = body.setAttributes(0, 8, style);

Parámetros

NombreTipoDescripción
startOffsetIntegerEl desplazamiento de inicio del rango de texto
endOffsetInclusiveIntegerEl desplazamiento final del rango de texto.
attributesObjectLos atributos del elemento.

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 alcances:

  • 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 en la enumeración DocumentApp.Attribute y cada valor de propiedad sea el valor nuevo que se aplicará.

var body = DocumentApp.getActiveDocument().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

NombreTipoDescripción
attributesObjectLos atributos del elemento.

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 alcances:

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

setBackgroundColor(startOffset, endOffsetInclusive, color)

Establece el color de fondo para el rango de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the background color of the first 3 characters in the
// document body to hex color #0000FF.
const text = body.editAsText().setBackgroundColor(0, 2, '#0000FF');

Parámetros

NombreTipoDescripción
startOffsetIntegerEl desplazamiento de inicio del rango de texto
endOffsetInclusiveIntegerEl desplazamiento final del rango de texto.
colorStringEl color de fondo con formato de notación CSS (como '#ffffff').

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 alcances:

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

setBackgroundColor(color)

Establece el color de fondo.

Parámetros

NombreTipoDescripción
colorStringEl color de fondo, con formato CSS (como '#ffffff')

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 alcances:

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

setBold(bold)

Establece la configuración de negrita.

Parámetros

NombreTipoDescripción
boldBooleanconfiguración en negrita

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 alcances:

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

setBold(startOffset, endOffsetInclusive, bold)

Establece la configuración de negrita para el rango de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 11 characters in the document body to bold.
const text = body.editAsText().setBold(0, 10, true);

Parámetros

NombreTipoDescripción
startOffsetIntegerEl desplazamiento de inicio del rango de texto
endOffsetInclusiveIntegerEl desplazamiento final del rango de texto.
boldBooleanLa configuración en negrita.

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 alcances:

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

setFontFamily(startOffset, endOffsetInclusive, fontFamilyName)

Configura la familia de fuentes del rango de caracteres especificado. El nombre puede ser cualquier fuente del menú de fuente en Documentos o Google Fonts, y distingue entre mayúsculas y minúsculas. Los nombres de fuentes no reconocidos se procesarán como Arial. Los métodos getFontFamily(offset) y setFontFamily(fontFamilyName) ahora usan nombres de string para fuentes en lugar de la enumeración FontFamily. Aunque esta enumeración es obsoleta, seguirá disponible para brindar compatibilidad con secuencias de comandos más antiguas.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets body of the document.
const body = doc.getBody();

// Sets the font of the first 4 characters in the document body to Roboto.
const text = body.editAsText().setFontFamily(0, 3, 'Roboto');

Parámetros

NombreTipoDescripción
startOffsetIntegerEl desplazamiento de inicio del rango de texto
endOffsetInclusiveIntegerEl desplazamiento final del rango de texto.
fontFamilyNameStringCorresponde al nombre de la familia de fuentes, en el menú Fuente de Documentos o Google Fonts.

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 alcances:

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

setFontFamily(fontFamilyName)

Establece la familia de fuentes. El nombre puede ser cualquier fuente del menú de fuente en Documentos o Google Fonts, y distingue entre mayúsculas y minúsculas. Los nombres de fuentes no reconocidos se procesarán como Arial. Los métodos getFontFamily() y setFontFamily(fontFamilyName) ahora usan nombres de strings para las fuentes en lugar de la enumeración FontFamily. Aunque esta enumeración es obsoleta, seguirá disponible para brindar compatibilidad con secuencias de comandos más antiguas.

Parámetros

NombreTipoDescripción
fontFamilyNameStringel nombre de la familia de fuentes, en el menú Fuente de Documentos o Google Fonts

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 alcances:

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

setFontSize(startOffset, endOffsetInclusive, size)

Establece el tamaño de fuente para el rango de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the size of the first 11 characters in the document body to 12.
const text = body.editAsText().setFontSize(0, 10, 12);

Parámetros

NombreTipoDescripción
startOffsetIntegerEl desplazamiento de inicio del rango de texto
endOffsetInclusiveIntegerEl desplazamiento final del rango de texto.
sizeNumberEl tamaño de la fuente.

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 alcances:

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

setFontSize(size)

Establece el tamaño de la fuente.

Parámetros

NombreTipoDescripción
sizeNumberel tamaño de la fuente

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 alcances:

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

setForegroundColor(startOffset, endOffsetInclusive, color)

Establece el color de primer plano para el rango de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the foreground color of the first 2 characters in the
// document body to hex color #FF0000.
const text = body.editAsText().setForegroundColor(0, 1, '#FF0000');

// Gets the foreground color for the second character in the document body.
const foregroundColor = text.getForegroundColor(1);

//  Logs the foreground color to the console.
console.log(foregroundColor);

Parámetros

NombreTipoDescripción
startOffsetIntegerEl desplazamiento de inicio del rango de texto
endOffsetInclusiveIntegerEl desplazamiento final del rango de texto.
colorStringEl color de primer plano, con formato de notación CSS (como '#ffffff').

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 alcances:

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

setForegroundColor(color)

Establece el color de primer plano.

Parámetros

NombreTipoDescripción
colorStringEl color de primer plano, con formato CSS (como '#ffffff')

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 alcances:

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

setItalic(italic)

Establece la configuración de cursiva.

Parámetros

NombreTipoDescripción
italicBooleanla configuración de cursiva

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 alcances:

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

setItalic(startOffset, endOffsetInclusive, italic)

Establece la configuración de cursiva para el rango de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 11 characters in the document body to italic.
const text = body.editAsText().setItalic(0, 10, true);

Parámetros

NombreTipoDescripción
startOffsetIntegerEl desplazamiento de inicio del rango de texto
endOffsetInclusiveIntegerEl desplazamiento final del rango de texto.
italicBooleanLa configuración de cursiva.

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 alcances:

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

setLinkUrl(startOffset, endOffsetInclusive, url)

Establece la URL del vínculo para el rango de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Applies a link to the first 11 characters in the body.
const text = body.editAsText().setLinkUrl(0, 10, 'https://example.com');

Parámetros

NombreTipoDescripción
startOffsetIntegerEl desplazamiento de inicio del rango de texto
endOffsetInclusiveIntegerEl desplazamiento final del rango de texto.
urlStringLa URL del vínculo

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 alcances:

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

setLinkUrl(url)

Configura la URL del vínculo.

Parámetros

NombreTipoDescripción
urlStringla URL del vínculo

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 alcances:

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

setStrikethrough(strikethrough)

Establece la configuración de tachado.

Parámetros

NombreTipoDescripción
strikethroughBooleanla configuración de tachado

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 alcances:

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

setStrikethrough(startOffset, endOffsetInclusive, strikethrough)

Establece la configuración de tachado para el rango de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 11 characters in the document body to strikethrough.
const text = body.editAsText().setStrikethrough(0, 10, true);

Parámetros

NombreTipoDescripción
startOffsetIntegerEl desplazamiento de inicio del rango de texto
endOffsetInclusiveIntegerEl desplazamiento final del rango de texto.
strikethroughBooleanLa configuración de tachado.

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 alcances:

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

setText(text)

Establece el contenido del texto.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Replaces the contents of the body with the text, 'New body text.'
const text = body.editAsText().setText('New body text.');

Parámetros

NombreTipoDescripción
textStringEl contenido de texto nuevo

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 alcances:

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

setTextAlignment(startOffset, endOffsetInclusive, textAlignment)

Establece la alineación del texto para un rango de caracteres determinado. Los tipos de alineación disponibles son DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT y DocumentApp.TextAlignment.SUPERSCRIPT.

// Make the first character in the first paragraph be superscript.
var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(0, 0, DocumentApp.TextAlignment.SUPERSCRIPT);

Parámetros

NombreTipoDescripción
startOffsetIntegerEl desplazamiento inicial del rango de caracteres.
endOffsetInclusiveIntegerEl desplazamiento final del rango de caracteres (inclusive).
textAlignmentTextAlignmentEl tipo de alineación de texto que se aplica.

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 alcances:

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

setTextAlignment(textAlignment)

Establece la alineación del texto. Los tipos de alineación disponibles son DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT y DocumentApp.TextAlignment.SUPERSCRIPT.

// Make the entire first paragraph be superscript.
var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

Parámetros

NombreTipoDescripción
textAlignmentTextAlignmentel tipo de alineación del texto que se aplicará

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 alcances:

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

setUnderline(underline)

Establece la configuración de subrayado.

Parámetros

NombreTipoDescripción
underlineBooleansubrayado

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 alcances:

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

setUnderline(startOffset, endOffsetInclusive, underline)

Establece la configuración de subrayado del rango de caracteres especificado.

// Opens the Docs file by its URL. If you created your script from within a
// Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the URL with your own.
const doc = DocumentApp.openByUrl('https://docs.google.com/document/d/abc123456/edit');

// Gets the document body.
const body = doc.getBody();

// Sets the first 11 characters in the document body to underline.
const text = body.editAsText().setUnderline(0, 10, true);

Parámetros

NombreTipoDescripción
startOffsetIntegerEl desplazamiento de inicio del rango de texto
endOffsetInclusiveIntegerEl desplazamiento final del rango de texto.
underlineBooleanConfiguración subrayada.

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 alcances:

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