Es un objeto Page que representa una imagen.
Métodos
| Método | Tipo de datos que se muestra | Descripción breve |
|---|---|---|
align | Image | Alinea el elemento con la posición de alineación especificada en la página. |
bring | Image | Adelanta el elemento de la página en un elemento. |
bring | Image | Lleva el elemento de la página al frente de la página. |
duplicate() | Page | Duplica el elemento de la página. |
get | Blob | Devuelve los datos dentro de este objeto como un blob convertido al tipo de contenido especificado. |
get | Blob | Devuelve los datos dentro de esta imagen como un blob. |
get | Border | Devuelve el Border de la imagen. |
get | Connection | Devuelve la lista de Connections en el elemento de la página o una lista vacía si el elemento de la página no tiene ningún sitio de conexión. |
get | String | Obtiene una URL a la imagen. |
get | String | Devuelve la descripción del texto alternativo del elemento de la página. |
get | Number|null | Obtiene la altura del elemento en puntos, que es la altura del cuadro delimitador del elemento cuando este no tiene rotación. |
get | Number|null | Devuelve la altura inherente del elemento en puntos. |
get | Number|null | Devuelve el ancho inherente del elemento en puntos. |
get | Number | Devuelve la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación. |
get | Link|null | Devuelve Link o null si no hay ningún vínculo. |
get | String | Devuelve el ID único de este objeto. |
get | Page | Devuelve el tipo del elemento de la página, representado como una enumeración Page. |
get | Group|null | Devuelve el grupo al que pertenece este elemento de la página o null si el elemento no está en un grupo. |
get | Page | Devuelve la página en la que se encuentra este elemento de página. |
get | Page | Devuelve el elemento de página principal del marcador de posición. |
get | Integer|null | Devuelve el índice de la imagen de marcador de posición. |
get | Placeholder | Devuelve el tipo de marcador de posición de la imagen o Placeholder si la forma no es un marcador de posición. |
get | Number | Devuelve el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro en grados, donde cero grados significa que no hay rotación. |
get | String|null | Obtiene la URL de origen de la imagen, si está disponible. |
get | String | Devuelve el título del texto alternativo del elemento de la página. |
get | Number | Obtiene la posición vertical del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación. |
get | Affine | Devuelve la transformación del elemento de la página. |
get | Number|null | Devuelve el ancho del elemento en puntos, que es el ancho del cuadro delimitador del elemento cuando este no tiene rotación. |
preconcatenate | Image | Antepone la transformación proporcionada a la transformación existente del elemento de la página. |
remove() | void | Quita el elemento de la página. |
remove | void | Quita un Link. |
replace(blobSource) | Image | Reemplaza esta imagen por una imagen descrita por un objeto Blob. |
replace(blobSource, crop) | Image | Reemplaza esta imagen por una que se describe con un objeto Image y, de manera opcional, recorta la imagen para que se ajuste. |
replace(imageUrl) | Image | Reemplaza esta imagen por otra que se descargó de la URL proporcionada. |
replace(imageUrl, crop) | Image | Reemplaza esta imagen por otra descargada de la URL proporcionada y, de manera opcional, recorta la imagen para que se ajuste. |
scale | Image | Ajusta la altura del elemento según la proporción especificada. |
scale | Image | Ajusta el ancho del elemento según la proporción especificada. |
select() | void | Selecciona solo el Page en la presentación activa y quita cualquier selección anterior. |
select(replace) | void | Selecciona el Page en la presentación activa. |
send | Image | Envía el elemento de la página hacia atrás en la página en un elemento. |
send | Image | Envía el elemento de la página al fondo de la página. |
set | Image | Establece la descripción del texto alternativo del elemento de la página. |
set | Image | Establece la altura del elemento en puntos, que es la altura del cuadro delimitador del elemento cuando este no tiene rotación. |
set | Image | Establece la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación. |
set | Link | Establece un objeto Link en el objeto Slide determinado con el índice basado en cero de la diapositiva. |
set | Link | Establece un Link en el Slide determinado. El vínculo se establece con el ID de diapositiva determinado. |
set | Link | Establece un Link en el Slide determinado usando la posición relativa de la diapositiva. |
set | Link | Establece un Link en la cadena de URL no vacía proporcionada. |
set | Image | Establece el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro en grados. |
set | Image | Establece el título del texto alternativo del elemento de la página. |
set | Image | Establece la posición vertical del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación. |
set | Image | Establece la transformación del elemento de la página con la transformación proporcionada. |
set | Image | Establece el ancho del elemento en puntos, que es el ancho del cuadro delimitador del elemento cuando este no tiene rotación. |
Documentación detallada
align On Page(alignmentPosition)
Alinea el elemento con la posición de alineación especificada en la página.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
alignment | Alignment | Posición en la que se alineará este elemento de la página. |
Volver
Image: Este elemento de la página, para encadenar.
bring Forward()
Adelanta el elemento de la página en un elemento.
El elemento de la página no debe estar en un grupo.
Volver
Image: Este elemento de la página, para encadenar.
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
bring To Front()
Lleva el elemento de la página al frente de la página.
El elemento de la página no debe estar en un grupo.
Volver
Image: Este elemento de la página, para encadenar.
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
duplicate()
Duplica el elemento de la página.
El elemento de la página duplicada se coloca en la misma página y en la misma posición que el original.
Volver
Page: Es el nuevo duplicado de este elemento 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
get As(contentType)
Devuelve los datos dentro de este objeto como un blob convertido al tipo de contenido especificado. Este método agrega la extensión adecuada al nombre del archivo, por ejemplo, "miarchivo.pdf". Sin embargo, supone que la parte del nombre de archivo que sigue al último punto (si hay alguno) es una extensión existente que se debe reemplazar. Por lo tanto, "ShoppingList.12.25.2014" se convierte en "ShoppingList.12.25.pdf".
Para ver las cuotas diarias de conversiones, consulta Cuotas para los servicios de Google. Es posible que los dominios de Google Workspace recién creados estén sujetos temporalmente a cuotas más estrictas.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
content | String | Es el tipo de MIME al que se convertirá el archivo. Para la mayoría de los BLOBs, 'application/pdf' es la única opción válida. Para las imágenes en formato BMP, GIF, JPEG o PNG, también son válidos cualquiera de los valores 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'. En el caso de un documento de Documentos de Google, 'text/markdown' también es válido. |
Volver
Blob: Los datos como un BLOB.
get Blob()
Devuelve los datos dentro de esta imagen como un blob.
Volver
Blob: Los datos de la imagen como un BLOB.
get Border()
Devuelve el Border de la imagen.
Volver
Border: Es el borde de la imagen.
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
get Connection Sites()
Devuelve la lista de Connections en el elemento de la página o una lista vacía si el elemento de la página no tiene ningún sitio de conexión.
Volver
Connection: Es la lista de sitios de conexión, que puede estar vacía si este elemento no tiene sitios de conexión.
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
get Content Url()
Obtiene una URL a la imagen.
Esta URL está etiquetada con la cuenta del solicitante, por lo que cualquier persona que la tenga accede a la imagen como el solicitante original. Es posible que se pierda el acceso a la imagen si cambia la configuración de uso compartido de la presentación. La URL que se devuelve vence después de un período corto.
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
get Description()
Devuelve la descripción del texto alternativo del elemento de la página. La descripción se combina con el título para mostrar y leer el texto alternativo.
Volver
String: Es la descripción del texto alternativo del elemento 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
get Height()
Obtiene la altura del elemento en puntos, que es la altura del cuadro delimitador del elemento cuando este no tiene rotación.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posición.
Volver
Number|null: Es la altura inherente del elemento de la página en puntos o null si el elemento de la página no tiene altura.
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
get Inherent Height()
Devuelve la altura inherente del elemento en puntos.
La transformación del elemento de la página es relativa a su tamaño inherente. Usa el tamaño inherente junto con la transformación del elemento para determinar su apariencia visual final.
Volver
Number|null: Es la altura inherente del elemento de la página en puntos o null si el elemento de la página no tiene altura.
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
get Inherent Width()
Devuelve el ancho inherente del elemento en puntos.
La transformación del elemento de la página es relativa a su tamaño inherente. Usa el tamaño inherente junto con la transformación del elemento para determinar su apariencia visual final.
Volver
Number|null: Es el ancho inherente del elemento de la página en puntos o null si el elemento de la página no tiene un ancho.
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
get Left()
Devuelve la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.
Volver
Number: Posición horizontal de este elemento en puntos, desde la esquina superior izquierda 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
get Link()
Devuelve Link o null si no hay ningún vínculo.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const link = shape.getLink(); if (link != null) { Logger.log(`Shape has a link of type: ${link.getLinkType()}`); }
Volver
Link|null: Es el Link o null si no hay un vínculo.
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
get Object Id()
Devuelve el ID único de este objeto. Los IDs de objetos que usan las páginas y los elementos de página comparten el mismo espacio de nombres.
Volver
String: Es el ID único de este objeto.
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
get Page Element Type()
Devuelve el tipo del elemento de la página, representado como una enumeración Page.
Volver
Page: Es el tipo de elemento 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
get Parent Group()
Devuelve el grupo al que pertenece este elemento de la página o null si el elemento no está en un grupo.
Volver
Group|null: Es el grupo al que pertenece este elemento de la página o null.
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
get Parent Page()
Devuelve la página en la que se encuentra este elemento de página.
Volver
Page: Es la página en la que reside este elemento.
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
get Parent Placeholder()
Devuelve el elemento de página principal del marcador de posición. Devuelve null si la imagen no es un marcador de posición o no tiene un elemento superior.
Volver
Page: Es el elemento de página principal de este marcador de posición de imagen o null si esta imagen no es un marcador de posición o no tiene un elemento 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
get Placeholder Index()
Devuelve el índice de la imagen de marcador de posición. Si dos o más imágenes de marcador de posición en la misma página son del mismo tipo, cada una tendrá un valor de índice único. Devuelve null si la imagen no es un marcador de posición.
Volver
Integer|null: Es el índice del marcador de posición de esta imagen o null si la imagen no es un marcador de posición.
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
get Placeholder Type()
Devuelve el tipo de marcador de posición de la imagen o Placeholder si la forma no es un marcador de posición.
Volver
Placeholder: Es el tipo de marcador de posición de esta imagen.
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
get Rotation()
Devuelve el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro en grados, donde cero grados significa que no hay rotación.
Volver
Number: Es el ángulo de rotación en grados entre 0 (inclusive) y 360 (exclusive).
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
get Source Url()
Obtiene la URL de origen de la imagen, si está disponible.
Cuando se inserta una imagen por URL, devuelve la URL proporcionada durante la inserción de la imagen.
Volver
String|null: La URL de la imagen o null si la imagen no tiene una URL de origen.
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
get Title()
Devuelve el título del texto alternativo del elemento de la página. El título se combina con la descripción para mostrar y leer el texto alternativo.
Volver
String: Es el título del texto alternativo del elemento 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
get Top()
Obtiene la posición vertical del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.
Volver
Number: Posición vertical de este elemento en puntos, desde la esquina superior izquierda 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
get Transform()
Devuelve la transformación del elemento de la página.
La apariencia visual del elemento de la página está determinada por su transformación absoluta. Para calcular la transformación absoluta, concatena previamente la transformación de un elemento de la página con las transformaciones de todos sus grupos principales. Si el elemento de la página no está en un grupo, su transformación absoluta es la misma que el valor de este campo.
Volver
Affine: Es la transformación del elemento 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
get Width()
Devuelve el ancho del elemento en puntos, que es el ancho del cuadro delimitador del elemento cuando este no tiene rotación.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posición.
Volver
Number|null: Es el ancho inherente del elemento de la página en puntos o null si el elemento de la página no tiene un ancho.
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
preconcatenate Transform(transform)
Antepone la transformación proporcionada a la transformación existente del elemento de la página.
newTransform = argument * existingTransform;
Por ejemplo, para mover un elemento de la página 36 puntos hacia la izquierda, haz lo siguiente:
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; element.preconcatenateTransform( SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(), );
También puedes reemplazar la transformación del elemento de la página por set.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
transform | Affine | Es la transformación que se debe concatenar previamente a la transformación de este elemento de la página. |
Volver
Image: Este elemento de la página, para encadenar.
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 el elemento de la página.
Si, después de una operación de eliminación, un Group contiene solo un elemento de página o ninguno, también se quita el grupo.
Si se quita un marcador de posición Page en un diseño o en un elemento principal, también se quitarán los marcadores de posición vacíos que heredan.
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 Link()
Quita un Link.
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
replace(blobSource)
Reemplaza esta imagen por una imagen descrita por un objeto Blob.
Cuando insertas la imagen, se recupera del
Blob una vez y se almacena una copia para mostrarla en la presentación.
Las imágenes deben pesar menos de 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, se ajusta su escala y se centra con respecto al tamaño de la imagen existente.
const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. const driveImage = DriveApp.getFileById("123abc"); image.replace(driveImage);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
blob | Blob | Son los datos de la imagen. |
Volver
Image: Es el Image después del reemplazo.
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
replace(blobSource, crop)
Reemplaza esta imagen por una que se describe con un objeto Image y, de manera opcional, recorta la imagen para que se ajuste.
Cuando insertas la imagen, se recupera del
Blob una vez y se almacena una copia para mostrarla en la presentación.
Las imágenes deben pesar menos de 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. const driveImage = DriveApp.getFileById('123abc'); // Replace and crop the drive image. image.replace(driveImage, true);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
blob | Blob | Son los datos de la imagen. |
crop | Boolean | Si es true, recorta la imagen para que se ajuste al tamaño de la imagen existente. De lo contrario, la imagen se ajusta y centra. |
Volver
Image: Es el Image después del reemplazo.
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
replace(imageUrl)
Reemplaza esta imagen por otra que se descargó de la URL proporcionada.
Cuando se inserta la imagen, se recupera de la URL una vez y se almacena una copia para mostrarla dentro de la presentación. Las imágenes deben pesar menos de 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 en sí se guarda con la imagen y se expone a través de get.
Para mantener la relación de aspecto de la imagen, se ajusta su escala y se centra con respecto al tamaño de la imagen existente.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
image | String | Es la URL desde la que se descargará la imagen. |
Volver
Image: Es el Image después del reemplazo.
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
replace(imageUrl, crop)
Reemplaza esta imagen por otra descargada de la URL proporcionada y, de manera opcional, recorta la imagen para que se ajuste.
Cuando se inserta la imagen, se recupera de la URL una vez y se almacena una copia para mostrarla dentro de la presentación. Las imágenes deben pesar menos de 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
La URL proporcionada no debe superar los 2 KB.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
image | String | Es la URL desde la que se descargará la imagen. |
crop | Boolean | Si es true, recorta la imagen para que se ajuste al tamaño de la imagen existente. De lo contrario, la imagen se ajusta y centra. |
Volver
Image: Es el Image después del reemplazo.
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
scale Height(ratio)
Ajusta la altura del elemento según la proporción especificada. La altura del elemento es la de su cuadro delimitador cuando el elemento no tiene rotación.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posición.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
ratio | Number | Es la proporción según la cual se debe ajustar la altura de este elemento de la página. |
Volver
Image: Este elemento de la página, para encadenar.
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
scale Width(ratio)
Ajusta el ancho del elemento según la proporción especificada. El ancho del elemento es el ancho de su cuadro delimitador cuando el elemento no tiene rotación.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posición.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
ratio | Number | Es la proporción según la cual se debe ajustar el ancho de este elemento de la página. |
Volver
Image: Este elemento de la página, para encadenar.
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
select()
Selecciona solo el Page en la presentación activa y quita cualquier selección anterior. Esto es lo mismo que llamar a select(replace) con true.
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.
Esto establece el Page principal del Page como el current page selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
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
select(replace)
Selecciona el Page en la presentación activa.
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.
Pasa true a este método para seleccionar solo el Page y quitar cualquier selección anterior. Esto también establece el Page principal del Page como el current page selection.
Pasa false para seleccionar varios objetos Page. Los objetos Page deben estar en el mismo Page.
Se deben cumplir las siguientes condiciones cuando se selecciona un elemento de la página con un parámetro false:
- El
Pageprincipal del objetoPagedebe serElement current page selection. - No debe haber varios objetos
Pageseleccionados.
Para asegurarte de que sea así, el enfoque preferido es seleccionar primero el Page principal con Page.selectAsCurrentPage() y, luego, seleccionar los elementos de la página.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // First select the slide page, as the current page selection. slide.selectAsCurrentPage(); // Then select all the page elements in the selected slide page. const pageElements = slide.getPageElements(); for (let i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
replace | Boolean | Si es true, la selección reemplaza cualquier selección anterior; de lo contrario, la selección se agrega a cualquier selección anterior. |
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
send Backward()
Envía el elemento de la página hacia atrás en la página en un elemento.
El elemento de la página no debe estar en un grupo.
Volver
Image: Este elemento de la página, para encadenar.
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
send To Back()
Envía el elemento de la página al fondo de la página.
El elemento de la página no debe estar en un grupo.
Volver
Image: Este elemento de la página, para encadenar.
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
set Description(description)
Establece la descripción del texto alternativo del elemento de la página.
El método no es compatible con los elementos Group.
// Set the first page element's alt text description to "new alt text // description". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
description | String | Es la cadena para establecer la descripción del texto alternativo. |
Volver
Image: Es este elemento 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
set Height(height)
Establece la altura del elemento en puntos, que es la altura del cuadro delimitador del elemento cuando este no tiene rotación.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posición.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
height | Number | Es la nueva altura que se establecerá para este elemento de la página, en puntos. |
Volver
Image: Este elemento de la página, para encadenar.
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
set Left(left)
Establece la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
left | Number | Nueva posición horizontal que se establecerá, en puntos. |
Volver
Image: Este elemento de la página, para encadenar.
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
set Link Slide(slideIndex)
Establece un objeto Link en el objeto Slide determinado con el índice basado en cero de la diapositiva.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(0);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
slide | Integer | Índice basado en cero de la diapositiva. |
Volver
Link: Es el Link que se configuró.
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
set Link Slide(slide)
Establece un Link en el Slide determinado. El vínculo se establece con el ID de diapositiva determinado.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(slides[0]);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
slide | Slide | Es el Slide que se vinculará. |
Volver
Link: Es el Link que se configuró.
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
set Link Slide(slidePosition)
Establece un Link en el Slide determinado usando la posición relativa de la diapositiva.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
slide | Slide | Es el Slide relativo. |
Volver
Link: Es el Link que se configuró.
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
set Link Url(url)
Establece un Link en la cadena de URL no vacía proporcionada.
// Set a link to the URL. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkUrl('https://slides.google.com');
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
url | String | Es la cadena de URL. |
Volver
Link: Es el Link que se configuró.
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
set Rotation(angle)
Establece el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro en grados.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posición.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
angle | Number | Es el nuevo ángulo de rotación en el sentido de las manecillas del reloj que se configurará, en grados. |
Volver
Image: Este elemento de la página, para encadenar.
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
set Title(title)
Establece el título del texto alternativo del elemento de la página.
El método no es compatible con los elementos Group.
// Set the first page element's alt text title to "new alt text title". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
title | String | Es la cadena que se usará para establecer el título del texto alternativo. |
Volver
Image: Es este elemento 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
set Top(top)
Establece la posición vertical del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
top | Number | Nueva posición vertical que se establecerá, en puntos. |
Volver
Image: Este elemento de la página, para encadenar.
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
set Transform(transform)
Establece la transformación del elemento de la página con la transformación proporcionada.
Actualizar la transformación de un grupo cambia la transformación absoluta de los elementos de la página en ese grupo, lo que puede cambiar su apariencia visual.
Cuando se actualiza la transformación de un elemento de la página que se encuentra en un grupo, solo se cambia la transformación de ese elemento de la página, y no se afectan las transformaciones del grupo ni de otros elementos de la página que se encuentren en el grupo.
Para obtener detalles sobre cómo las transformaciones afectan la apariencia visual de los elementos de la página, consulta get.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
transform | Affine | Es la transformación que se establece para este elemento de la página. |
Volver
Image: Este elemento, para encadenar.
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
set Width(width)
Establece el ancho del elemento en puntos, que es el ancho del cuadro delimitador del elemento cuando este no tiene rotación.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posición.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
width | Number | Nuevo ancho de este elemento de la página que se establecerá, en puntos. |
Volver
Image: Este elemento de la página, para encadenar.
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