Una página en una presentación
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
asLayout() | Layout | Muestra la página como un diseño. |
asMaster() | Master | Muestra la página como principal. |
asSlide() | Slide | Muestra la página como una diapositiva. |
getBackground() | PageBackground | Obtiene el fondo de la página. |
getColorScheme() | ColorScheme | Obtiene 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() | String | Obtiene el ID único de la página. |
getPageElementById(id) | PageElement | Muestra 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() | PageType | Obtiene el tipo de la página. |
getPlaceholder(placeholderType) | PageElement | 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. |
getPlaceholder(placeholderType, placeholderIndex) | PageElement | 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. |
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) | Group | Agrupa todos los elementos de página especificados. |
insertGroup(group) | Group | Inserta una copia del elemento Group proporcionado en la página. |
insertImage(blobSource) | Image | Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado desde el BLOB de imagen especificado. |
insertImage(blobSource, left, top, width, height) | Image | Inserta una imagen en la página con la posición y el tamaño proporcionados desde el BLOB de imagen especificado. |
insertImage(image) | Image | Inserta una copia del elemento Image proporcionado en la página. |
insertImage(imageUrl) | Image | Inserta 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) | Image | Inserta una imagen en la página con la posición y el tamaño proporcionados de la URL proporcionada. |
insertLine(line) | Line | Inserta una copia del elemento Line proporcionado en la página. |
insertLine(lineCategory, startConnectionSite, endConnectionSite) | Line | Inserta una línea en la página que conecta dos connection sites . |
insertLine(lineCategory, startLeft, startTop, endLeft, endTop) | Line | Inserta una línea en la página. |
insertPageElement(pageElement) | PageElement | Inserta una copia del elemento PageElement proporcionado en la página. |
insertShape(shape) | Shape | Inserta una copia del elemento Shape proporcionado en la página. |
insertShape(shapeType) | Shape | Inserta una forma en la página. |
insertShape(shapeType, left, top, width, height) | Shape | Inserta una forma en la página. |
insertSheetsChart(sourceChart) | SheetsChart | Inserta un gráfico de Hojas de cálculo de Google en la página. |
insertSheetsChart(sourceChart, left, top, width, height) | SheetsChart | Inserta un gráfico de Hojas de cálculo de Google en la página con la posición y el tamaño proporcionados. |
insertSheetsChart(sheetsChart) | SheetsChart | Inserta una copia del elemento SheetsChart proporcionado en la página. |
insertSheetsChartAsImage(sourceChart) | Image | Inserta un gráfico de Hojas de cálculo de Google como un elemento Image en la página. |
insertSheetsChartAsImage(sourceChart, left, top, width, height) | Image | Inserta un gráfico de Hojas de cálculo de Google como un elemento Image en la página con la posición y el tamaño proporcionados. |
insertTable(numRows, numColumns) | Table | Inserta una tabla en la página. |
insertTable(numRows, numColumns, left, top, width, height) | Table | Inserta una tabla en la página con la posición y el tamaño proporcionados. |
insertTable(table) | Table | Inserta una copia del elemento Table proporcionado en la página. |
insertTextBox(text) | Shape | Inserta un cuadro de texto Shape que contiene la string proporcionada en la página. |
insertTextBox(text, left, top, width, height) | Shape | Inserta un cuadro de texto Shape que contiene la string proporcionada en la página. |
insertVideo(videoUrl) | Video | Inserta un video en la esquina superior izquierda de la página con un tamaño predeterminado. |
insertVideo(videoUrl, left, top, width, height) | Video | Inserta un video en la página con la posición y el tamaño proporcionados. |
insertVideo(video) | Video | Inserta una copia del elemento Video proporcionado en la página. |
insertWordArt(wordArt) | WordArt | Inserta una copia del elemento WordArt proporcionado en la página. |
remove() | void | Quita la página. |
replaceAllText(findText, replaceText) | Integer | Reemplaza todas las instancias de texto que coincidan con la búsqueda de texto con texto de reemplazo. |
replaceAllText(findText, replaceText, matchCase) | Integer | Reemplaza todas las instancias de texto que coincidan con la búsqueda de texto con texto de reemplazo. |
selectAsCurrentPage() | void | Selecciona 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()
getImages()
getLines()
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
Nombre | Tipo | Descripción |
---|---|---|
id | String | El 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
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()
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
Nombre | Tipo | Descripción |
---|---|---|
placeholderType | PlaceholderType |
Volver
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
Nombre | Tipo | Descripción |
---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
Volver
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
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()
getSheetsCharts()
Muestra la lista de objetos SheetsChart
de la página.
Volver
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()
getVideos()
getWordArts()
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
Nombre | Tipo | Descripción |
---|---|---|
pageElements | PageElement[] | 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
Nombre | Tipo | Descripción |
---|---|---|
group | Group | El 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
Nombre | Tipo | Descripción |
---|---|---|
blobSource | BlobSource | Los datos de la imagen. |
Volver
Image
: Es la imagen insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource, left, top, width, height)
Inserta una imagen en la página con la posición y el tamaño proporcionados desde el BLOB de imagen especificado.
La imagen se recupera del BlobSource
proporcionado una vez en el momento de la inserción y se almacena una copia para 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
Nombre | Tipo | Descripción |
---|---|---|
blobSource | BlobSource | Los datos de la imagen. |
left | Number | Posición horizontal de la imagen en puntos, medida desde la esquina superior izquierda de la página. |
top | Number | Posición vertical de la imagen en puntos, medida desde la esquina superior izquierda de la página. |
width | Number | Ancho de la imagen en puntos. |
height | Number | La 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
Nombre | Tipo | Descripción |
---|---|---|
image | Image | La 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
Nombre | Tipo | Descripción |
---|---|---|
imageUrl | String | La URL de la imagen. |
Volver
Image
: Es la imagen insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl, left, top, width, height)
Inserta una imagen en la página con la posición y el tamaño proporcionados 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
Nombre | Tipo | Descripción |
---|---|---|
imageUrl | String | La URL de la imagen. |
left | Number | Posición horizontal de la imagen en puntos, medida desde la esquina superior izquierda de la página. |
top | Number | Posición vertical de la imagen en puntos, medida desde la esquina superior izquierda de la página. |
width | Number | Ancho de la imagen en puntos. |
height | Number | La 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
Nombre | Tipo | Descripción |
---|---|---|
line | Line | Lí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
Nombre | Tipo | Descripción |
---|---|---|
lineCategory | LineCategory | La categoría de la línea que se insertará. |
startConnectionSite | ConnectionSite | Es el sitio de conexión en el que se debe conectar el inicio de la línea. |
endConnectionSite | ConnectionSite | El 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
Nombre | Tipo | Descripción |
---|---|---|
lineCategory | LineCategory | La categoría de la línea que se insertará. |
startLeft | Number | Posición horizontal del punto de inicio de la línea, medida en puntos desde la esquina superior izquierda de la página. |
startTop | Number | Posición vertical del punto de partida de la línea, medida en puntos desde la esquina superior izquierda de la página. |
endLeft | Number | Posición horizontal del extremo de la línea, medida en puntos desde la esquina superior izquierda de la página. |
endTop | Number | Es 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
Nombre | Tipo | Descripción |
---|---|---|
pageElement | PageElement | El 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
Nombre | Tipo | Descripción |
---|---|---|
shape | Shape | La 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
Nombre | Tipo | Descripción |
---|---|---|
shapeType | ShapeType | El 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
Nombre | Tipo | Descripción |
---|---|---|
shapeType | ShapeType | El tipo de forma que se insertará. |
left | Number | Posición horizontal de la forma, medida desde la esquina superior izquierda de la página. |
top | Number | Posición vertical de la forma, medida desde la esquina superior izquierda de la página. |
width | Number | El ancho de la forma. |
height | Number | La 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
Nombre | Tipo | Descripción |
---|---|---|
sourceChart | EmbeddedChart | El 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
Nombre | Tipo | Descripción |
---|---|---|
sourceChart | EmbeddedChart | El gráfico en una hoja de cálculo que se insertará en la página. |
left | Number | Posición horizontal del gráfico en puntos, medida desde la esquina superior izquierda de la página. |
top | Number | Es la posición vertical del gráfico en puntos, medida desde la esquina superior izquierda de la página. |
width | Number | El ancho del gráfico en puntos. |
height | Number | Corresponde 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
Nombre | Tipo | Descripción |
---|---|---|
sheetsChart | SheetsChart | El 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
Nombre | Tipo | Descripción |
---|---|---|
sourceChart | EmbeddedChart | El 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
Nombre | Tipo | Descripción |
---|---|---|
sourceChart | EmbeddedChart | El gráfico en una hoja de cálculo que se insertará en la página. |
left | Number | Posición horizontal del gráfico en puntos, medida desde la esquina superior izquierda de la página. |
top | Number | Es la posición vertical del gráfico en puntos, medida desde la esquina superior izquierda de la página. |
width | Number | El ancho del gráfico en puntos. |
height | Number | Corresponde 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
Nombre | Tipo | Descripción |
---|---|---|
numRows | Integer | La cantidad de filas en la tabla. |
numColumns | Integer | La 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
Nombre | Tipo | Descripción |
---|---|---|
numRows | Integer | La cantidad de filas en la tabla. |
numColumns | Integer | La cantidad de columnas en la tabla. |
left | Number | Posición horizontal de la tabla, medida desde la esquina superior izquierda de la página. |
top | Number | Posición vertical de la tabla, medida desde la esquina superior izquierda de la página. |
width | Number | El ancho de la tabla. |
height | Number | La 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
Nombre | Tipo | Descripción |
---|---|---|
table | Table | La 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
Nombre | Tipo | Descripción |
---|---|---|
text | String | String 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
Nombre | Tipo | Descripción |
---|---|---|
text | String | String que debe contener la forma del cuadro de texto. |
left | Number | Posición horizontal de la forma del cuadro de texto, medida desde la esquina superior izquierda de la página. |
top | Number | Posición vertical de la forma del cuadro de texto, medida desde la esquina superior izquierda de la página. |
width | Number | El ancho de la forma del cuadro de texto. |
height | Number | La altura de la forma del cuadro de texto |
Volver
Shape
: Es la forma del cuadro de texto insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl)
Inserta un video en la esquina superior izquierda de la página con un tamaño predeterminado.
Por el momento, solo se admiten videos de YouTube.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
videoUrl | String | La 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
Nombre | Tipo | Descripción |
---|---|---|
videoUrl | String | La URL del video que se insertará. |
left | Number | Es la posición horizontal del video en puntos, medida desde la esquina superior izquierda de la página. |
top | Number | Es la posición vertical del video en puntos, medida desde la esquina superior izquierda de la página. |
width | Number | El ancho del video en puntos. |
height | Number | La 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
Nombre | Tipo | Descripción |
---|---|---|
video | Video | El 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
Nombre | Tipo | Descripción |
---|---|---|
wordArt | WordArt | El 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
Nombre | Tipo | Descripción |
---|---|---|
findText | String | El texto que se busca. |
replaceText | String | El 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
Nombre | Tipo | Descripción |
---|---|---|
findText | String | El texto que se busca. |
replaceText | String | El texto para reemplazar el texto coincidente. |
matchCase | Boolean | Si 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