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 principal.
asSlide()SlideMuestra la página como una diapositiva.
getBackground()PageBackgroundObtiene el fondo de la página.
getColorScheme()ColorSchemeObtiene el ColorScheme asociado a la página.
getGroups()Group[]Muestra la lista de objetos Group de la página.
getImages()Image[]Muestra la lista de objetos Image de la página.
getLines()Line[]Muestra la lista de objetos Line de la página.
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 de marcador de posición PageElement para un PlaceholderType o null especificado si no hay un marcador de posición que coincida.
getPlaceholder(placeholderType, placeholderIndex)PageElementMuestra el objeto de marcador de posición PageElement para un PlaceholderType y un índice de marcador de posición especificados, o null si el marcador de posición no está presente.
getPlaceholders()PageElement[]Muestra la lista de objetos de marcador de posición PageElement en la página.
getShapes()Shape[]Muestra la lista de objetos Shape de la página.
getSheetsCharts()SheetsChart[]Muestra la lista de objetos SheetsChart de la página.
getTables()Table[]Muestra la lista de objetos Table de la página.
getVideos()Video[]Muestra la lista de objetos Video de la página.
getWordArts()WordArt[]Muestra la lista de objetos WordArt de la página.
group(pageElements)GroupAgrupa todos los elementos de página especificados.
insertGroup(group)GroupInserta una copia del elemento 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 desde el 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 desde el BLOB de imagen especificado.
insertImage(image)ImageInserta una copia del elemento Image proporcionado en la página.
insertImage(imageUrl)ImageInserta una imagen en la esquina superior izquierda de la página con el 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 de la URL proporcionada.
insertLine(line)LineInserta una copia del elemento 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 elemento PageElement proporcionado en la página.
insertShape(shape)ShapeInserta una copia del elemento 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 elemento SheetsChart proporcionado en la página.
insertSheetsChartAsImage(sourceChart)ImageInserta un gráfico de Hojas de cálculo de Google como un elemento Image en la página.
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageInserta un gráfico de Hojas de cálculo de Google como un elemento 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 elemento Table proporcionado en la página.
insertTextBox(text)ShapeInserta un cuadro de texto Shape que contiene la string proporcionada en la página.
insertTextBox(text, left, top, width, height)ShapeInserta un cuadro de texto Shape que contiene la string 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 elemento Video proporcionado en la página.
insertWordArt(wordArt)WordArtInserta una copia del elemento WordArt proporcionado en la página.
remove()voidQuita la página.
replaceAllText(findText, replaceText)IntegerReemplaza todas las instancias de texto que coincidan con la búsqueda de texto con texto de reemplazo.
replaceAllText(findText, replaceText, matchCase)IntegerReemplaza todas las instancias de texto que coincidan con la búsqueda de texto con texto de reemplazo.
selectAsCurrentPage()voidSelecciona el Page en la presentación activa como current page selection y quita cualquier selección anterior.

Documentación detallada

asLayout()

Muestra la página como un diseño.

Volver

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

Volver

Master: Es la página como principal.

Autorización

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

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

asSlide()

Muestra la página como una diapositiva.

Volver

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.

Volver

PageBackground: Es el fondo de la página.

Autorización

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

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

getColorScheme()

Obtiene el ColorScheme asociado a la página.

Volver

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

Autorización

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

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

getGroups()

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

Volver

Group[]

Autorización

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

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

getImages()

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

Volver

Image[]

Autorización

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

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

getLines()

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

Volver

Line[]

Autorización

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

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

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.

Volver

String

Autorización

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

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

getPageElementById(id)

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

Parámetros

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

Volver

PageElement: Es el elemento de la página con el ID proporcionado.

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.

Volver

PageElement[]

Autorización

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

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

getPageType()

Obtiene el tipo de 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 alcances:

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

getPlaceholder(placeholderType)

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

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var 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 alcances:

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

getPlaceholder(placeholderType, placeholderIndex)

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

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var 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 alcances:

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

getPlaceholders()

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

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

Volver

PageElement[]

Autorización

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

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

getShapes()

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

Volver

Shape[]

Autorización

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

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

getSheetsCharts()

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

Volver

SheetsChart[]

Autorización

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

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

getTables()

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

Volver

Table[]

Autorización

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

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

getVideos()

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

Volver

Video[]

Autorización

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

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

getWordArts()

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

Volver

WordArt[]

Autorización

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

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

group(pageElements)

Agrupa todos los elementos de página especificados.

Debe haber al menos dos elementos 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 deben agrupar.

Volver

Group: El grupo nuevo.

Autorización

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

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

insertGroup(group)

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

La posición del elemento insertado en esta página se determina a partir de su posición 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 heredadas 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 desde 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 de origen.

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

Volver

Group: 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 desde el BLOB de imagen especificado.

Al insertar la imagen, se recupera de la BlobSource una vez y se almacena una copia para mostrar dentro de la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no deben 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.

Volver

Image: Es la imagen insertada.

Autorización

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

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

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

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

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

A fin de mantener la relación de aspecto de la imagen, esta se ajusta y se centra con respecto al tamaño provisto.

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.
leftNumberPosición horizontal de la imagen en puntos, medida desde la esquina superior izquierda de la página.
topNumberPosición vertical de la imagen en puntos, medida desde la esquina superior izquierda de la página.
widthNumberAncho de la imagen en puntos.
heightNumberLa altura de la imagen expresada en puntos

Volver

Image: Es la imagen insertada.

Autorización

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

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

insertImage(image)

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

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

Si la imagen proporcionada es un marcador de posición que se copia desde la presentación actual, las propiedades que se heredan de la página principal 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 desde una presentación diferente, las propiedades que se heredan de las páginas principales 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.
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á e insertará.

Volver

Image: Es la imagen insertada.

Autorización

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

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

insertImage(imageUrl)

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

Al insertar la imagen, se recupera de la URL una vez y se almacena una copia para mostrar en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no deben superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

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

Parámetros

NombreTipoDescripción
imageUrlStringLa URL de la imagen.

Volver

Image: Es la imagen insertada.

Autorización

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

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

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

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

Al insertar la imagen, se recupera de la URL una vez y se almacena una copia para mostrar en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no deben superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

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

A fin de mantener la relación de aspecto de la imagen, esta se ajusta y se centra con respecto al tamaño provisto.

Parámetros

NombreTipoDescripción
imageUrlStringLa URL de la imagen.
leftNumberPosición horizontal de la imagen en puntos, medida desde la esquina superior izquierda de la página.
topNumberPosición vertical de la imagen en puntos, medida desde la esquina superior izquierda de la página.
widthNumberAncho de la imagen en puntos.
heightNumberLa altura de la imagen expresada en puntos

Volver

Image: Es la imagen insertada.

Autorización

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

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

insertLine(line)

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

La posición del elemento insertado en esta página se determina a partir de su posición 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 heredadas 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 desde 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 de origen.

// 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
lineLineLínea que se copiará e insertará.

Volver

Line: Es la línea insertada.

Autorización

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

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

insertLine(lineCategory, startConnectionSite, endConnectionSite)

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

// Insert a line in the first slide of the presentation connecting two shapes.
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
lineCategoryLineCategoryLa categoría de la línea que se insertará.
startConnectionSiteConnectionSiteEs el sitio de conexión en el que se debe conectar el inicio de la línea.
endConnectionSiteConnectionSiteEl sitio de conexión en el que se debe conectar el final de la línea.

Volver

Line: Es la línea insertada.

Autorización

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

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

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

Inserta una línea en la página.

// Insert a line in the first slide of the presentation.
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
lineCategoryLineCategoryLa categoría de la línea que se insertará.
startLeftNumberPosición horizontal del punto de inicio de la línea, medida en puntos desde la esquina superior izquierda de la página.
startTopNumberPosición vertical del punto de partida de la línea, medida en puntos desde la esquina superior izquierda de la página.
endLeftNumberPosición horizontal del extremo 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.

Volver

Line: Es la línea insertada.

Autorización

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

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

insertPageElement(pageElement)

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

La posición del elemento insertado en esta página se determina a partir de su posición 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 heredadas 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 desde 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 de origen.

// 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á e insertará.

Volver

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 elemento Shape proporcionado en la página.

La posición del elemento insertado en esta página se determina a partir de su posición 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 heredadas 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 desde 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 de origen.

// 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á e insertará.

Volver

Shape: 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
shapeTypeShapeTypeEl tipo de forma que se insertará.

Volver

Shape: 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
shapeTypeShapeTypeEl tipo de forma que se insertará.
leftNumberPosició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.

Volver

Shape: La forma insertada.

Autorización

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

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

insertSheetsChart(sourceChart)

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

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

El gráfico insertado está vinculado al gráfico de Hojas de cálculo de Google de origen que permite que se actualice. Otros 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 en una hoja de cálculo que se insertará en la página.

Volver

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

Autorización

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

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

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

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

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

El gráfico insertado está vinculado al gráfico de Hojas de cálculo de Google de origen que permite que se actualice. Otros 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 en una hoja de cálculo que se insertará en la página.
leftNumberPosició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.
heightNumberCorresponde a la altura del gráfico en puntos.

Volver

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

Autorización

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

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

insertSheetsChart(sheetsChart)

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

La posición del elemento insertado en esta página se determina a partir de su posición 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 heredadas 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 desde 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 de origen.

// 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 de cálculo que se copiará e insertará.

Volver

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 un elemento Image en la página.

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

La imagen insertada del gráfico no está vinculada al gráfico de Hojas de cálculo de Google 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.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.

Parámetros

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

Volver

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

Autorización

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

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

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

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

Para mantener la proporción de la imagen del gráfico, la imagen se ajusta y se centra con respecto al tamaño provisto.

La imagen insertada del gráfico no está vinculada al gráfico de Hojas de cálculo de Google 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.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height);

Parámetros

NombreTipoDescripción
sourceChartEmbeddedChartEl gráfico en una hoja de cálculo que se insertará en la página.
leftNumberPosició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.
heightNumberCorresponde a la altura del gráfico en puntos.

Volver

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

Autorización

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

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

insertTable(numRows, numColumns)

Inserta una tabla en la página.

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

Parámetros

NombreTipoDescripción
numRowsIntegerLa cantidad de filas en la tabla.
numColumnsIntegerLa cantidad de columnas en la tabla.

Volver

Table: 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
numRowsIntegerLa cantidad de filas en la tabla.
numColumnsIntegerLa cantidad de columnas en la tabla.
leftNumberPosición horizontal de la tabla, medida desde la esquina superior izquierda de la página.
topNumberPosició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.

Volver

Table: 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 elemento Table proporcionado en la página.

La posición del elemento insertado en esta página se determina a partir de su posición 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 heredadas 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 desde 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 de origen.

// 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á e insertará.

Volver

Table: 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 string 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
textStringString que debe contener la forma del cuadro de texto.

Volver

Shape: Es la forma del cuadro de texto insertado.

Autorización

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

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

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

Inserta un cuadro de texto Shape que contiene la string 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
textStringString que debe contener la forma del cuadro de texto.
leftNumberPosición horizontal de la forma del cuadro de texto, medida desde la esquina superior izquierda de la página.
topNumberPosició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

Volver

Shape: Es la forma del cuadro de texto insertado.

Autorización

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

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

insertVideo(videoUrl)

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

Por el momento, solo se admiten videos de YouTube.

Parámetros

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

Volver

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.
widthNumberEl ancho del video en puntos.
heightNumberLa altura del video en puntos.

Volver

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 elemento Video proporcionado en la página.

La posición del elemento insertado en esta página se determina a partir de su posición 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 heredadas 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 desde 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 de origen.

// 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á e insertará.

Volver

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 elemento WordArt proporcionado en la página.

La posición del elemento insertado en esta página se determina a partir de su posición 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 heredadas 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 desde 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 de origen.

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

Volver

WordArt: La palabra artística 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 coincidan con la búsqueda de texto con texto de reemplazo. La búsqueda no distingue entre mayúsculas y minúsculas.

Parámetros

NombreTipoDescripción
findTextStringEl texto que se busca.
replaceTextStringEl texto para reemplazar el texto coincidente.

Volver

Integer: Cambió 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 coincidan con la búsqueda de texto con texto de reemplazo.

Parámetros

NombreTipoDescripción
findTextStringEl texto que se busca.
replaceTextStringEl texto para reemplazar el texto coincidente.
matchCaseBooleanSi es true, distingue entre mayúsculas y minúsculas; si es false, no distingue entre mayúsculas y minúsculas.

Volver

Integer: Cambió 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 el Page en la presentación activa como current page selection y quita cualquier selección anterior.

Una secuencia de comandos solo puede acceder a la selección del usuario que ejecuta la secuencia de comandos y solo si la secuencia 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