Class Page

Página

Una página en una presentación.

Métodos

MétodoTipo de datos que se muestraDescripción breve
asLayout()LayoutMuestra la página como un diseño.
asMaster()MasterMuestra la página como diseño maestro.
asSlide()SlideMuestra la página como una diapositiva.
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.
getLines()Line[]Muestra la lista de objetos Line en la página.
getObjectId()StringObtiene el ID único de la página.
getPageElementById(id)PageElementMuestra el PageElement en la página con el ID proporcionado 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 del 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 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.
getPlaceholders()PageElement[]Muestra la lista de objetos PageElement marcadores 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 BLOB de imágenes 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 imágenes 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 en 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 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 con un tamaño predeterminado en la esquina superior izquierda de la página.
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 coinciden con el texto de búsqueda por reemplazar el texto.
replaceAllText(findText, replaceText, matchCase)IntegerReemplaza todas las instancias de texto que coinciden con el texto de búsqueda por reemplazar el texto.
selectAsCurrentPage()voidSelecciona la Page de la presentación activa como la current page selection y quita la selección anterior.

Documentación detallada

asLayout()

Muestra la página como un diseño.

Devolvedor

Layout: Es la página como diseño.

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

asMaster()

Muestra la página como diseño maestro.

Devolvedor

Master: Es la página como diseño maestro.

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

asSlide()

Muestra la página como una diapositiva.

Devolvedor

Slide: Es la página como una diapositiva.

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

getBackground()

Obtiene el fondo de la página.

Devolvedor

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 ColorScheme asociado con la página.

Devolvedor

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()

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

Devolvedor

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()

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

Devolvedor

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

getLines()

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

Devolvedor

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

getObjectId()

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

Devolvedor

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)

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

Parámetros

NombreTipoDescripción
idStringEl ID del elemento de página que se está recuperando.

Devolvedor

PageElement: 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()

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

Devolvedor

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 la página.

Devolvedor

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)

Muestra el objeto PageElement del 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 del mismo tipo, se muestra el que tenga un í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 página de la página.

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

Parámetros

NombreTipoDescripción
placeholderTypePlaceholderType

Devolvedor

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

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 índice y tipo, muestra el primero de la colección de elementos de página de la página.

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

Parámetros

NombreTipoDescripción
placeholderTypePlaceholderType
placeholderIndexInteger

Devolvedor

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

getPlaceholders()

Muestra la lista de objetos PageElement marcadores de posición en la página.

var master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);

Devolvedor

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()

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

Devolvedor

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()

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

Devolvedor

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()

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

Devolvedor

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()

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

Devolvedor

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()

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

Devolvedor

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

Devolvedor

Group: Es el nuevo grupo.

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 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 de origen en la página respectiva.

Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se 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 una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.

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

Parámetros

NombreTipoDescripción
groupGroupEl grupo que se copiará e insertará.

Devolvedor

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 imágenes especificado.

Cuando se inserta la imagen, se obtiene 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.

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

Parámetros

NombreTipoDescripción
blobSourceBlobSourceLos datos de la imagen

Devolvedor

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 del BLOB de imágenes especificado.

La imagen se recupera de la BlobSource proporcionada 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 con respecto al tamaño proporcionado.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
var position = {left: 0, top: 0};
var 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.

Devolvedor

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 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 respectiva página.

Si la imagen proporcionada es un marcador de posición que se copia desde la presentación actual, las propiedades que se 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 se heredan de las páginas principales o de diseño se copian en la imagen de la presentación fuente. 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

Parámetros

NombreTipoDescripción
imageImageLa imagen que se copiará y se insertará.

Devolvedor

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

Cuando se inserta la imagen, se obtiene de la URL una vez 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.

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

Parámetros

NombreTipoDescripción
imageUrlStringLa URL de la imagen.

Devolvedor

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

Cuando se inserta la imagen, se obtiene de la URL una vez 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.

La URL proporcionada debe ser de acceso público y no debe superar los 2 KB. La URL 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 con respecto al tamaño proporcionado.

Parámetros

NombreTipoDescripción
imageUrlStringLa 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.

Devolvedor

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 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 de origen en la página respectiva.

Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se 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 una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.

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

Parámetros

NombreTipoDescripción
lineLineLa línea que se copiará y se insertará.

Devolvedor

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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
var 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á.
startConnectionSiteConnectionSiteSitio de conexión en el que se debe conectar el inicio de la línea.
endConnectionSiteConnectionSiteEs el sitio de conexión en el que se debe conectar el final de la línea.

Devolvedor

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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var startPoint = {left: 10, top: 10};
var 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 de inicio de la línea, medida en puntos desde la esquina superior izquierda de la página.
startTopNumberEs la posición vertical del punto de inicio 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 extremo de la línea, medida en puntos desde la esquina superior izquierda de la página.

Devolvedor

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 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 de origen en la página respectiva.

Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se 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 una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.

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

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

Parámetros

NombreTipoDescripción
pageElementPageElementEl elemento de la página que se copiará y se insertará.

Devolvedor

PageElement: Es el elemento de la 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 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 de origen en la página respectiva.

Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se 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 una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.

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

Parámetros

NombreTipoDescripción
shapeShapeLa forma que se copiará y se insertará.

Devolvedor

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.
var 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á.

Devolvedor

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

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.
topNumberPosición vertical de la forma, medida desde la esquina superior izquierda de la página.
widthNumberEl ancho de la forma.
heightNumberLa altura de la forma.

Devolvedor

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 con el gráfico de origen de Hojas de cálculo de Google, lo que permite actualizarlo. Los demás colaboradores pueden ver el vínculo a la hoja de cálculo de origen.

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

Parámetros

NombreTipoDescripción
sourceChartEmbeddedChartEl gráfico de una hoja de cálculo que se insertará en la página.

Devolvedor

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 se centra con respecto al tamaño proporcionado.

El gráfico insertado está vinculado con el gráfico de origen de Hojas de cálculo de Google, lo que permite actualizarlo. Los demás colaboradores pueden ver el vínculo a la hoja de cálculo de origen.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var 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
sourceChartEmbeddedChartEl 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.
widthNumberEl ancho del gráfico en puntos.
heightNumberLa altura del gráfico en puntos.

Devolvedor

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 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 de origen en la página respectiva.

Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se 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 una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.

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

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

Parámetros

NombreTipoDescripción
sheetsChartSheetsChartEl gráfico de hojas que se copiará y se insertará.

Devolvedor

SheetsChart: Es el gráfico de hojas insertadas.

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 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 que se insertó no está vinculada con el gráfico de origen de Hojas de cálculo de Google.

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

Parámetros

NombreTipoDescripción
sourceChartEmbeddedChartEl gráfico de una hoja de cálculo que se insertará en la página.

Devolvedor

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 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 en relación con el tamaño proporcionado.

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var 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
sourceChartEmbeddedChartEl 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.
widthNumberEl ancho del gráfico en puntos.
heightNumberLa altura del gráfico en puntos.

Devolvedor

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

NombreTipoDescripción
numRowsIntegerEs la cantidad de filas de la tabla.
numColumnsIntegerEs la cantidad de columnas de la tabla.

Devolvedor

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

NombreTipoDescripción
numRowsIntegerEs la cantidad de filas de 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.
widthNumberEl ancho de la tabla.
heightNumberLa altura mínima de la tabla. La altura real de la tabla procesada depende de factores como el tamaño de la fuente del texto.

Devolvedor

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 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 de origen en la página respectiva.

Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se 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 una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.

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

Parámetros

NombreTipoDescripción
tableTableLa tabla que se copiará y se insertará.

Devolvedor

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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.

Parámetros

NombreTipoDescripción
textStringCadena que debe contener la forma del cuadro de texto.

Devolvedor

Shape: Es la forma del cuadro de texto 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, 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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.

Parámetros

NombreTipoDescripción
textStringCadena 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.
widthNumberEl ancho de la forma del cuadro de texto.
heightNumberLa altura de la forma del cuadro de texto.

Devolvedor

Shape: Es la forma del cuadro de texto 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

insertVideo(videoUrl)

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

Por el momento, solo se admiten videos de YouTube.

Parámetros

NombreTipoDescripción
videoUrlStringLa URL del video que se insertará.

Devolvedor

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

NombreTipoDescripción
videoUrlStringLa URL del video que se 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.

Devolvedor

Video: 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 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 de origen en la página respectiva.

Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se 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 una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.

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

Parámetros

NombreTipoDescripción
videoVideoEl video que se copiará y se insertará.

Devolvedor

Video: 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 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 de origen en la página respectiva.

Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se 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 una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.

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

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

Parámetros

NombreTipoDescripción
wordArtWordArtEl grupo que se copiará e insertará.

Devolvedor

WordArt: Es la representación de la palabra 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

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 de texto que coinciden con el texto de búsqueda por reemplazar el texto. La búsqueda no distingue mayúsculas de minúsculas.

Parámetros

NombreTipoDescripción
findTextStringEl texto a buscar.
replaceTextStringTexto que reemplazará el texto coincidente.

Devolvedor

Integer: Se modificó la cantidad de repeticiones.

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 de texto que coinciden con el texto de búsqueda por reemplazar el texto.

Parámetros

NombreTipoDescripción
findTextStringEl texto a buscar.
replaceTextStringTexto que reemplazará el texto coincidente.
matchCaseBooleanSi es true, la búsqueda distingue mayúsculas de minúsculas. Si es false, no lo hace.

Devolvedor

Integer: Se modificó la cantidad de repeticiones.

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 la Page de la presentación activa como la current page selection y quita la selección anterior.

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

// Select the first slide as the current page selection and replace any previous selection.
var 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