Un maestro en una presentación.
Los diseños maestros contienen todos los elementos de página comunes y las propiedades comunes de un conjunto de diseños. Tienen tres propósitos:
- Las formas de los marcadores de posición de un diseño maestro contienen los estilos de texto y las propiedades de forma predeterminados de todas las formas de marcadores de posición de las páginas que usan ese diseño maestro.
- Las propiedades de una página principal definen las propiedades comunes de la página que heredan sus diseños.
- Las demás formas de la diapositiva maestra aparecerán en todas las que usen ese diseño maestro, independientemente de su diseño.
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
getBackground() | PageBackground | Obtiene el fondo de la página. |
getColorScheme() | ColorScheme | Obtiene el ColorScheme asociado con la página. |
getGroups() | Group[] | Muestra la lista de objetos Group en la página. |
getImages() | Image[] | Muestra la lista de objetos Image en la página. |
getLayouts() | Layout[] | Obtiene los diseños de este diseño maestro. |
getLines() | Line[] | Muestra la lista de objetos Line en 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 proporcionado 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 PageElement del marcador de posición para un PlaceholderType o null especificado si no hay un marcador de posición coincidente. |
getPlaceholder(placeholderType, placeholderIndex) | PageElement | Muestra el objeto PageElement del marcador de posición para un PlaceholderType especificado y un índice de marcador de posición, o null si el marcador de posición no está presente. |
getPlaceholders() | PageElement[] | Muestra la lista de objetos PageElement marcadores de posición en la página. |
getShapes() | Shape[] | Muestra la lista de objetos Shape en la página. |
getSheetsCharts() | SheetsChart[] | Muestra la lista de objetos SheetsChart en la página. |
getTables() | Table[] | Muestra la lista de objetos Table en la página. |
getVideos() | Video[] | Muestra la lista de objetos Video en la página. |
getWordArts() | WordArt[] | Muestra la lista de objetos WordArt en la página. |
group(pageElements) | Group | Agrupa todos los elementos de página especificados. |
insertGroup(group) | Group | Inserta una copia del Group proporcionado en la página. |
insertImage(blobSource) | Image | Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado del BLOB de imágenes especificado. |
insertImage(blobSource, left, top, width, height) | Image | Inserta una imagen en la página con la posición y el tamaño proporcionados del BLOB de imágenes especificado. |
insertImage(image) | Image | Inserta una copia del Image proporcionado en la página. |
insertImage(imageUrl) | Image | Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado 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 en la URL proporcionada. |
insertLine(line) | Line | Inserta una copia del 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 PageElement proporcionado en la página. |
insertShape(shape) | Shape | Inserta una copia del 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 SheetsChart proporcionado en la página. |
insertSheetsChartAsImage(sourceChart) | Image | Inserta un gráfico de Hojas de cálculo de Google como Image en la página. |
insertSheetsChartAsImage(sourceChart, left, top, width, height) | Image | Inserta un gráfico de Hojas de cálculo de Google como Image en la página con la posición y el tamaño proporcionados. |
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 Table proporcionado en la página. |
insertTextBox(text) | Shape | Inserta un cuadro de texto Shape que contiene la cadena proporcionada en la página. |
insertTextBox(text, left, top, width, height) | Shape | Inserta un cuadro de texto Shape que contiene la cadena proporcionada en la página. |
insertVideo(videoUrl) | Video | Inserta un video con un tamaño predeterminado en la esquina superior izquierda de la página. |
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 Video proporcionado en la página. |
insertWordArt(wordArt) | WordArt | Inserta una copia del WordArt proporcionado en la página. |
remove() | void | Quita la página. |
replaceAllText(findText, replaceText) | Integer | Reemplaza todas las instancias de texto que coinciden con el texto de búsqueda por reemplazar el texto. |
replaceAllText(findText, replaceText, matchCase) | Integer | Reemplaza todas las instancias de texto que coinciden con el texto de búsqueda por reemplazar el texto. |
selectAsCurrentPage() | void | Selecciona la Page de la presentación activa como la current page selection y quita la selección anterior. |
Documentación detallada
getBackground()
Obtiene el fondo de la página.
Devolvedor
PageBackground
: Es el fondo de la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getColorScheme()
Obtiene el ColorScheme
asociado con la página.
Devolvedor
ColorScheme
: Es el esquema de colores de la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getGroups()
getImages()
getLayouts()
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.
Devolvedor
String
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementById(id)
Muestra el PageElement
en la página con el ID proporcionado o null
si no existe ninguno.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
id | String | El ID del elemento de página que se está recuperando. |
Devolvedor
PageElement
: Es el elemento de la página con el ID determinado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElements()
Muestra la lista de objetos PageElement
renderizados en la página.
Devolvedor
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageType()
Obtiene el tipo de la página.
Devolvedor
PageType
: Es el tipo de página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType)
Muestra el objeto PageElement
del marcador de posición para un PlaceholderType
o null
especificado si no hay un marcador de posición coincidente.
Si hay varios marcadores de posición del mismo tipo, se muestra el que tenga un índice de marcador de posición mínimo. Si hay varios marcadores de posición coincidentes con el mismo índice, se muestra el primero de la colección de elementos de página de la página.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
placeholderType | PlaceholderType |
Devolvedor
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType, placeholderIndex)
Muestra el objeto PageElement
del marcador de posición para un PlaceholderType
especificado y un índice de marcador de posición, o null
si el marcador de posición no está presente.
Si hay varios marcadores de posición con el mismo índice y tipo, muestra el primero de la colección de elementos de página de la página.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
Devolvedor
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholders()
Muestra la lista de objetos PageElement
marcadores de posición en la página.
var master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);
Devolvedor
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
en la página.
Devolvedor
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 de página en la misma página que no estén en otro grupo. Algunos elementos de la página, como Videos
, Tables
y placeholder Shapes
, no se pueden agrupar.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
pageElements | PageElement[] | Los elementos que se agruparán. |
Devolvedor
Group
: Es el nuevo grupo.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertGroup(group)
Inserta una copia del Group
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento de origen en la página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se heredan de las páginas principales o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.
// Copy a group between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var group = otherPresentationSlide.getGroups()[0]; currentPresentationSlide.insertGroup(group); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
group | Group | El grupo que se copiará e insertará. |
Devolvedor
Group
: Es el grupo insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource)
Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado del BLOB de imágenes especificado.
Cuando se inserta la imagen, se obtiene de BlobSource
una vez y se almacena una copia para mostrarla en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); slide.insertImage(image);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
blobSource | BlobSource | Los datos de la imagen |
Devolvedor
Image
: Es la imagen insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource, left, top, width, height)
Inserta una imagen en la página con la posición y el tamaño proporcionados del BLOB de imágenes especificado.
La imagen se recupera de la BlobSource
proporcionada una vez en el momento de la inserción y se almacena una copia para mostrarla dentro de la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
Para mantener la relación de aspecto de la imagen, esta se ajusta y se centra con respecto al tamaño proporcionado.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); var position = {left: 0, top: 0}; var size = {width: 300, height: 100}; slide.insertImage(image, position.left, position.top, size.width, size.height);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
blobSource | BlobSource | Los datos de la imagen |
left | Number | Es la posición horizontal de la imagen en puntos, medida desde la esquina superior izquierda de la página. |
top | Number | Es la posición vertical de la imagen en puntos, medida desde la esquina superior izquierda de la página. |
width | Number | Es el ancho de la imagen en puntos. |
height | Number | Es la altura de la imagen en puntos. |
Devolvedor
Image
: Es la imagen insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(image)
Inserta una copia del Image
proporcionado en la página.
La posición de las imágenes insertadas en esta página se determina a partir de la posición de la imagen de origen en su respectiva página.
Si la imagen proporcionada es un marcador de posición que se copia desde la presentación actual, las propiedades que se heredan de las páginas principales o de diseño también se heredan en la imagen insertada.
Si la imagen proporcionada es un marcador de posición que se copia de otra presentación, las propiedades que se heredan de las páginas principales o de diseño se copian en la imagen de la presentación fuente. Si la imagen del marcador de posición copiada está vacía, no se inserta nada en la presentación de destino.
// Copy an image between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var image = otherPresentationSlide.getImages[0]; currentPresentationSlide.insertImage(image);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
image | Image | La imagen que se copiará y se insertará. |
Devolvedor
Image
: Es la imagen insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl)
Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado de la URL proporcionada.
Cuando se inserta la imagen, se obtiene de la URL una vez y se almacena una copia para mostrarla dentro de la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
La URL proporcionada debe ser de acceso público y no debe superar los 2 KB. La URL se guarda con la imagen y se expone a través de Image.getSourceUrl()
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
imageUrl | String | La URL de la imagen. |
Devolvedor
Image
: Es la imagen insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl, left, top, width, height)
Inserta una imagen en la página con la posición y el tamaño proporcionados en la URL proporcionada.
Cuando se inserta la imagen, se obtiene de la URL una vez y se almacena una copia para mostrarla dentro de la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
La URL proporcionada debe ser de acceso público y no debe superar los 2 KB. La URL se guarda con la imagen y se expone a través de Image.getSourceUrl()
.
Para mantener la relación de aspecto de la imagen, esta se ajusta y se centra con respecto al tamaño proporcionado.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
imageUrl | String | La URL de la imagen. |
left | Number | Es la posición horizontal de la imagen en puntos, medida desde la esquina superior izquierda de la página. |
top | Number | Es la posición vertical de la imagen en puntos, medida desde la esquina superior izquierda de la página. |
width | Number | Es el ancho de la imagen en puntos. |
height | Number | Es la altura de la imagen en puntos. |
Devolvedor
Image
: Es la imagen insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(line)
Inserta una copia del Line
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento de origen en la página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se heredan de las páginas principales o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.
// Copy a line between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var line = otherPresentationSlide.getLines[0]; currentPresentationSlide.insertLine(line);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
line | Line | La línea que se copiará y se insertará. |
Devolvedor
Line
: Es la línea insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startConnectionSite, endConnectionSite)
Inserta una línea en la página que conecta dos connection sites
. Los dos sitios de conexión deben estar en esta página.
// Insert a line in the first slide of the presentation connecting two shapes. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1]);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
lineCategory | LineCategory | Es la categoría de la línea que se insertará. |
startConnectionSite | ConnectionSite | Sitio de conexión en el que se debe conectar el inicio de la línea. |
endConnectionSite | ConnectionSite | Es el sitio de conexión en el que se debe conectar el final de la línea. |
Devolvedor
Line
: Es la línea insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)
Inserta una línea en la página.
// Insert a line in the first slide of the presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var startPoint = {left: 10, top: 10}; var endPoint = {left: 40, top: 40}; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
lineCategory | LineCategory | Es la categoría de la línea que se insertará. |
startLeft | Number | Es la posición horizontal del punto de inicio de la línea, medida en puntos desde la esquina superior izquierda de la página. |
startTop | Number | Es la posición vertical del punto de inicio de la línea, medida en puntos desde la esquina superior izquierda de la página. |
endLeft | Number | Es la posición horizontal del punto final 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. |
Devolvedor
Line
: Es la línea insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertPageElement(pageElement)
Inserta una copia del PageElement
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento de origen en la página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se heredan de las páginas principales o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.
// Copy a page element between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
pageElement | PageElement | El elemento de la página que se copiará y se insertará. |
Devolvedor
PageElement
: Es el elemento de la página insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shape)
Inserta una copia del Shape
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento de origen en la página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se heredan de las páginas principales o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.
// Copy a shape between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var shape = otherPresentationSlide.getShapes[0]; currentPresentationSlide.insertShape(shape); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
shape | Shape | La forma que se copiará y se insertará. |
Devolvedor
Shape
: Es la forma insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType)
Inserta una forma en la página.
La forma se inserta con un tamaño predeterminado en la esquina superior izquierda de la página.
// Insert a shape in the first slide of the presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
shapeType | ShapeType | Es el tipo de forma que se insertará. |
Devolvedor
Shape
: Es la forma insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType, left, top, width, height)
Inserta una forma en la página.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
shapeType | ShapeType | Es el tipo de forma que se insertará. |
left | Number | Es la 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. |
Devolvedor
Shape
: Es la forma insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart)
Inserta un gráfico de Hojas de cálculo de Google en la página.
El gráfico se inserta con un tamaño predeterminado en la esquina superior izquierda de la página.
El gráfico insertado está vinculado con el gráfico de origen de Hojas de cálculo de Google, lo que permite actualizarlo. Los demás colaboradores pueden ver el vínculo a la hoja de cálculo de origen.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sourceChart | EmbeddedChart | El gráfico de una hoja de cálculo que se insertará en la página. |
Devolvedor
SheetsChart
: Es el gráfico insertado en la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart, left, top, width, height)
Inserta un gráfico de Hojas de cálculo de Google en la página con la posición y el tamaño proporcionados.
Para mantener la relación de aspecto del gráfico, este se ajusta y se centra con respecto al tamaño proporcionado.
El gráfico insertado está vinculado con el gráfico de origen de Hojas de cálculo de Google, lo que permite actualizarlo. Los demás colaboradores pueden ver el vínculo a la hoja de cálculo de origen.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var position = {left: 0, top: 0}; var size = {width: 200, height: 200}; // Also available for Layout, Master, and Page. slide.insertSheetsChart( chart, position.left, position.top, size.width, size.height);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sourceChart | EmbeddedChart | El gráfico de una hoja de cálculo que se insertará en la página. |
left | Number | Es la 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 | La altura del gráfico en puntos. |
Devolvedor
SheetsChart
: Es el gráfico insertado en la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sheetsChart)
Inserta una copia del SheetsChart
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento de origen en la página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se heredan de las páginas principales o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.
// Copy a sheets chart between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sheetsChart | SheetsChart | El gráfico de hojas que se copiará y se insertará. |
Devolvedor
SheetsChart
: Es el gráfico de hojas insertadas.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart)
Inserta un gráfico de Hojas de cálculo de Google como Image
en la página.
La imagen del gráfico se inserta con un tamaño predeterminado en la esquina superior izquierda de la página.
La imagen del gráfico que se insertó no está vinculada con el gráfico de origen de Hojas de cálculo de Google.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sourceChart | EmbeddedChart | El gráfico de una hoja de cálculo que se insertará en la página. |
Devolvedor
Image
: Es la imagen insertada del gráfico en la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart, left, top, width, height)
Inserta un gráfico de Hojas de cálculo de Google como Image
en la página con la posición y el tamaño proporcionados.
Para mantener la relación de aspecto de la imagen del gráfico, esta se ajusta y se centra en relación con el tamaño proporcionado.
La imagen insertada del gráfico no está vinculada con el gráfico de origen de Hojas de cálculo de Google.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var position = {left: 0, top: 0}; var size = {width: 200, height: 200}; // Also available for Layout, Master, and Page. slide.insertSheetsChartAsImage( chart, position.left, position.right, size.width, size.height);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sourceChart | EmbeddedChart | El gráfico de una hoja de cálculo que se insertará en la página. |
left | Number | Es la 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 | La altura del gráfico en puntos. |
Devolvedor
Image
: Es la imagen insertada del gráfico en la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns)
Inserta una tabla en la página.
La tabla se centra en la página con el tamaño predeterminado y filas y columnas distribuidas de manera uniforme.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
numRows | Integer | Es la cantidad de filas de la tabla. |
numColumns | Integer | Es la cantidad de columnas de la tabla. |
Devolvedor
Table
: Es la tabla insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns, left, top, width, height)
Inserta una tabla en la página con la posición y el tamaño proporcionados.
Las filas y las columnas se distribuyen de manera uniforme en la tabla creada.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
numRows | Integer | Es la cantidad de filas de la tabla. |
numColumns | Integer | Es la cantidad de columnas de la tabla. |
left | Number | Es la posición horizontal de la tabla, medida desde la esquina superior izquierda de la página. |
top | Number | Es la 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. |
Devolvedor
Table
: Es la tabla insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(table)
Inserta una copia del Table
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento de origen en la página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se heredan de las páginas principales o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.
// Copy a table between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var table = otherPresentationSlide.getTables[0]; currentPresentationSlide.insertTable(table); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
table | Table | La tabla que se copiará y se insertará. |
Devolvedor
Table
: Es la tabla insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTextBox(text)
Inserta un cuadro de texto Shape
que contiene la cadena proporcionada en la página.
La forma del cuadro de texto se inserta con un tamaño predeterminado en la esquina superior izquierda de la página.
// Insert text box with "Hello" on the first slide of presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Cadena que debe contener la forma del cuadro de texto. |
Devolvedor
Shape
: Es la forma del cuadro de texto insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTextBox(text, left, top, width, height)
Inserta un cuadro de texto Shape
que contiene la cadena proporcionada en la página.
// Insert text box with "Hello" on the first slide of presentation. This text box is a square // with a length of 10 points on each side. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Cadena que debe contener la forma del cuadro de texto. |
left | Number | Es la posición horizontal de la forma del cuadro de texto, medida desde la esquina superior izquierda de la página. |
top | Number | Es la 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. |
Devolvedor
Shape
: Es la forma del cuadro de texto insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl)
Inserta un video con un tamaño predeterminado en la esquina superior izquierda de la página.
Por el momento, solo se admiten videos de YouTube.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
videoUrl | String | La URL del video que se insertará. |
Devolvedor
Video
: El video insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl, left, top, width, height)
Inserta un video en la página con la posición y el tamaño proporcionados.
Por el momento, solo se admiten videos de YouTube.
Parámetros
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 | Es el ancho del video en puntos. |
height | Number | Es la altura del video en puntos. |
Devolvedor
Video
: El video insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(video)
Inserta una copia del Video
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento de origen en la página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se heredan de las páginas principales o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.
// Copy a video between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var video = otherPresentationSlide.getVideos[0]; currentPresentationSlide.insertVideo(video); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
video | Video | El video que se copiará y se insertará. |
Devolvedor
Video
: El video insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertWordArt(wordArt)
Inserta una copia del WordArt
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento de origen en la página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que se heredan de las páginas principales o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que se heredan de las páginas principales o de diseño se copian en el elemento de la presentación fuente.
// Copy a word art between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
wordArt | WordArt | El grupo que se copiará e insertará. |
Devolvedor
WordArt
: Es la representación de la palabra insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Quita la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText)
Reemplaza todas las instancias de texto que coinciden con el texto de búsqueda por reemplazar el texto. La búsqueda no distingue mayúsculas de minúsculas.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
findText | String | El texto a buscar. |
replaceText | String | Texto que reemplazará el texto coincidente. |
Devolvedor
Integer
: Se modificó la cantidad de repeticiones.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
Reemplaza todas las instancias de texto que coinciden con el texto de búsqueda por reemplazar el texto.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
findText | String | El texto a buscar. |
replaceText | String | Texto que reemplazará el texto coincidente. |
matchCase | Boolean | Si es true , la búsqueda distingue mayúsculas de minúsculas. Si es false , no lo hace. |
Devolvedor
Integer
: Se modificó la cantidad de repeticiones.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
selectAsCurrentPage()
Selecciona la Page
de la presentación activa como la current page selection
y quita la selección anterior.
Una secuencia de comandos solo puede acceder a la selección del usuario que la ejecuta, y solo si esta está vinculada a la presentación.
// Select the first slide as the current page selection and replace any previous selection. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations