Class DocumentApp

DocumentApp

El servicio de documentos crea y abre Documents que se pueden editar.

// Open a document by ID.
// TODO(developer): Replace the ID with your own.
let doc = DocumentApp.openById('DOCUMENT_ID');

// Create and open a document.
doc = DocumentApp.create('Document Name');

Propiedades

PropiedadTipoDescripción
AttributeAttributeLa enumeración Attribute.
ElementTypeElementTypeLa ElementType enumeración.
FontFamilyFontFamilyLa enumeración FontFamily.
GlyphTypeGlyphTypeLa GlyphType enumeración.
HorizontalAlignmentHorizontalAlignmentLa HorizontalAlignment enumeración.
ParagraphHeadingParagraphHeadingLa ParagraphHeading enumeración.
PositionedLayoutPositionedLayoutLa PositionedLayout enumeración.
TextAlignmentTextAlignmentLa TextAlignment enumeración.
VerticalAlignmentVerticalAlignmentLa enumeración VerticalAlignment.

Métodos

MétodoTipo de datos que se devuelveDescripción breve
create(name)DocumentCrea y muestra un documento nuevo.
getActiveDocument()DocumentMuestra el documento al que está vinculada la secuencia de comandos.
getUi()UiMuestra una instancia del entorno de la interfaz de usuario del documento que permite que la secuencia de comandos agregue funciones como menús, diálogos y barras laterales.
openById(id)DocumentMuestra el documento con el ID especificado.
openByUrl(url)DocumentAbre y muestra el documento con la URL especificada.

Documentación detallada

create(name)

Crea y muestra un documento nuevo.

// Create and open a new document.
const doc = DocumentApp.create('Document Name');

Parámetros

NombreTipoDescripción
nameStringEl nombre del documento nuevo.

Volver

Document : La instancia del documento nuevo.

Autorización

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

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

getActiveDocument()

Muestra el documento al que está vinculada la secuencia de comandos. Para interactuar con el documento al que no está vinculada la secuencia de comandos, usa openById(id) o openByUrl(url) en su lugar.

// Get the document to which this script is bound.
const doc = DocumentApp.getActiveDocument();

Volver

Document : La instancia del documento

Autorización

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

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

getUi()

Muestra una instancia del entorno de la interfaz de usuario del documento que permite que la secuencia de comandos agregue funciones como menús, diálogos y barras laterales. Una secuencia de comandos solo puede interactuar con la IU de la instancia actual de un documento abierto y solo si la secuencia de comandos está vinculada al documento. Para obtener más información, consulta las guías de menús y diálogos y barras laterales.

// Add a custom menu to the active document, including a separator and a
// sub-menu.
function onOpen(e) {
  DocumentApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(
          DocumentApp.getUi()
              .createMenu('My sub-menu')
              .addItem('One sub-menu item', 'mySecondFunction')
              .addItem('Another sub-menu item', 'myThirdFunction'),
          )
      .addToUi();
}

Volver

Ui : Una instancia del entorno de la interfaz de usuario de este documento


openById(id)

Muestra el documento con el ID especificado. Si la secuencia de comandos está vinculada al documento, usa getActiveDocument() en su lugar.

// Open a document by ID.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById('DOCUMENT_ID');

Parámetros

NombreTipoDescripción
idStringEl ID del documento que se abrirá.

Volver

Document : La instancia del documento.

Autorización

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

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

openByUrl(url)

Abre y muestra el documento con la URL especificada. Si la secuencia de comandos está vinculada al documento, usa getActiveDocument() en su lugar.

// Open a document by URL.
const doc = DocumentApp.openByUrl(
    'https://docs.google.com/document/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit',
);

Parámetros

NombreTipoDescripción
urlStringLa URL del documento que se abrirá

Volver

Document : La instancia del documento

Autorización

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

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