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étodo | Tipo de datos que se muestra | Descripción breve |
---|---|---|
appendText(text) | Text | Agrega el texto especificado al final de esta región de texto. |
copy() | Text | Muestra una copia profunda y separada del elemento actual. |
deleteText(startOffset, endOffsetInclusive) | Text | Borra un rango de texto. |
editAsText() | Text | Obtiene una versión Text del elemento actual para edición. |
findText(searchPattern) | RangeElement | Busca expresiones en el contenido del elemento según el patrón de texto especificado. |
findText(searchPattern, from) | RangeElement | Busca el contenido del elemento para el patrón de texto especificado a partir de un resultado de búsqueda determinado. |
getAttributes() | Object | Recupera los atributos del elemento. |
getAttributes(offset) | Object | Recupera los atributos en el desplazamiento de caracteres especificado. |
getBackgroundColor() | String | Recupera la configuración de color del fondo. |
getBackgroundColor(offset) | String | Recupera el color de fondo del desplazamiento de caracteres especificado. |
getFontFamily() | String | Recupera la configuración de familia de fuentes. |
getFontFamily(offset) | String | Recupera la familia de fuentes en el desplazamiento de caracteres especificado. |
getFontSize() | Number | Recupera la configuración del tamaño de la fuente. |
getFontSize(offset) | Number | Recupera el tamaño de la fuente con el desplazamiento de caracteres especificado. |
getForegroundColor() | String | Recupera la configuración de color del primer plano. |
getForegroundColor(offset) | String | Recupera el color del primer plano en el desplazamiento de caracteres especificado. |
getLinkUrl() | String | Recupera la URL del vínculo. |
getLinkUrl(offset) | String | Recupera la URL del vínculo en la compensación de caracteres especificada. |
getNextSibling() | Element | Recupera el siguiente elemento secundario del elemento. |
getParent() | ContainerElement | Recupera el elemento principal del elemento. |
getPreviousSibling() | Element | Recupera el elemento del mismo nivel anterior del elemento. |
getText() | String | Recupera el contenido del elemento como una string de texto. |
getTextAlignment() | TextAlignment | Obtiene la alineación del texto. |
getTextAlignment(offset) | TextAlignment | Obtiene 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() | ElementType | Recupera el objeto ElementType del elemento. |
insertText(offset, text) | Text | Inserta el texto especificado en el desplazamiento de caracteres determinado. |
isAtDocumentEnd() | Boolean | Determina si el elemento está al final de Document . |
isBold() | Boolean | Recupera la configuración de negrita. |
isBold(offset) | Boolean | Recupera la configuración de negrita del desplazamiento de caracteres especificado. |
isItalic() | Boolean | Recupera la configuración de la cursiva. |
isItalic(offset) | Boolean | Recupera la configuración de cursiva en la compensación de caracteres especificada. |
isStrikethrough() | Boolean | Recupera la configuración de tachado. |
isStrikethrough(offset) | Boolean | Recupera la configuración de tachado en el desplazamiento de caracteres especificado. |
isUnderline() | Boolean | Recupera la configuración de subrayado. |
isUnderline(offset) | Boolean | Recupera la configuración de subrayado con el desplazamiento de caracteres especificado. |
merge() | Text | Combina el elemento con el elemento hermano anterior del mismo tipo. |
removeFromParent() | Text | Quita el elemento de su elemento superior. |
replaceText(searchPattern, replacement) | Element | Reemplaza todas las apariciones de un patrón de texto dado con una string de reemplazo determinada mediante expresiones regulares. |
setAttributes(startOffset, endOffsetInclusive, attributes) | Text | Aplica los atributos especificados al rango de caracteres determinado. |
setAttributes(attributes) | Text | Establece los atributos del elemento. |
setBackgroundColor(startOffset, endOffsetInclusive, color) | Text | Establece el color de fondo para el rango de caracteres especificado. |
setBackgroundColor(color) | Text | Establece el color de fondo. |
setBold(bold) | Text | Establece la configuración de negrita. |
setBold(startOffset, endOffsetInclusive, bold) | Text | Establece la configuración de negrita para el rango de caracteres especificado. |
setFontFamily(startOffset, endOffsetInclusive, fontFamilyName) | Text | Configura la familia de fuentes del rango de caracteres especificado. |
setFontFamily(fontFamilyName) | Text | Establece la familia de fuentes. |
setFontSize(startOffset, endOffsetInclusive, size) | Text | Establece el tamaño de fuente para el rango de caracteres especificado. |
setFontSize(size) | Text | Establece el tamaño de la fuente. |
setForegroundColor(startOffset, endOffsetInclusive, color) | Text | Establece el color de primer plano para el rango de caracteres especificado. |
setForegroundColor(color) | Text | Establece el color de primer plano. |
setItalic(italic) | Text | Establece la configuración de cursiva. |
setItalic(startOffset, endOffsetInclusive, italic) | Text | Establece la configuración de cursiva para el rango de caracteres especificado. |
setLinkUrl(startOffset, endOffsetInclusive, url) | Text | Establece la URL del vínculo para el rango de caracteres especificado. |
setLinkUrl(url) | Text | Configura la URL del vínculo. |
setStrikethrough(strikethrough) | Text | Establece la configuración de tachado. |
setStrikethrough(startOffset, endOffsetInclusive, strikethrough) | Text | Establece la configuración de tachado para el rango de caracteres especificado. |
setText(text) | Text | Establece el contenido del texto. |
setTextAlignment(startOffset, endOffsetInclusive, textAlignment) | Text | Establece la alineación del texto para un rango de caracteres determinado. |
setTextAlignment(textAlignment) | Text | Establece la alineación del texto. |
setUnderline(underline) | Text | Establece la configuración de subrayado. |
setUnderline(startOffset, endOffsetInclusive, underline) | Text | Establece 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
Nombre | Tipo | Descripción |
---|---|---|
text | String | Texto 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
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento de caracteres del primer carácter que se borrará. |
endOffsetInclusive | Integer | El 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
Nombre | Tipo | Descripción |
---|---|---|
searchPattern | String | el 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
Nombre | Tipo | Descripción |
---|---|---|
searchPattern | String | el patrón que se debe buscar |
from | RangeElement | el 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
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El 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
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El 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
. Aunque esta enumeración es obsoleta, seguirá disponible para brindar compatibilidad con secuencias de comandos más antiguas.FontFamily
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
. Aunque esta enumeración es obsoleta, seguirá disponible para brindar compatibilidad con secuencias de comandos más antiguas.
FontFamily
// 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
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El 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
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El 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
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El 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
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El 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
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El 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
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El desplazamiento de caracteres en el que se inserta el texto. |
text | String | Texto 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
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El 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
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El 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
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El 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
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El 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
Nombre | Tipo | Descripción |
---|---|---|
searchPattern | String | el patrón de regex que se buscará |
replacement | String | el 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
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento de inicio del rango de texto |
endOffsetInclusive | Integer | El desplazamiento final del rango de texto. |
attributes | Object | Los 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
Nombre | Tipo | Descripción |
---|---|---|
attributes | Object | Los 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
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento de inicio del rango de texto |
endOffsetInclusive | Integer | El desplazamiento final del rango de texto. |
color | String | El 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
Nombre | Tipo | Descripción |
---|---|---|
color | String | El 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
Nombre | Tipo | Descripción |
---|---|---|
bold | Boolean | 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
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
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento de inicio del rango de texto |
endOffsetInclusive | Integer | El desplazamiento final del rango de texto. |
bold | Boolean | La 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
. Aunque esta enumeración es obsoleta, seguirá disponible para brindar compatibilidad con secuencias de comandos más antiguas.
FontFamily
// 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
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento de inicio del rango de texto |
endOffsetInclusive | Integer | El desplazamiento final del rango de texto. |
fontFamilyName | String | Corresponde 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
. Aunque esta enumeración es obsoleta, seguirá disponible para brindar compatibilidad con secuencias de comandos más antiguas.FontFamily
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
fontFamilyName | String | el 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
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento de inicio del rango de texto |
endOffsetInclusive | Integer | El desplazamiento final del rango de texto. |
size | Number | El 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
Nombre | Tipo | Descripción |
---|---|---|
size | Number | el 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
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento de inicio del rango de texto |
endOffsetInclusive | Integer | El desplazamiento final del rango de texto. |
color | String | El 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
Nombre | Tipo | Descripción |
---|---|---|
color | String | El 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
Nombre | Tipo | Descripción |
---|---|---|
italic | Boolean | la 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
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento de inicio del rango de texto |
endOffsetInclusive | Integer | El desplazamiento final del rango de texto. |
italic | Boolean | La 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
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento de inicio del rango de texto |
endOffsetInclusive | Integer | El desplazamiento final del rango de texto. |
url | String | La 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
Nombre | Tipo | Descripción |
---|---|---|
url | String | la 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
Nombre | Tipo | Descripción |
---|---|---|
strikethrough | Boolean | la 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
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento de inicio del rango de texto |
endOffsetInclusive | Integer | El desplazamiento final del rango de texto. |
strikethrough | Boolean | La 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
Nombre | Tipo | Descripción |
---|---|---|
text | String | El 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
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento inicial del rango de caracteres. |
endOffsetInclusive | Integer | El desplazamiento final del rango de caracteres (inclusive). |
textAlignment | TextAlignment | El 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
Nombre | Tipo | Descripción |
---|---|---|
textAlignment | TextAlignment | el 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
Nombre | Tipo | Descripción |
---|---|---|
underline | Boolean | subrayado |
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
Nombre | Tipo | Descripción |
---|---|---|
startOffset | Integer | El desplazamiento de inicio del rango de texto |
endOffsetInclusive | Integer | El desplazamiento final del rango de texto. |
underline | Boolean | Configuració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