Es un elemento principal en una presentación.
Los maestros contienen todos los elementos de página comunes y las propiedades comunes para un conjunto de diseños. Tienen tres propósitos:
- Las formas de marcador de posición de un patrón contienen los estilos de texto y las propiedades de forma predeterminados de todas las formas de marcador de posición de las páginas que usan ese patrón.
- Las propiedades de una página maestra definen las propiedades comunes de la página que heredan sus diseños.
- Cualquier otra forma de la diapositiva maestra aparecerá en todas las diapositivas que usen esa maestra, independientemente de su diseño.
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
get | Page | Obtiene el fondo de la página. |
get | Color | Obtiene el Color asociado con la página. |
get | Group[] | Muestra la lista de objetos Group en la página. |
get | Image[] | Muestra la lista de objetos Image en la página. |
get | Layout[] | Obtiene los diseños de este maestro. |
get | Line[] | Muestra la lista de objetos Line en la página. |
get | String | Obtiene el ID único de la página. |
get | Page | Muestra el Page en la página con el ID determinado o null si no existe ninguno. |
get | Page | Muestra la lista de objetos Page renderizados en la página. |
get | Page | Obtiene el tipo de la página. |
get | Page | Muestra el objeto Page de marcador de posición para un Placeholder o null especificado si no hay un marcador de posición coincidente. |
get | Page | Muestra el objeto Page de marcador de posición para un Placeholder especificado y un índice de marcador de posición, o null si el marcador de posición no está presente. |
get | Page | Muestra la lista de objetos Page de marcador de posición en la página. |
get | Shape[] | Muestra la lista de objetos Shape en la página. |
get | Sheets | Muestra la lista de objetos Sheets en la página. |
get | Table[] | Muestra la lista de objetos Table en la página. |
get | Video[] | Muestra la lista de objetos Video en la página. |
get | Word | Muestra la lista de objetos Word en la página. |
group(pageElements) | Group | Agrupa todos los elementos de página especificados. |
insert | Group | Inserta una copia del Group proporcionado en la página. |
insert | Image | Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado del objeto blob de imagen especificado. |
insert | Image | Inserta una imagen en la página con la posición y el tamaño proporcionados del blob de imagen especificado. |
insert | Image | Inserta una copia del Image proporcionado en la página. |
insert | Image | Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado de la URL proporcionada. |
insert | Image | Inserta una imagen en la página con la posición y el tamaño proporcionados desde la URL proporcionada. |
insert | Line | Inserta una copia del Line proporcionado en la página. |
insert | Line | Inserta una línea en la página que conecta dos connection sites . |
insert | Line | Inserta una línea en la página. |
insert | Page | Inserta una copia del Page proporcionado en la página. |
insert | Shape | Inserta una copia del Shape proporcionado en la página. |
insert | Shape | Inserta una forma en la página. |
insert | Shape | Inserta una forma en la página. |
insert | Sheets | Inserta un gráfico de Hojas de cálculo de Google en la página. |
insert | Sheets | Inserta un gráfico de Hojas de cálculo de Google en la página con la posición y el tamaño proporcionados. |
insert | Sheets | Inserta una copia del Sheets proporcionado en la página. |
insert | Image | Inserta un gráfico de Hojas de cálculo de Google como Image en la página. |
insert | Image | Inserta un gráfico de Hojas de cálculo de Google como un Image en la página con la posición y el tamaño proporcionados. |
insert | Table | Inserta una tabla en la página. |
insert | Table | Inserta una tabla en la página con la posición y el tamaño proporcionados. |
insert | Table | Inserta una copia del Table proporcionado en la página. |
insert | Shape | Inserta un cuadro de texto Shape que contiene la cadena proporcionada en la página. |
insert | Shape | Inserta un cuadro de texto Shape que contiene la cadena proporcionada en la página. |
insert | Video | Inserta un video en la esquina superior izquierda de la página con un tamaño predeterminado. |
insert | Video | Inserta un video en la página con la posición y el tamaño proporcionados. |
insert | Video | Inserta una copia del Video proporcionado en la página. |
insert | Word | Inserta una copia del Word proporcionado en la página. |
remove() | void | Quita la página. |
replace | Integer | Reemplaza todas las instancias de texto que coincidan con el texto de búsqueda por el texto de reemplazo. |
replace | Integer | Reemplaza todas las instancias de texto que coincidan con el texto de búsqueda por el texto de reemplazo. |
select | void | Selecciona el Page en la presentación activa como el current page selection y quita cualquier selección anterior. |
Documentación detallada
get Background()
Obtiene el fondo de la página.
Volver
Page
: Es el fondo de la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Color Scheme()
Obtiene el Color
asociado con la página.
Volver
Color
: Es el esquema de colores de la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Groups()
get Images()
get Layouts()
get Lines()
get Object Id()
Obtiene el ID único de la página. Los IDs de objeto que usan las páginas y los elementos de página comparten el mismo espacio de nombres.
Volver
String
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Element By Id(id)
Muestra el Page
en la página con el ID determinado o null
si no existe ninguno.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
id | String | Es el ID del elemento de página que se recupera. |
Volver
Page
: Es el elemento de página con el ID determinado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Elements()
Muestra la lista de objetos Page
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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Type()
get Placeholder(placeholderType)
Muestra el objeto Page
de marcador de posición para un Placeholder
o null
especificado si no hay un marcador de posición coincidente.
Si hay varios marcadores de posición con el mismo tipo, se muestra el que tiene el índice de marcador de posición mínimo. Si hay varios marcadores de posición coincidentes con el mismo índice, se muestra el primero de la colección de elementos de la página.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, );
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
placeholder | Placeholder |
Volver
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder(placeholderType, placeholderIndex)
Muestra el objeto Page
de marcador de posición para un Placeholder
especificado y un índice de marcador de posición, o null
si el marcador de posición no está presente.
Si hay varios marcadores de posición con el mismo tipo y índice, se muestra el primero de la colección de elementos de la página.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, 0, );
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
placeholder | Placeholder | |
placeholder | Integer |
Volver
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholders()
Muestra la lista de objetos Page
de marcador de posición en la página.
const master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log( `Number of placeholders in the master: ${master.getPlaceholders().length}`, );
Volver
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Shapes()
get Sheets Charts()
Muestra la lista de objetos Sheets
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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Tables()
get Videos()
get Word Arts()
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 |
---|---|---|
page | Page | Los elementos que se agruparán. |
Volver
Group
: Es el grupo nuevo.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Group(group)
Inserta una copia del Group
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que heredan de las páginas maestras o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que heredan de las páginas maestras o de diseño se copian en el elemento de la presentación de origen.
// Copy a group between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const group = otherPresentationSlide.getGroups()[0]; currentPresentationSlide.insertGroup( group); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
group | Group | Es el grupo que se copiará y se insertará. |
Volver
Group
: Es el grupo insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(blobSource)
Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado del objeto blob de imagen especificado.
Cuando se inserta la imagen, se recupera de Blob
una vez y se almacena una copia para mostrarla en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); slide.insertImage(image);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
blob | Blob | 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(blobSource, left, top, width, height)
Inserta una imagen en la página con la posición y el tamaño proporcionados del blob de imagen especificado.
La imagen se recupera del Blob
proporcionado una vez en el momento de la inserción y se almacena una copia para mostrarla dentro de la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
Para mantener la relación de aspecto de la imagen, esta se ajusta y se centra en función del tamaño proporcionado.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); const position = { left: 0, top: 0 }; const size = { width: 300, height: 100 }; slide.insertImage(image, position.left, position.top, size.width, size.height);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
blob | Blob | 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. |
Volver
Image
: Es la imagen insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(image)
Inserta una copia del Image
proporcionado en la página.
La posición de las imágenes insertadas en esta página se determina a partir de la posición de la imagen de origen en su página respectiva.
Si la imagen proporcionada es un marcador de posición que se copia desde la presentación actual, las propiedades que heredan de las páginas maestras o de diseño también se heredan en la imagen insertada.
Si la imagen proporcionada es un marcador de posición que se copia de una presentación diferente, las propiedades que heredan de las páginas maestras o de diseño se copian en la imagen de la presentación de origen. Si la imagen del marcador de posición copiada está vacía, no se inserta nada en la presentación de destino.
// Copy an image between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const image = otherPresentationSlide.getImages[0]; currentPresentationSlide.insertImage(image);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
image | Image | Es la imagen que se copiará y se insertará. |
Volver
Image
: Es la imagen insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(imageUrl)
Inserta una imagen en la esquina superior izquierda de la página con un tamaño predeterminado de la URL proporcionada.
Cuando se inserta la imagen, se recupera de la URL una vez y se almacena una copia para mostrarla en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
La URL proporcionada debe ser de acceso público y no debe tener un tamaño superior a 2 KB. La URL en sí se guarda con la imagen y se expone a través de Image.getSourceUrl()
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
image | String | Es la URL de la imagen. |
Volver
Image
: Es la imagen insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(imageUrl, left, top, width, height)
Inserta una imagen en la página con la posición y el tamaño proporcionados desde la URL proporcionada.
Cuando se inserta la imagen, se recupera de la URL una vez y se almacena una copia para mostrarla en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
La URL proporcionada debe ser de acceso público y no debe tener un tamaño superior a 2 KB. La URL en sí se guarda con la imagen y se expone a través de Image.getSourceUrl()
.
Para mantener la relación de aspecto de la imagen, esta se ajusta y se centra en función del tamaño proporcionado.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
image | String | Es 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. |
Volver
Image
: Es la imagen insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(line)
Inserta una copia del Line
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que heredan de las páginas maestras o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que heredan de las páginas maestras o de diseño se copian en el elemento de la presentación de origen.
// Copy a line between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const line = otherPresentationSlide.getLines[0]; currentPresentationSlide.insertLine(line);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
line | Line | Es la línea que se copiará y se insertará. |
Volver
Line
: Es la línea insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(lineCategory, startConnectionSite, endConnectionSite)
Inserta una línea en la página que conecta dos connection sites
. Los dos sitios de conexión deben estar en esta página.
// Insert a line in the first slide of the presentation connecting two shapes. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1], );
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
line | Line | Es la categoría de la línea que se insertará. |
start | Connection | Es el sitio de conexión donde se debe conectar el inicio de la línea. |
end | Connection | Es el sitio de conexión donde se debe conectar el extremo de la línea. |
Volver
Line
: Es la línea insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(lineCategory, startLeft, startTop, endLeft, endTop)
Inserta una línea en la página.
// Insert a line in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const startPoint = { left: 10, top: 10 }; const endPoint = { left: 40, top: 40 }; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top, );
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
line | Line | Es la categoría de la línea que se insertará. |
start | Number | Es la posición horizontal del punto inicial de la línea, medida en puntos desde la esquina superior izquierda de la página. |
start | Number | Es la posición vertical del punto inicial de la línea, medida en puntos desde la esquina superior izquierda de la página. |
end | 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. |
end | Number | Es la posición vertical del punto final de la línea, medida en puntos desde la esquina superior izquierda de la página. |
Volver
Line
: Es la línea insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Page Element(pageElement)
Inserta una copia del Page
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que heredan de las páginas maestras o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que heredan de las páginas maestras o de diseño se copian en el elemento de la presentación de origen.
// Copy a page element between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
page | Page | Es el elemento de página que se copiará y se insertará. |
Volver
Page
: Es el elemento de página insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shape)
Inserta una copia del Shape
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que heredan de las páginas maestras o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que heredan de las páginas maestras o de diseño se copian en el elemento de la presentación de origen.
// Copy a shape between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const shape = otherPresentationSlide.getShapes[0]; currentPresentationSlide.insertShape( shape); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
shape | Shape | Es la forma que se copiará y se insertará. |
Volver
Shape
: Es la forma insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shapeType)
Inserta una forma en la página.
La forma se inserta con un tamaño predeterminado en la esquina superior izquierda de la página.
// Insert a shape in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
shape | Shape | Es el tipo de forma que se insertará. |
Volver
Shape
: Es la forma insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shapeType, left, top, width, height)
Inserta una forma en la página.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
shape | Shape | 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 | Es la posición vertical de la forma, medida desde la esquina superior izquierda de la página. |
width | Number | Es el ancho de la forma. |
height | Number | Es la altura de la forma. |
Volver
Shape
: Es la forma insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sourceChart)
Inserta un gráfico de Hojas de cálculo de Google en la página.
El gráfico se inserta con un tamaño predeterminado en la esquina superior izquierda de la página.
El gráfico insertado está vinculado con el gráfico de Hojas de cálculo de Google de origen, lo que le permite actualizarse. Los demás colaboradores pueden ver el vínculo a la hoja de cálculo fuente.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
source | Embedded | Es el gráfico de una hoja de cálculo que se insertará en la página. |
Volver
Sheets
: Es el gráfico insertado en la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sourceChart, left, top, width, height)
Inserta un gráfico de Hojas de cálculo de Google en la página con la posición y el tamaño proporcionados.
Para mantener la relación de aspecto del gráfico, este se ajusta y centra en función del tamaño proporcionado.
El gráfico insertado está vinculado con el gráfico de Hojas de cálculo de Google de origen, lo que le permite actualizarse. Los demás colaboradores pueden ver el vínculo a la hoja de cálculo fuente.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const size = { width: 200, height: 200 }; // Also available for Layout, Master, and Page. slide.insertSheetsChart( chart, position.left, position.top, size.width, size.height, );
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
source | Embedded | Es 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 | Es el ancho del gráfico en puntos. |
height | Number | Es la altura del gráfico en puntos. |
Volver
Sheets
: Es el gráfico insertado en la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sheetsChart)
Inserta una copia del Sheets
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que heredan de las páginas maestras o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que heredan de las páginas maestras o de diseño se copian en el elemento de la presentación de origen.
// Copy a sheets chart between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sheets | Sheets | Es el gráfico de Hojas de cálculo que se copiará y se insertará. |
Volver
Sheets
: Es el gráfico de Hojas de cálculo insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets ChartAsImage(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 insertada no está vinculada con el gráfico de Hojas de cálculo de Google de origen.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage( chart); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
source | Embedded | Es el gráfico de una hoja de cálculo que se insertará en la página. |
Volver
Image
: Es la imagen insertada del gráfico en la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets ChartAsImage(sourceChart, left, top, width, height)
Inserta un gráfico de Hojas de cálculo de Google como un Image
en la página con la posición y el tamaño proporcionados.
Para mantener la relación de aspecto de la imagen del gráfico, esta se ajusta y se centra con respecto al tamaño proporcionado.
La imagen insertada del gráfico no está vinculada con el gráfico de Hojas de cálculo de Google de origen.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const size = { width: 200, height: 200 }; // Also available for Layout, Master, and Page. slide.insertSheetsChartAsImage( chart, position.left, position.right, size.width, size.height, );
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
source | Embedded | Es 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 | Es el ancho del gráfico en puntos. |
height | Number | Es la altura del gráfico en puntos. |
Volver
Image
: Es la imagen insertada del gráfico en la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(numRows, numColumns)
Inserta una tabla en la página.
La tabla se centra en la página con el tamaño predeterminado y las filas y columnas distribuidas de manera uniforme.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
num | Integer | Es la cantidad de filas en la tabla. |
num | Integer | Es la cantidad de columnas de la tabla. |
Volver
Table
: Es la tabla insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(numRows, numColumns, left, top, width, height)
Inserta una tabla en la página con la posición y el tamaño proporcionados.
Las filas y las columnas se distribuyen de forma uniforme en la tabla creada.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
num | Integer | Es la cantidad de filas en la tabla. |
num | 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 | Es el ancho de la tabla. |
height | Number | Es la altura mínima de la tabla. La altura real de la tabla renderizada depende de factores como el tamaño de la fuente del texto. |
Volver
Table
: Es la tabla insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(table)
Inserta una copia del Table
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que heredan de las páginas maestras o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que heredan de las páginas maestras o de diseño se copian en el elemento de la presentación de origen.
// Copy a table between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const table = otherPresentationSlide.getTables[0]; currentPresentationSlide.insertTable( table); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
table | Table | Es la tabla que se copiará y se insertará. |
Volver
Table
: Es la tabla insertada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Text Box(text)
Inserta un cuadro de texto Shape
que contiene la cadena proporcionada en la página.
La forma del cuadro de texto se inserta con un tamaño predeterminado en la esquina superior izquierda de la página.
// Insert text box with "Hello" on the first slide of presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Es la cadena que debe contener la forma del cuadro de texto. |
Volver
Shape
: Es la forma del cuadro de texto insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Text Box(text, left, top, width, height)
Inserta un cuadro de texto Shape
que contiene la cadena proporcionada en la página.
// Insert text box with "Hello" on the first slide of presentation. This text // box is a square with a length of 10 points on each side. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox( 'Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Es la 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 | Es el ancho de la forma del cuadro de texto. |
height | Number | Es la altura de la forma del cuadro de texto. |
Volver
Shape
: Es la forma del cuadro de texto insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Video(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 |
---|---|---|
video | String | Es la URL del video que se va a insertar. |
Volver
Video
: Es el video insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Video(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 |
---|---|---|
video | String | Es la URL del video que se va a 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. |
Volver
Video
: Es el video insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Video(video)
Inserta una copia del Video
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que heredan de las páginas maestras o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que heredan de las páginas maestras o de diseño se copian en el elemento de la presentación de origen.
// Copy a video between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const video = otherPresentationSlide.getVideos[0]; currentPresentationSlide.insertVideo( video); // Also available for Layout, Master, and Page.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
video | Video | Es el video que se copiará y se insertará. |
Volver
Video
: Es el video insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Word Art(wordArt)
Inserta una copia del Word
proporcionado en la página.
La posición del elemento insertado en esta página se determina a partir de la posición del elemento fuente en su página respectiva.
Si el elemento proporcionado es un marcador de posición que se copia desde la presentación actual, las propiedades que heredan de las páginas maestras o de diseño también se heredan en el elemento insertado.
Si el elemento proporcionado es un marcador de posición que se copia de una presentación diferente, las propiedades que heredan de las páginas maestras o de diseño se copian en el elemento de la presentación de origen.
// Copy a word art between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
word | Word | Es el grupo que se copiará y se insertará. |
Volver
Word
: Es el texto con formato WordArt insertado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Quita la página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText)
Reemplaza todas las instancias de texto que coincidan con el texto de búsqueda por el texto de reemplazo. La búsqueda no distingue mayúsculas de minúsculas.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
find | String | Es el texto que se buscará. |
replace | String | Es el texto que reemplazará el texto coincidente. |
Volver
Integer
: Es la cantidad de ocurrencias que cambiaron.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText, matchCase)
Reemplaza todas las instancias de texto que coincidan con el texto de búsqueda por el texto de reemplazo.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
find | String | Es el texto que se buscará. |
replace | String | Es el texto que reemplazará el texto coincidente. |
match | Boolean | Si es true , la búsqueda distingue mayúsculas de minúsculas. Si es false , la búsqueda no distingue mayúsculas de minúsculas. |
Volver
Integer
: Es la cantidad de ocurrencias que cambiaron.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select As Current Page()
Selecciona el Page
en la presentación activa como el current page selection
y quita cualquier selección anterior.
Una secuencia de comandos solo puede acceder a la selección del usuario que la ejecuta y solo si está vinculada a la presentación.
// Select the first slide as the current page selection and replace any previous // selection. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations