Se usó la API de Cloud Translation para traducir esta página.

Class Layout

Es un diseño en una presentación.

Cada diseño sirve como plantilla para las diapositivas que heredan de él, y determina cómo se organiza y se aplica el estilo al contenido de esas diapositivas.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`getBackground()`	`PageBackground`	Obtiene el fondo de la página.
`getColorScheme()`	`ColorScheme`	Obtiene el objeto `ColorScheme` asociado a la página.
`getGroups()`	`Group[]`	Devuelve la lista de objetos `Group` en la página.
`getImages()`	`Image[]`	Devuelve la lista de objetos `Image` en la página.
`getLayoutName()`	`String`	Obtiene el nombre del diseño.
`getLines()`	`Line[]`	Devuelve la lista de objetos `Line` en la página.
`getMaster()`	`Master`	Obtiene el diseño principal en el que se basa el diseño.
`getObjectId()`	`String`	Obtiene el ID único de la página.
`getPageElementById(id)`	`PageElement\|null`	Devuelve el `PageElement` en la página con el ID determinado o `null` si no existe ninguno.
`getPageElements()`	`PageElement[]`	Devuelve la lista de objetos `PageElement` renderizados en la página.
`getPageType()`	`PageType`	Obtiene el tipo de página.
`getPlaceholder(placeholderType)`	`PageElement\|null`	Devuelve el objeto de marcador de posición `PageElement` para un `PlaceholderType` especificado o `null` si no hay un marcador de posición coincidente.
`getPlaceholder(placeholderType, placeholderIndex)`	`PageElement\|null`	Devuelve el objeto de marcador de posición `PageElement` para un `PlaceholderType` especificado y un índice de marcador de posición, o `null` si el marcador de posición no está presente.
`getPlaceholders()`	`PageElement[]`	Devuelve la lista de objetos `PageElement` de marcador de posición en la página.
`getShapes()`	`Shape[]`	Devuelve la lista de objetos `Shape` en la página.
`getSheetsCharts()`	`SheetsChart[]`	Devuelve la lista de objetos `SheetsChart` en la página.
`getTables()`	`Table[]`	Devuelve la lista de objetos `Table` en la página.
`getVideos()`	`Video[]`	Devuelve la lista de objetos `Video` en la página.
`getWordArts()`	`WordArt[]`	Devuelve la lista de objetos `WordArt` en la página.
`group(pageElements)`	`Group`	Agrupa todos los elementos de la página especificados.
`insertGroup(group)`	`Group`	Inserta una copia del objeto `Group` proporcionado en la página.
`insertImage(blobSource)`	`Image`	Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado del blob de imagen especificado.
`insertImage(blobSource, left, top, width, height)`	`Image`	Inserta una imagen en la página con la posición y el tamaño proporcionados desde el BLOB de imagen especificado.
`insertImage(image)`	`Image`	Inserta una copia del objeto `Image` proporcionado en la página.
`insertImage(imageUrl)`	`Image`	Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado a partir de la URL proporcionada.
`insertImage(imageUrl, left, top, width, height)`	`Image`	Inserta una imagen en la página con la posición y el tamaño proporcionados desde la URL proporcionada.
`insertLine(line)`	`Line`	Inserta una copia del objeto `Line` proporcionado en la página.
`insertLine(lineCategory, startConnectionSite, endConnectionSite)`	`Line`	Inserta una línea en la página que conecta dos `connection sites`.
`insertLine(lineCategory, startLeft, startTop, endLeft, endTop)`	`Line`	Inserta una línea en la página.
`insertPageElement(pageElement)`	`PageElement`	Inserta una copia del objeto `PageElement` proporcionado en la página.
`insertShape(shape)`	`Shape`	Inserta una copia del objeto `Shape` proporcionado en la página.
`insertShape(shapeType)`	`Shape`	Inserta una forma en la página.
`insertShape(shapeType, left, top, width, height)`	`Shape`	Inserta una forma en la página.
`insertSheetsChart(sourceChart)`	`SheetsChart`	Inserta un gráfico de Hojas de cálculo de Google en la página.
`insertSheetsChart(sourceChart, left, top, width, height)`	`SheetsChart`	Inserta un gráfico de Hojas de cálculo de Google en la página con la posición y el tamaño proporcionados.
`insertSheetsChart(sheetsChart)`	`SheetsChart`	Inserta una copia del objeto `SheetsChart` proporcionado en la página.
`insertSheetsChartAsImage(sourceChart)`	`Image`	Inserta un gráfico de Hojas de cálculo de Google como un `Image` en la página.
`insertSheetsChartAsImage(sourceChart, left, top, width, height)`	`Image`	Inserta un gráfico de Hojas de cálculo de Google como un `Image` en la página con la posición y el tamaño proporcionados.
`insertTable(numRows, numColumns)`	`Table`	Inserta una tabla en la página.
`insertTable(numRows, numColumns, left, top, width, height)`	`Table`	Inserta una tabla en la página con la posición y el tamaño proporcionados.
`insertTable(table)`	`Table`	Inserta una copia del objeto `Table` proporcionado en la página.
`insertTextBox(text)`	`Shape`	Inserta un cuadro de texto `Shape` que contiene la cadena proporcionada en la página.
`insertTextBox(text, left, top, width, height)`	`Shape`	Inserta un cuadro de texto `Shape` que contiene la cadena proporcionada en la página.
`insertVideo(videoUrl)`	`Video`	Inserta un video en la esquina superior izquierda de la página con un tamaño predeterminado.
`insertVideo(videoUrl, left, top, width, height)`	`Video`	Inserta un video en la página con la posición y el tamaño proporcionados.
`insertVideo(video)`	`Video`	Inserta una copia del objeto `Video` proporcionado en la página.
`insertWordArt(wordArt)`	`WordArt`	Inserta una copia del objeto `WordArt` proporcionado en la página.
`remove()`	`void`	Quita la página.
`replaceAllText(findText, replaceText)`	`Integer`	Reemplaza todas las instancias del texto que coincide con el texto de búsqueda por el texto de reemplazo.
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Reemplaza todas las instancias del texto que coincide con el texto de búsqueda por el texto de reemplazo.
`selectAsCurrentPage()`	`void`	Selecciona el `Page` en la presentación activa como el `current page selection` y quita cualquier selección anterior.

Documentación detallada

`getBackground()`

Obtiene el fondo de la página.

Volver

PageBackground: Es el fondo de la página.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getColorScheme()`

Obtiene el objeto ColorScheme asociado a la página.

Volver

ColorScheme: Es el esquema de colores de la página.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getGroups()`

Devuelve la lista de objetos Group en la página.

Volver

Group[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getImages()`

Devuelve la lista de objetos Image en la página.

Volver

Image[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLayoutName()`

Obtiene el nombre del diseño.

Volver

String

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLines()`

Devuelve la lista de objetos Line en la página.

Volver

Line[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getMaster()`

Obtiene el diseño principal en el que se basa el diseño.

Volver

Master

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getObjectId()`

Obtiene el ID único de la página. Los IDs de objeto que usan las páginas y los elementos de página comparten el mismo espacio de nombres.

Volver

String

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPageElementById(id)`

Devuelve el PageElement en la página con el ID determinado o null si no existe ninguno.

Parámetros

Nombre	Tipo	Descripción
`id`	`String`	Es el ID del elemento de la página que se recupera.

Volver

PageElement|null: Es el elemento de la página con el ID determinado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPageElements()`

Devuelve la lista de objetos PageElement renderizados en la página.

Volver

PageElement[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPageType()`

Obtiene el tipo de página.

Volver

PageType: Es el tipo de página.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPlaceholder(placeholderType)`

Devuelve el objeto de marcador de posición PageElement para un PlaceholderType especificado o null si no hay un marcador de posición coincidente.

Si hay varios marcadores de posición con el mismo tipo, se devuelve el que tenga el índice de marcador de posición mínimo. Si hay varios marcadores de posición coincidentes con el mismo índice, se devuelve el primer marcador de posición de la colección de elementos de la página.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

Parámetros

Nombre	Tipo	Descripción
`placeholderType`	`PlaceholderType`

Volver

PageElement|null

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPlaceholder(placeholderType, placeholderIndex)`

Devuelve el objeto de marcador de posición PageElement para un PlaceholderType especificado y un índice de marcador de posición, o null si el marcador de posición no está presente.

Si hay varios marcadores de posición con el mismo tipo y el mismo índice, se devuelve el primer marcador de posición de la colección de elementos de la página.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

Parámetros

Nombre	Tipo	Descripción
`placeholderType`	`PlaceholderType`
`placeholderIndex`	`Integer`

Volver

PageElement|null

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPlaceholders()`

Devuelve la lista de objetos PageElement de marcador de posición en la página.

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

Volver

PageElement[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getShapes()`

Devuelve la lista de objetos Shape en la página.

Volver

Shape[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getSheetsCharts()`

Devuelve la lista de objetos SheetsChart en la página.

Volver

SheetsChart[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTables()`

Devuelve la lista de objetos Table en la página.

Volver

Table[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getVideos()`

Devuelve la lista de objetos Video en la página.

Volver

Video[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getWordArts()`

Devuelve la lista de objetos WordArt en la página.

Volver

WordArt[]

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`group(pageElements)`

Agrupa todos los elementos de la página especificados.

Debe haber al menos dos elementos de página en la misma página que aún no estén en otro grupo. Algunos elementos de la página, como Videos, Tables y placeholder Shapes, no se pueden agrupar.

Parámetros

Nombre	Tipo	Descripción
`pageElements`	`PageElement[]`	Elementos que se agruparán.

Volver

Group: Es el grupo nuevo.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertGroup(group)`

Inserta una copia del objeto Group proporcionado en la página.

La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.

Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que heredan de las páginas principales o de diseño también se heredan en el elemento insertado.

Si el elemento proporcionado es un marcador de posición que se copia de otra presentación, las propiedades que heredan de las páginas maestras o de diseño se copian en el elemento de la presentación de origen.

// Copy a group between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(
    group);  // Also available for Layout, Master, and Page.

Parámetros

Nombre	Tipo	Descripción
`group`	`Group`	Es el grupo que se copiará y se insertará.

Volver

Group: Es el grupo insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertImage(blobSource)`

Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado del blob de imagen especificado.

Cuando insertas la imagen, se recupera del BlobSource una vez y se almacena una copia para mostrarla en la presentación. Las imágenes deben pesar menos de 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
slide.insertImage(image);

Parámetros

Nombre	Tipo	Descripción
`blobSource`	`BlobSource`	Son los datos de la imagen.

Volver

Image: Es la imagen insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertImage(blobSource, left, top, width, height)`

Inserta una imagen en la página con la posición y el tamaño proporcionados desde el BLOB de imagen especificado.

La imagen se recupera del BlobSource proporcionado una vez en el momento de la inserción y se almacena una copia para mostrarla dentro de la presentación. Las imágenes deben pesar menos de 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

Para mantener la relación de aspecto de la imagen, esta se centra y se ajusta su escala en relación con el tamaño proporcionado.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 300,
  height: 100
};
slide.insertImage(image, position.left, position.top, size.width, size.height);

Parámetros

Nombre	Tipo	Descripción
`blobSource`	`BlobSource`	Son los datos de la imagen.
`left`	`Number`	Posición horizontal de la imagen en puntos, medida desde la esquina superior izquierda de la página.
`top`	`Number`	Posición vertical de la imagen en puntos, medida desde la esquina superior izquierda de la página.
`width`	`Number`	Ancho de la imagen en puntos.
`height`	`Number`	Es la altura de la imagen en puntos.

Volver

Image: Es la imagen insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertImage(image)`

Inserta una copia del objeto Image proporcionado en la página.

La posición de las imágenes insertadas en esta página se determina a partir de la posición de la imagen fuente en su página respectiva.

Si la imagen proporcionada es un marcador de posición que se copia de la presentación actual, las propiedades que heredan de las páginas principales o de diseño también se heredan en la imagen insertada.

Si la imagen proporcionada es un marcador de posición que se copia de otra presentación, las propiedades que heredan de las páginas maestras o de diseño se copian en la imagen de la presentación de origen. Si la imagen de marcador de posición copiada está vacía, no se insertará nada en la presentación de destino.

// Copy an image between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

Parámetros

Nombre	Tipo	Descripción
`image`	`Image`	Imagen que se copiará y se insertará.

Volver

Image: Es la imagen insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertImage(imageUrl)`

Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado a partir de la URL proporcionada.

Cuando se inserta la imagen, se recupera de la URL una vez y se almacena una copia para mostrarla dentro de la presentación. Las imágenes deben pesar menos de 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

La URL proporcionada debe ser de acceso público y no debe superar los 2 KB. La URL en sí se guarda con la imagen y se expone a través de Image.getSourceUrl().

Parámetros

Nombre	Tipo	Descripción
`imageUrl`	`String`	Es la URL de la imagen.

Volver

Image: Es la imagen insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertImage(imageUrl, left, top, width, height)`

Inserta una imagen en la página con la posición y el tamaño proporcionados desde la URL proporcionada.

La URL proporcionada debe ser de acceso público y no debe superar los 2 KB. La URL en sí se guarda con la imagen y se expone a través de Image.getSourceUrl().

Para mantener la relación de aspecto de la imagen, esta se centra y se ajusta su escala en relación con el tamaño proporcionado.

Parámetros

Nombre	Tipo	Descripción
`imageUrl`	`String`	Es la URL de la imagen.
`left`	`Number`	Posición horizontal de la imagen en puntos, medida desde la esquina superior izquierda de la página.
`top`	`Number`	Posición vertical de la imagen en puntos, medida desde la esquina superior izquierda de la página.
`width`	`Number`	Ancho de la imagen en puntos.
`height`	`Number`	Es la altura de la imagen en puntos.

Volver

Image: Es la imagen insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertLine(line)`

Inserta una copia del objeto Line proporcionado en la página.

La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.

// Copy a line between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

Parámetros

Nombre	Tipo	Descripción
`line`	`Line`	Es la línea que se copiará y se insertará.

Volver

Line: Es la línea insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertLine(lineCategory, startConnectionSite, endConnectionSite)`

Inserta una línea en la página que conecta dos connection sites. Los dos sitios de conexión deben estar en esta página.

// Insert a line in the first slide of the presentation connecting two shapes.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1],
);

Parámetros

Nombre	Tipo	Descripción
`lineCategory`	`LineCategory`	Es la categoría de la línea que se insertará.
`startConnectionSite`	`ConnectionSite`	Es el sitio de conexión en el que se debe conectar el inicio de la línea.
`endConnectionSite`	`ConnectionSite`	Es el sitio de conexión donde se debe conectar el extremo de la línea.

Volver

Line: Es la línea insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertLine(lineCategory, startLeft, startTop, endLeft, endTop)`

Inserta una línea en la página.

// Insert a line in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const endPoint = {
  left: 40,
  top: 40
};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top,
);

Parámetros

Nombre	Tipo	Descripción
`lineCategory`	`LineCategory`	Es la categoría de la línea que se insertará.
`startLeft`	`Number`	Posición horizontal del punto de inicio de la línea, medida en puntos desde la esquina superior izquierda de la página.
`startTop`	`Number`	Es la posición vertical del punto inicial de la línea, medida en puntos desde la esquina superior izquierda de la página.
`endLeft`	`Number`	Posición horizontal del punto final de la línea, medida en puntos desde la esquina superior izquierda de la página.
`endTop`	`Number`	Posición vertical del punto final de la línea, medida en puntos desde la esquina superior izquierda de la página.

Volver

Line: Es la línea insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertPageElement(pageElement)`

Inserta una copia del objeto PageElement proporcionado en la página.

La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.

// Copy a page element between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

Parámetros

Nombre	Tipo	Descripción
`pageElement`	`PageElement`	Elemento de la página que se copiará y se insertará.

Volver

PageElement: Es el elemento de página insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertShape(shape)`

Inserta una copia del objeto Shape proporcionado en la página.

La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.

// Copy a shape between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(
    shape);  // Also available for Layout, Master, and Page.

Parámetros

Nombre	Tipo	Descripción
`shape`	`Shape`	Es la forma que se copiará y se insertará.

Volver

Shape: Es la forma insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertShape(shapeType)`

Inserta una forma en la página.

La forma se inserta con un tamaño predeterminado en la esquina superior izquierda de la página.

// Insert a shape in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

Parámetros

Nombre	Tipo	Descripción
`shapeType`	`ShapeType`	Es el tipo de forma que se insertará.

Volver

Shape: Es la forma insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertShape(shapeType, left, top, width, height)`

Inserta una forma en la página.

Parámetros

Nombre	Tipo	Descripción
`shapeType`	`ShapeType`	Es el tipo de forma que se insertará.
`left`	`Number`	Posición horizontal de la forma, medida desde la esquina superior izquierda de la página.
`top`	`Number`	Posición vertical de la forma, medida desde la esquina superior izquierda de la página.
`width`	`Number`	Ancho de la forma.
`height`	`Number`	Es la altura de la forma.

Volver

Shape: Es la forma insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertSheetsChart(sourceChart)`

Inserta un gráfico de Hojas de cálculo de Google en la página.

El gráfico se inserta con un tamaño predeterminado en la esquina superior izquierda de la página.

El gráfico insertado está vinculado al gráfico fuente de Hojas de cálculo de Google, lo que permite actualizarlo. Otros colaboradores pueden ver el vínculo a la hoja de cálculo fuente.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

Parámetros

Nombre	Tipo	Descripción
`sourceChart`	`EmbeddedChart`	Es el gráfico de una hoja de cálculo que se insertará en la página.

Volver

SheetsChart: Es el gráfico insertado en la página.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertSheetsChart(sourceChart, left, top, width, height)`

Inserta un gráfico de Hojas de cálculo de Google en la página con la posición y el tamaño proporcionados.

Para mantener la relación de aspecto del gráfico, este se ajusta y centra con respecto al tamaño proporcionado.

El gráfico insertado está vinculado al gráfico fuente de Hojas de cálculo de Google, lo que permite actualizarlo. Otros colaboradores pueden ver el vínculo a la hoja de cálculo fuente.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height,
);

Parámetros

Nombre	Tipo	Descripción
`sourceChart`	`EmbeddedChart`	Es el gráfico de una hoja de cálculo que se insertará en la página.
`left`	`Number`	Posición horizontal del gráfico en puntos, medida desde la esquina superior izquierda de la página.
`top`	`Number`	Posición vertical del gráfico en puntos, medida desde la esquina superior izquierda de la página.
`width`	`Number`	Es el ancho del gráfico en puntos.
`height`	`Number`	Es la altura del gráfico en puntos.

Volver

SheetsChart: Es el gráfico insertado en la página.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertSheetsChart(sheetsChart)`

Inserta una copia del objeto SheetsChart proporcionado en la página.

La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.

// Copy a sheets chart between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

Parámetros

Nombre	Tipo	Descripción
`sheetsChart`	`SheetsChart`	Es el gráfico de la hoja que se copiará y se insertará.

Volver

SheetsChart: Es el gráfico de Hojas de cálculo insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertSheetsChartAsImage(sourceChart)`

Inserta un gráfico de Hojas de cálculo de Google como un Image en la página.

La imagen del gráfico se inserta con un tamaño predeterminado en la esquina superior izquierda de la página.

La imagen insertada del gráfico no está vinculada al gráfico fuente de Hojas de cálculo de Google.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(
    chart);  // Also available for Layout, Master, and Page.

Parámetros

Nombre	Tipo	Descripción
`sourceChart`	`EmbeddedChart`	Es el gráfico de una hoja de cálculo que se insertará en la página.

Volver

Image: Es la imagen insertada del gráfico en la página.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertSheetsChartAsImage(sourceChart, left, top, width, height)`

Inserta un gráfico de Hojas de cálculo de Google como un Image en la página con la posición y el tamaño proporcionados.

Para mantener la relación de aspecto de la imagen del gráfico, se ajusta su escala y se centra con respecto al tamaño proporcionado.

La imagen insertada del gráfico no está vinculada al gráfico fuente de Hojas de cálculo de Google.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height,
);

Parámetros

Nombre	Tipo	Descripción
`sourceChart`	`EmbeddedChart`	Es el gráfico de una hoja de cálculo que se insertará en la página.
`left`	`Number`	Posición horizontal del gráfico en puntos, medida desde la esquina superior izquierda de la página.
`top`	`Number`	Posición vertical del gráfico en puntos, medida desde la esquina superior izquierda de la página.
`width`	`Number`	Es el ancho del gráfico en puntos.
`height`	`Number`	Es la altura del gráfico en puntos.

Volver

Image: Es la imagen insertada del gráfico en la página.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertTable(numRows, numColumns)`

Inserta una tabla en la página.

La tabla se centra en la página con el tamaño predeterminado y filas y columnas distribuidas de manera uniforme.

Parámetros

Nombre	Tipo	Descripción
`numRows`	`Integer`	Es la cantidad de filas de la tabla.
`numColumns`	`Integer`	Es la cantidad de columnas de la tabla.

Volver

Table: Es la tabla insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertTable(numRows, numColumns, left, top, width, height)`

Inserta una tabla en la página con la posición y el tamaño proporcionados.

Las filas y las columnas se distribuyen de manera uniforme en la tabla creada.

Parámetros

Nombre	Tipo	Descripción
`numRows`	`Integer`	Es la cantidad de filas de la tabla.
`numColumns`	`Integer`	Es la cantidad de columnas de la tabla.
`left`	`Number`	Posición horizontal de la tabla, medida desde la esquina superior izquierda de la página.
`top`	`Number`	Posición vertical de la tabla, medida desde la esquina superior izquierda de la página.
`width`	`Number`	Es el ancho de la tabla.
`height`	`Number`	Es la altura mínima de la tabla. La altura real de la tabla renderizada depende de factores como el tamaño de la fuente del texto.

Volver

Table: Es la tabla insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertTable(table)`

Inserta una copia del objeto Table proporcionado en la página.

La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.

// Copy a table between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(
    table);  // Also available for Layout, Master, and Page.

Parámetros

Nombre	Tipo	Descripción
`table`	`Table`	Es la tabla que se copiará y se insertará.

Volver

Table: Es la tabla insertada.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertTextBox(text)`

Inserta un cuadro de texto Shape que contiene la cadena proporcionada en la página.

La forma del cuadro de texto se inserta con un tamaño predeterminado en la esquina superior izquierda de la página.

// Insert text box with "Hello" on the first slide of presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello');  // Also available for Layout, Master, and Page.

Parámetros

Nombre	Tipo	Descripción
`text`	`String`	Es la cadena que debe contener la forma del cuadro de texto.

Volver

Shape: Es la forma del cuadro de texto insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertTextBox(text, left, top, width, height)`

Inserta un cuadro de texto Shape que contiene la cadena proporcionada en la página.

// Insert text box with "Hello" on the first slide of presentation. This text
// box is a square with a length of 10 points on each side.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox(
    'Hello', 0, 0, 10, 10);  // Also available for Layout, Master, and Page.

Parámetros

Nombre	Tipo	Descripción
`text`	`String`	Es la cadena que debe contener la forma del cuadro de texto.
`left`	`Number`	Posición horizontal de la forma del cuadro de texto, medida desde la esquina superior izquierda de la página.
`top`	`Number`	Posición vertical de la forma del cuadro de texto, medida desde la esquina superior izquierda de la página.
`width`	`Number`	Es el ancho de la forma del cuadro de texto.
`height`	`Number`	Es la altura de la forma del cuadro de texto.

Volver

Shape: Es la forma del cuadro de texto insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertVideo(videoUrl)`

Inserta un video en la esquina superior izquierda de la página con un tamaño predeterminado.

Por el momento, solo se admiten videos de YouTube.

Parámetros

Nombre	Tipo	Descripción
`videoUrl`	`String`	Es la URL del video que se insertará.

Volver

Video: Es el video insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertVideo(videoUrl, left, top, width, height)`

Inserta un video en la página con la posición y el tamaño proporcionados.

Por el momento, solo se admiten videos de YouTube.

Parámetros

Nombre	Tipo	Descripción
`videoUrl`	`String`	Es la URL del video que se insertará.
`left`	`Number`	Posición horizontal del video en puntos, medida desde la esquina superior izquierda de la página.
`top`	`Number`	Posición vertical del video en puntos, medida desde la esquina superior izquierda de la página.
`width`	`Number`	Ancho del video en puntos.
`height`	`Number`	Altura del video en puntos.

Volver

Video: Es el video insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertVideo(video)`

Inserta una copia del objeto Video proporcionado en la página.

La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.

// Copy a video between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(
    video);  // Also available for Layout, Master, and Page.

Parámetros

Nombre	Tipo	Descripción
`video`	`Video`	Es el video que se copiará y se insertará.

Volver

Video: Es el video insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertWordArt(wordArt)`

Inserta una copia del objeto WordArt proporcionado en la página.

La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.

// Copy a word art between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

Parámetros

Nombre	Tipo	Descripción
`wordArt`	`WordArt`	Es el grupo que se copiará y se insertará.

Volver

WordArt: Es el WordArt insertado.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`remove()`

Quita la página.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceAllText(findText, replaceText)`

Reemplaza todas las instancias del texto que coincide con el texto de búsqueda por el texto de reemplazo. La búsqueda no distingue mayúsculas de minúsculas.

Parámetros

Nombre	Tipo	Descripción
`findText`	`String`	Es el texto que se buscará.
`replaceText`	`String`	Es el texto que reemplazará el texto coincidente.

Volver

Integer: La cantidad de ocurrencias cambió.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceAllText(findText, replaceText, matchCase)`

Reemplaza todas las instancias del texto que coincide con el texto de búsqueda por el texto de reemplazo.

Parámetros

Nombre	Tipo	Descripción
`findText`	`String`	Es el texto que se buscará.
`replaceText`	`String`	Es el texto que reemplazará el texto coincidente.
`matchCase`	`Boolean`	Si es `true`, la búsqueda distingue mayúsculas de minúsculas; si es `false`, no las distingue.

Volver

Integer: La cantidad de ocurrencias cambió.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

`selectAsCurrentPage()`

Selecciona el Page en la presentación activa como el current page selection y quita cualquier selección anterior.

Una secuencia de comandos solo puede acceder a la selección del usuario que la ejecuta y solo si está vinculada a la presentación.

// Select the first slide as the current page selection and replace any previous
// selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage();  // Also available for Layout, Master, and Page.

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/presentations.currentonly
https://www.googleapis.com/auth/presentations

Class Layout Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Métodos

Documentación detallada

getBackground()

Volver

Autorización

getColorScheme()

Volver

Autorización

getGroups()

Volver

Autorización

getImages()

Volver

Autorización

getLayoutName()

Volver

Autorización

getLines()

Volver

Autorización

getMaster()

Volver

Autorización

getObjectId()

Volver

Autorización

getPageElementById(id)

Parámetros

Volver

Autorización

getPageElements()

Volver

Autorización

getPageType()

Volver

Autorización

getPlaceholder(placeholderType)

Parámetros

Volver

Autorización

getPlaceholder(placeholderType, placeholderIndex)

Parámetros

Volver

Autorización

getPlaceholders()

Volver

Autorización

getShapes()

Volver

Autorización

getSheetsCharts()

Volver

Autorización

getTables()

Volver

Autorización

getVideos()

Volver

Autorización

getWordArts()

Volver

Autorización

group(pageElements)

Parámetros

Volver

Autorización

insertGroup(group)

Parámetros

Volver

Autorización

insertImage(blobSource)

Parámetros

Volver

Autorización

insertImage(blobSource, left, top, width, height)

Parámetros

Volver

Autorización

insertImage(image)

Class Layout

`getBackground()`

`getColorScheme()`

`getGroups()`

`getImages()`

`getLayoutName()`

`getLines()`

`getMaster()`

`getObjectId()`

`getPageElementById(id)`

`getPageElements()`

`getPageType()`

`getPlaceholder(placeholderType)`

`getPlaceholder(placeholderType, placeholderIndex)`

`getPlaceholders()`

`getShapes()`

`getSheetsCharts()`

`getTables()`

`getVideos()`

`getWordArts()`

`group(pageElements)`

`insertGroup(group)`

`insertImage(blobSource)`

`insertImage(blobSource, left, top, width, height)`

`insertImage(image)`

`insertImage(imageUrl)`

`insertImage(imageUrl, left, top, width, height)`

`insertLine(line)`

`insertLine(lineCategory, startConnectionSite, endConnectionSite)`

`insertLine(lineCategory, startLeft, startTop, endLeft, endTop)`

`insertPageElement(pageElement)`

`insertShape(shape)`

`insertShape(shapeType)`

`insertShape(shapeType, left, top, width, height)`

`insertSheetsChart(sourceChart)`

`insertSheetsChart(sourceChart, left, top, width, height)`

`insertSheetsChart(sheetsChart)`

`insertSheetsChartAsImage(sourceChart)`

`insertSheetsChartAsImage(sourceChart, left, top, width, height)`

`insertTable(numRows, numColumns)`

`insertTable(numRows, numColumns, left, top, width, height)`

`insertTable(table)`