Class Layout

Diseño

Un diseño en una presentación.

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

Métodos

MétodoTipo de datos que se muestraDescripción breve
getBackground()PageBackgroundObtiene el fondo de la página.
getColorScheme()ColorSchemeObtiene el ColorScheme asociado con la página.
getGroups()Group[]Muestra la lista de objetos Group en la página.
getImages()Image[]Muestra la lista de objetos Image en la página.
getLayoutName()StringObtiene el nombre del diseño.
getLines()Line[]Muestra la lista de objetos Line en la página.
getMaster()MasterObtiene el modelo en el que se basa el diseño.
getObjectId()StringObtiene el ID único de la página.
getPageElementById(id)PageElementMuestra el PageElement en la página con el ID determinado o null si no existe ninguno.
getPageElements()PageElement[]Muestra la lista de objetos PageElement renderizados en la página.
getPageType()PageTypeObtiene el tipo de la página.
getPlaceholder(placeholderType)PageElementMuestra el objeto PageElement de marcador de posición para un PlaceholderType o null especificado si no hay un marcador de posición coincidente.
getPlaceholder(placeholderType, placeholderIndex)PageElementMuestra el objeto PageElement de marcador de posición 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[]Muestra la lista de objetos PageElement de marcador de posición en la página.
getShapes()Shape[]Muestra la lista de objetos Shape en la página.
getSheetsCharts()SheetsChart[]Muestra la lista de objetos SheetsChart en la página.
getTables()Table[]Muestra la lista de objetos Table en la página.
getVideos()Video[]Muestra la lista de objetos Video en la página.
getWordArts()WordArt[]Muestra la lista de objetos WordArt en la página.
group(pageElements)GroupAgrupa todos los elementos de página especificados.
insertGroup(group)GroupInserta una copia del Group proporcionado en la página.
insertImage(blobSource)ImageInserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado del objeto blob de imagen especificado.
insertImage(blobSource, left, top, width, height)ImageInserta una imagen en la página con la posición y el tamaño proporcionados del blob de imagen especificado.
insertImage(image)ImageInserta una copia del Image proporcionado en la página.
insertImage(imageUrl)ImageInserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado de la URL proporcionada.
insertImage(imageUrl, left, top, width, height)ImageInserta una imagen en la página con la posición y el tamaño proporcionados desde la URL proporcionada.
insertLine(line)LineInserta una copia del Line proporcionado en la página.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineInserta una línea en la página que conecta dos connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)LineInserta una línea en la página.
insertPageElement(pageElement)PageElementInserta una copia del PageElement proporcionado en la página.
insertShape(shape)ShapeInserta una copia del Shape proporcionado en la página.
insertShape(shapeType)ShapeInserta una forma en la página.
insertShape(shapeType, left, top, width, height)ShapeInserta una forma en la página.
insertSheetsChart(sourceChart)SheetsChartInserta un gráfico de Hojas de cálculo de Google en la página.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartInserta 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)SheetsChartInserta una copia del SheetsChart proporcionado en la página.
insertSheetsChartAsImage(sourceChart)ImageInserta un gráfico de Hojas de cálculo de Google como Image en la página.
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageInserta 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)TableInserta una tabla en la página.
insertTable(numRows, numColumns, left, top, width, height)TableInserta una tabla en la página con la posición y el tamaño proporcionados.
insertTable(table)TableInserta una copia del Table proporcionado en la página.
insertTextBox(text)ShapeInserta un cuadro de texto Shape que contiene la cadena proporcionada en la página.
insertTextBox(text, left, top, width, height)ShapeInserta un cuadro de texto Shape que contiene la cadena proporcionada en la página.
insertVideo(videoUrl)VideoInserta un video en la esquina superior izquierda de la página con un tamaño predeterminado.
insertVideo(videoUrl, left, top, width, height)VideoInserta un video en la página con la posición y el tamaño proporcionados.
insertVideo(video)VideoInserta una copia del Video proporcionado en la página.
insertWordArt(wordArt)WordArtInserta una copia del WordArt proporcionado en la página.
remove()voidQuita la página.
replaceAllText(findText, replaceText)IntegerReemplaza todas las instancias de texto que coincidan con el texto de búsqueda por el texto de reemplazo.
replaceAllText(findText, replaceText, matchCase)IntegerReemplaza todas las instancias de texto que coincidan con el texto de búsqueda por el texto de reemplazo.
selectAsCurrentPage()voidSelecciona 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 ámbitos:

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

getColorScheme()

Obtiene el ColorScheme asociado con 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 ámbitos:

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

getGroups()

Muestra 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 ámbitos:

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

getImages()

Muestra 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 ámbitos:

  • 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 ámbitos:

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

getLines()

Muestra 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 ámbitos:

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

getMaster()

Obtiene el modelo 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 ámbitos:

  • 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 ámbitos:

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

getPageElementById(id)

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

Parámetros

NombreTipoDescripción
idStringEs el ID del elemento de página que se recupera.

Volver

PageElement: Es el elemento de 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 ámbitos:

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

getPageElements()

Muestra 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 ámbitos:

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

getPageType()

Obtiene el tipo de la 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 ámbitos:

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

getPlaceholder(placeholderType)

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

Si hay varios marcadores de posición con el mismo tipo, se muestra el que tiene el índice de marcador de posición mínimo. Si hay varios marcadores de posición coincidentes con el mismo índice, se muestra el primero 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

NombreTipoDescripción
placeholderTypePlaceholderType

Volver

PageElement

Autorización

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

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

getPlaceholder(placeholderType, placeholderIndex)

Muestra el objeto PageElement del marcador de posición 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 índice, se muestra el primero 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

NombreTipoDescripción
placeholderTypePlaceholderType
placeholderIndexInteger

Volver

PageElement

Autorización

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

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

getPlaceholders()

Muestra 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 ámbitos:

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

getShapes()

Muestra 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 ámbitos:

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

getSheetsCharts()

Muestra 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 ámbitos:

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

getTables()

Muestra 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 ámbitos:

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

getVideos()

Muestra 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 ámbitos:

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

getWordArts()

Muestra 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 ámbitos:

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

group(pageElements)

Agrupa todos los elementos de página especificados.

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

Parámetros

NombreTipoDescripción
pageElementsPageElement[]Los 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 ámbitos:

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

insertGroup(group)

Inserta una copia del 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 maestras 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 una presentación diferente, 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

NombreTipoDescripción
groupGroupEs 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 ámbitos:

  • 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 objeto blob de imagen especificado.

Cuando se inserta la imagen, se recupera de BlobSource una vez y se almacena una copia para mostrarla en la presentación. Las imágenes deben tener un tamaño inferior a 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

NombreTipoDescripción
blobSourceBlobSourceLos 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 ámbitos:

  • 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 del 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 tener un tamaño inferior a 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 ajusta y se centra en función del 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

NombreTipoDescripción
blobSourceBlobSourceLos datos de la imagen.
leftNumberEs la posición horizontal de la imagen en puntos, medida desde la esquina superior izquierda de la página.
topNumberEs la posición vertical de la imagen en puntos, medida desde la esquina superior izquierda de la página.
widthNumberEs el ancho de la imagen en puntos.
heightNumberEs 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 ámbitos:

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

insertImage(image)

Inserta una copia del 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 de origen en su página respectiva.

Si la imagen proporcionada es un marcador de posición que se copia desde la presentación actual, las propiedades que heredan de las páginas maestras 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 una presentación diferente, 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 del marcador de posición copiada está vacía, no se inserta 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

NombreTipoDescripción
imageImageEs la 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 ámbitos:

  • 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 de la URL proporcionada.

Cuando se inserta la imagen, se recupera de la URL una vez y se almacena una copia para mostrarla en la presentación. Las imágenes deben tener un tamaño inferior a 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 tener más de 2 KB. La URL en sí se guarda con la imagen y se expone a través de Image.getSourceUrl().

Parámetros

NombreTipoDescripción
imageUrlStringEs 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 ámbitos:

  • 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.

Cuando se inserta la imagen, se recupera de la URL una vez y se almacena una copia para mostrarla en la presentación. Las imágenes deben tener un tamaño inferior a 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 tener más de 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 ajusta y se centra en función del tamaño proporcionado.

Parámetros

NombreTipoDescripción
imageUrlStringEs la URL de la imagen.
leftNumberEs la posición horizontal de la imagen en puntos, medida desde la esquina superior izquierda de la página.
topNumberEs la posición vertical de la imagen en puntos, medida desde la esquina superior izquierda de la página.
widthNumberEs el ancho de la imagen en puntos.
heightNumberEs 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 ámbitos:

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

insertLine(line)

Inserta una copia del 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.

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 maestras 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 una presentación diferente, 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 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

NombreTipoDescripción
lineLineEs 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 ámbitos:

  • 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

NombreTipoDescripción
lineCategoryLineCategoryEs la categoría de la línea que se insertará.
startConnectionSiteConnectionSiteEs el sitio de conexión donde se debe conectar el inicio de la línea.
endConnectionSiteConnectionSiteEs 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 ámbitos:

  • 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

NombreTipoDescripción
lineCategoryLineCategoryEs la categoría de la línea que se insertará.
startLeftNumberEs la posición horizontal del punto inicial de la línea, medida en puntos desde la esquina superior izquierda de la página.
startTopNumberEs la posición vertical del punto inicial de la línea, medida en puntos desde la esquina superior izquierda de la página.
endLeftNumberEs la posición horizontal del punto final de la línea, medida en puntos desde la esquina superior izquierda de la página.
endTopNumberEs la 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 ámbitos:

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

insertPageElement(pageElement)

Inserta una copia del 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.

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 maestras 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 una presentación diferente, 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 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

NombreTipoDescripción
pageElementPageElementEs el elemento de 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 ámbitos:

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

insertShape(shape)

Inserta una copia del 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.

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 maestras 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 una presentación diferente, 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 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

NombreTipoDescripción
shapeShapeEs 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 ámbitos:

  • 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

NombreTipoDescripción
shapeTypeShapeTypeEs 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 ámbitos:

  • 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

NombreTipoDescripción
shapeTypeShapeTypeEs el tipo de forma que se insertará.
leftNumberEs la posición horizontal de la forma, medida desde la esquina superior izquierda de la página.
topNumberEs la posición vertical de la forma, medida desde la esquina superior izquierda de la página.
widthNumberEs el ancho de la forma.
heightNumberEs 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 ámbitos:

  • 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 con el gráfico de Hojas de cálculo de Google de origen, lo que le permite actualizarse. Los demás 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

NombreTipoDescripción
sourceChartEmbeddedChartEs 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 ámbitos:

  • 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 en función del tamaño proporcionado.

El gráfico insertado está vinculado con el gráfico de Hojas de cálculo de Google de origen, lo que le permite actualizarse. Los demás 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

NombreTipoDescripción
sourceChartEmbeddedChartEs el gráfico de una hoja de cálculo que se insertará en la página.
leftNumberEs la posición horizontal del gráfico en puntos, medida desde la esquina superior izquierda de la página.
topNumberEs la posición vertical del gráfico en puntos, medida desde la esquina superior izquierda de la página.
widthNumberEs el ancho del gráfico en puntos.
heightNumberEs 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 ámbitos:

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

insertSheetsChart(sheetsChart)

Inserta una copia del 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.

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 maestras 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 una presentación diferente, 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 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

NombreTipoDescripción
sheetsChartSheetsChartEs el gráfico de Hojas de cálculo 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 ámbitos:

  • 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 del gráfico insertada no está vinculada con el gráfico de Hojas de cálculo de Google de origen.

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

NombreTipoDescripción
sourceChartEmbeddedChartEs 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 ámbitos:

  • 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, esta se ajusta y se centra con respecto al tamaño proporcionado.

La imagen insertada del gráfico no está vinculada con el gráfico de Hojas de cálculo de Google de origen.

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

NombreTipoDescripción
sourceChartEmbeddedChartEs el gráfico de una hoja de cálculo que se insertará en la página.
leftNumberEs la posición horizontal del gráfico en puntos, medida desde la esquina superior izquierda de la página.
topNumberEs la posición vertical del gráfico en puntos, medida desde la esquina superior izquierda de la página.
widthNumberEs el ancho del gráfico en puntos.
heightNumberEs 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 ámbitos:

  • 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 las filas y columnas distribuidas de manera uniforme.

Parámetros

NombreTipoDescripción
numRowsIntegerEs la cantidad de filas en la tabla.
numColumnsIntegerEs 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 ámbitos:

  • 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 forma uniforme en la tabla creada.

Parámetros

NombreTipoDescripción
numRowsIntegerEs la cantidad de filas en la tabla.
numColumnsIntegerEs la cantidad de columnas de la tabla.
leftNumberEs la posición horizontal de la tabla, medida desde la esquina superior izquierda de la página.
topNumberEs la posición vertical de la tabla, medida desde la esquina superior izquierda de la página.
widthNumberEs el ancho de la tabla.
heightNumberEs 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 ámbitos:

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

insertTable(table)

Inserta una copia del 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.

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 maestras 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 una presentación diferente, 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 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

NombreTipoDescripción
tableTableEs 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 ámbitos:

  • 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

NombreTipoDescripción
textStringEs 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 ámbitos:

  • 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

NombreTipoDescripción
textStringEs la cadena que debe contener la forma del cuadro de texto.
leftNumberEs la posición horizontal de la forma del cuadro de texto, medida desde la esquina superior izquierda de la página.
topNumberEs la posición vertical de la forma del cuadro de texto, medida desde la esquina superior izquierda de la página.
widthNumberEs el ancho de la forma del cuadro de texto.
heightNumberEs 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 ámbitos:

  • 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

NombreTipoDescripción
videoUrlStringEs la URL del video que se va a 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 ámbitos:

  • 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

NombreTipoDescripción
videoUrlStringEs la URL del video que se va a insertar.
leftNumberEs la posición horizontal del video en puntos, medida desde la esquina superior izquierda de la página.
topNumberEs la posición vertical del video en puntos, medida desde la esquina superior izquierda de la página.
widthNumberEs el ancho del video en puntos.
heightNumberEs la 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 ámbitos:

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

insertVideo(video)

Inserta una copia del 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.

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 maestras 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 una presentación diferente, 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 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

NombreTipoDescripción
videoVideoEs 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 ámbitos:

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

insertWordArt(wordArt)

Inserta una copia del 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.

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 maestras 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 una presentación diferente, 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 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

NombreTipoDescripción
wordArtWordArtEs el grupo que se copiará y se insertará.

Volver

WordArt: Es el texto con formato WordArt insertado.

Autorización

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

  • 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 ámbitos:

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

replaceAllText(findText, replaceText)

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

Parámetros

NombreTipoDescripción
findTextStringEs el texto que se buscará.
replaceTextStringEs el texto que reemplazará el texto coincidente.

Volver

Integer: Es la cantidad de ocurrencias que cambiaron.

Autorización

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

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

replaceAllText(findText, replaceText, matchCase)

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

Parámetros

NombreTipoDescripción
findTextStringEs el texto que se buscará.
replaceTextStringEs el texto que reemplazará el texto coincidente.
matchCaseBooleanSi es true, la búsqueda distingue mayúsculas de minúsculas. Si es false, la búsqueda no distingue mayúsculas de minúsculas.

Volver

Integer: Es la cantidad de ocurrencias que cambiaron.

Autorización

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

  • 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 ámbitos:

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