Se usó la API de Cloud Translation para traducir esta página.

Class Image

Un PageElement que representa una imagen.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`alignOnPage(alignmentPosition)`	`Image`	Alinea el elemento con la posición de alineación especificada en la página.
`bringForward()`	`Image`	Avanza el elemento de página en la página un elemento.
`bringToFront()`	`Image`	Coloca el elemento de página en la parte frontal de la página.
`duplicate()`	`PageElement`	Duplica el elemento de página.
`getAs(contentType)`	`Blob`	Muestra los datos dentro de este objeto como un blob convertido al tipo de contenido especificado.
`getBlob()`	`Blob`	Muestra los datos dentro de esta imagen como un blob.
`getBorder()`	`Border`	Devuelve el `Border` de la imagen.
`getConnectionSites()`	`ConnectionSite[]`	Muestra la lista de `ConnectionSite` en el elemento de página o una lista vacía si el elemento de página no tiene ningún sitio de conexión.
`getContentUrl()`	`String`	Obtiene una URL a la imagen.
`getDescription()`	`String`	Muestra la descripción del texto alternativo del elemento de página.
`getHeight()`	`Number`	Obtiene la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando este no tiene rotación.
`getInherentHeight()`	`Number`	Muestra la altura inherente del elemento en puntos.
`getInherentWidth()`	`Number`	Muestra el ancho inherente del elemento en puntos.
`getLeft()`	`Number`	Muestra 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.
`getLink()`	`Link`	Muestra `Link` o `null` si no hay un vínculo.
`getObjectId()`	`String`	Muestra el ID único de este objeto.
`getPageElementType()`	`PageElementType`	Muestra el tipo del elemento de página, representado como una enumeración `PageElementType`.
`getParentGroup()`	`Group`	Muestra el grupo al que pertenece este elemento de página o `null` si el elemento no está en un grupo.
`getParentPage()`	`Page`	Muestra la página en la que se encuentra este elemento de página.
`getParentPlaceholder()`	`PageElement`	Devuelve el elemento de página superior del marcador de posición.
`getPlaceholderIndex()`	`Integer`	Muestra el índice de la imagen del marcador de posición.
`getPlaceholderType()`	`PlaceholderType`	Muestra el tipo de marcador de posición de la imagen o `PlaceholderType.NONE` si la forma no es un marcador de posición.
`getRotation()`	`Number`	Muestra 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.
`getSourceUrl()`	`String`	Obtiene la URL de origen de la imagen, si está disponible.
`getTitle()`	`String`	Muestra el título del texto alternativo del elemento de página.
`getTop()`	`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.
`getTransform()`	`AffineTransform`	Devuelve la transformación del elemento de página.
`getWidth()`	`Number`	Muestra el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando este no tiene rotación.
`preconcatenateTransform(transform)`	`Image`	Preconecta la transformación proporcionada con la transformación existente del elemento de página.
`remove()`	`void`	Quita el elemento de página.
`removeLink()`	`void`	Quita una `Link`.
`replace(blobSource)`	`Image`	Reemplaza esta imagen por una imagen descrita por un objeto `BlobSource`.
`replace(blobSource, crop)`	`Image`	Reemplaza esta imagen por una imagen descrita por un objeto `Image` y, de manera opcional, recorta la imagen para que se ajuste.
`replace(imageUrl)`	`Image`	Reemplaza esta imagen por otra descargada de la URL proporcionada.
`replace(imageUrl, crop)`	`Image`	Reemplaza esta imagen por otra descargada de la URL proporcionada. De manera opcional, puedes recortar la imagen para que se ajuste.
`scaleHeight(ratio)`	`Image`	Escala la altura del elemento según la proporción especificada.
`scaleWidth(ratio)`	`Image`	Escala el ancho del elemento según la proporción especificada.
`select()`	`void`	Selecciona solo el `PageElement` en la presentación activa y quita cualquier selección anterior.
`select(replace)`	`void`	Selecciona el `PageElement` en la presentación activa.
`sendBackward()`	`Image`	Envía el elemento de página hacia atrás en la página por un elemento.
`sendToBack()`	`Image`	Envía el elemento de página al final de la página.
`setDescription(description)`	`Image`	Establece la descripción del texto alternativo del elemento de página.
`setHeight(height)`	`Image`	Establece la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando este no tiene rotación.
`setLeft(left)`	`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.
`setLinkSlide(slideIndex)`	`Link`	Establece un `Link` en el `Slide` determinado con el índice basado en cero de la diapositiva.
`setLinkSlide(slide)`	`Link`	Establece un `Link` en el `Slide` determinado. El vínculo se establece con el ID de diapositiva determinado.
`setLinkSlide(slidePosition)`	`Link`	Establece un `Link` en el `Slide` determinado con la posición relativa de la diapositiva.
`setLinkUrl(url)`	`Link`	Establece un `Link` en la cadena de URL no vacía que se proporciona.
`setRotation(angle)`	`Image`	Establece el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro en grados.
`setTitle(title)`	`Image`	Establece el título del texto alternativo del elemento de página.
`setTop(top)`	`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.
`setTransform(transform)`	`Image`	Establece la transformación del elemento de página con la transformación proporcionada.
`setWidth(width)`	`Image`	Establece el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando este no tiene rotación.

Documentación detallada

`alignOnPage(alignmentPosition)`

Alinea el elemento con la posición de alineación especificada en la página.

Parámetros

Nombre	Tipo	Descripción
`alignmentPosition`	`AlignmentPosition`	Es la posición en la que se alinea este elemento de página.

Volver

Image: Este elemento de página se usa para encadenar.

`bringForward()`

Avanza el elemento de página en la página un elemento.

El elemento de página no debe estar en un grupo.

Volver

Image: Este elemento de página se usa para encadenar.

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

`bringToFront()`

Coloca el elemento de página en la parte frontal de la página.

El elemento de página no debe estar en un grupo.

Volver

Image: Este elemento de página se usa para encadenar.

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

`duplicate()`

Duplica el elemento de página.

El elemento de página duplicado se coloca en la misma página y en la misma posición que el original.

Volver

PageElement: Es el nuevo duplicado de este elemento 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 ámbitos:

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

`getAs(contentType)`

Muestra 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, se da por sentado que la parte del nombre de archivo que sigue al último punto (si corresponde) 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 de 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
`contentType`	`String`	Es el tipo de MIME al que se debe realizar la conversión. 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 `'image/bmp'`, `'image/gif'`, `'image/jpeg'` o `'image/png'`. Para un documento de Documentos de Google, `'text/markdown'` también es válido.

Volver

Blob: Los datos como un BLOB.

`getBlob()`

Muestra los datos dentro de esta imagen como un blob.

Volver

Blob: Son los datos de la imagen como un BLOB.

`getBorder()`

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 ámbitos:

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

`getConnectionSites()`

Muestra la lista de ConnectionSite en el elemento de página o una lista vacía si el elemento de página no tiene ningún sitio de conexión.

Volver

ConnectionSite[]: 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 ámbitos:

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

`getContentUrl()`

Obtiene una URL a la imagen.

Esta URL está etiquetada con la cuenta del solicitante, por lo que cualquier persona que tenga la URL 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 muestra vence después de un período breve.

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

`getDescription()`

Muestra la descripción del texto alternativo del elemento de 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 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

`getHeight()`

Obtiene la altura del elemento en puntos, que es la altura del cuadro de límite 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 página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Volver

Number: Es la altura inherente del elemento de página en puntos o null si el elemento de página no tiene una altura.

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

`getInherentHeight()`

Muestra la altura inherente del elemento en puntos.

La transformación del elemento de página es relativa a su tamaño inherente. Usa el tamaño intrínseco junto con la transformación del elemento para determinar su apariencia visual final.

Volver

Number: Es la altura inherente del elemento de página en puntos o null si el elemento de página no tiene una altura.

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

`getInherentWidth()`

Muestra el ancho inherente del elemento en puntos.

La transformación del elemento de página es relativa a su tamaño inherente. Usa el tamaño intrínseco junto con la transformación del elemento para determinar su apariencia visual final.

Volver

Number: Es el ancho inherente del elemento de página en puntos o null si el elemento de 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 ámbitos:

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

`getLeft()`

Muestra 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: Es la 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 ámbitos:

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

`getLink()`

Muestra Link o null si no hay un 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: Es 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 ámbitos:

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

`getObjectId()`

Muestra el ID único de este objeto. Los IDs de objeto 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 ámbitos:

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

`getPageElementType()`

Muestra el tipo del elemento de página, representado como una enumeración PageElementType.

Volver

PageElementType: Es el tipo de elemento 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 ámbitos:

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

`getParentGroup()`

Muestra el grupo al que pertenece este elemento de página o null si el elemento no está en un grupo.

Volver

Group: Es el grupo al que pertenece este elemento de 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 ámbitos:

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

`getParentPage()`

Muestra 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 ámbitos:

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

`getParentPlaceholder()`

Devuelve el elemento de página superior del marcador de posición. Muestra null si la imagen no es un marcador de posición o no tiene un elemento superior.

Volver

PageElement: Es el elemento de página superior 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 superior.

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

`getPlaceholderIndex()`

Muestra el índice de la imagen del 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 tiene un valor de índice único. Muestra null si la imagen no es un marcador de posición.

Volver

Integer: Es el índice de 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 ámbitos:

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

`getPlaceholderType()`

Muestra el tipo de marcador de posición de la imagen o PlaceholderType.NONE si la forma no es un marcador de posición.

Volver

PlaceholderType: 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 ámbitos:

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

`getRotation()`

Muestra 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 (incluido) y 360 (excluido).

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

`getSourceUrl()`

Obtiene la URL de origen de la imagen, si está disponible.

Cuando se inserta una imagen por URL, muestra la URL proporcionada durante la inserción.

Volver

String: Es 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 ámbitos:

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

`getTitle()`

Muestra el título del texto alternativo del elemento de 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 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

`getTop()`

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: Es la 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 ámbitos:

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

`getTransform()`

Devuelve la transformación del elemento de página.

La apariencia visual del elemento de página se determina según su transformación absoluta. Para calcular la transformación absoluta, preconcatena la transformación de un elemento de página con las transformaciones de todos sus grupos superiores. Si el elemento de página no está en un grupo, su transformación absoluta es igual al valor de este campo.

Volver

AffineTransform: Es la transformación del elemento 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 ámbitos:

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

`getWidth()`

Muestra el ancho del elemento en puntos, que es el ancho del cuadro de límite 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 página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Volver

Number: Es el ancho inherente del elemento de página en puntos o null si el elemento de 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 ámbitos:

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

`preconcatenateTransform(transform)`

Preconecta la transformación proporcionada con la transformación existente del elemento de página.

newTransform = argument * existingTransform;

Por ejemplo, para mover un elemento de 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 página por setTransform(transform).

Parámetros

Nombre	Tipo	Descripción
`transform`	`AffineTransform`	Es la transformación que se preconcatenará en la transformación de este elemento de página.

Volver

Image: Este elemento de página se usa para encadenar.

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 el elemento de página.

Si, después de una operación de eliminación, un Group contiene solo uno o ningún elemento de página, también se quita el grupo.

Si se quita un marcador de posición PageElement en un modelo o diseño, también se quitan los marcadores de posición de herencia vacíos.

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

`removeLink()`

Quita una Link.

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

`replace(blobSource)`

Reemplaza esta imagen por una imagen descrita por un objeto BlobSource.

Cuando se inserta la imagen, se recupera del 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.

Para mantener la relación de aspecto de la imagen, esta se ajusta y se centra en función del 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
`blobSource`	`BlobSource`	Los datos de la imagen.

Volver

Image: Este 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 ámbitos:

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

`replace(blobSource, crop)`

Reemplaza esta imagen por una imagen descrita por un objeto Image y, de manera opcional, recorta la imagen para que se ajuste.

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
`blobSource`	`BlobSource`	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 se centra.

Volver

Image: Este 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 ámbitos:

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

`replace(imageUrl)`

Reemplaza esta imagen por otra descargada 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 más de 2 KB. La URL en sí se guarda con la imagen y se expone a través de getSourceUrl().

Para mantener la relación de aspecto de la imagen, esta se ajusta y se centra en función del tamaño de la imagen existente.

Parámetros

Nombre	Tipo	Descripción
`imageUrl`	`String`	Es la URL desde la que se descargará la imagen.

Volver

Image: Este 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 ámbitos:

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. De manera opcional, puedes recortar la imagen para que se ajuste.

La URL proporcionada no debe superar los 2 KB.

Parámetros

Nombre	Tipo	Descripción
`imageUrl`	`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 se centra.

Volver

Image: Este 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 ámbitos:

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

`scaleHeight(ratio)`

Escala la altura del elemento según la proporción especificada. La altura del elemento es la altura de su cuadro de límite 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 página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Parámetros

Nombre	Tipo	Descripción
`ratio`	`Number`	Es la proporción con la que se escalará la altura de este elemento de página.

Volver

Image: Este elemento de página se usa para encadenar.

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

`scaleWidth(ratio)`

Escala el ancho del elemento según la proporción especificada. El ancho del elemento es el ancho de su cuadro de límite 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 página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Parámetros

Nombre	Tipo	Descripción
`ratio`	`Number`	Es la proporción con la que se escalará el ancho de este elemento de página.

Volver

Image: Este elemento de página se usa para encadenar.

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()`

Selecciona solo el PageElement 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 superior de PageElement como 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 ámbitos:

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

`select(replace)`

Selecciona el PageElement 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 PageElement y quitar cualquier selección anterior. Esto también establece el Page superior del PageElement como el current page selection.

Pasa false para seleccionar varios objetos PageElement. Los objetos PageElement deben estar en el mismo Page.

Se deben cumplir las siguientes condiciones cuando se selecciona un elemento de página con un parámetro false:

El Page superior del objeto PageElement debe ser current page selection.
No debe haber varios objetos Page seleccionados.

Para asegurarte de que ese sea el caso, el enfoque preferido es seleccionar primero el Page superior con Page.selectAsCurrentPage() y, luego, seleccionar los elementos de la página en esa 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 ámbitos:

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

`sendBackward()`

Envía el elemento de página hacia atrás en la página por un elemento.

El elemento de página no debe estar en un grupo.

Volver

Image: Este elemento de página se usa para encadenar.

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

`sendToBack()`

Envía el elemento de página al final de la página.

El elemento de página no debe estar en un grupo.

Volver

Image: Este elemento de página se usa para encadenar.

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

`setDescription(description)`

Establece la descripción del texto alternativo del elemento de 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 en la que se establecerá la descripción del texto alternativo.

Volver

Image: Es el elemento de esta 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

`setHeight(height)`

Establece la altura del elemento en puntos, que es la altura del cuadro de límite 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 página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Parámetros

Nombre	Tipo	Descripción
`height`	`Number`	Es la nueva altura de este elemento de página que se establecerá, en puntos.

Volver

Image: Este elemento de página se usa para encadenar.

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

`setLeft(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`	Es la nueva posición horizontal que se establecerá, en puntos.

Volver

Image: Este elemento de página se usa para encadenar.

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

`setLinkSlide(slideIndex)`

Establece un Link en el 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
`slideIndex`	`Integer`	Es el í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 ámbitos:

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

`setLinkSlide(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`	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 ámbitos:

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

`setLinkSlide(slidePosition)`

Establece un Link en el Slide determinado con 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
`slidePosition`	`SlidePosition`	El `SlidePosition` 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 ámbitos:

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

`setLinkUrl(url)`

Establece un Link en la cadena de URL no vacía que se proporciona.

// 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 ámbitos:

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

`setRotation(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 página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

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 debe establecer, en grados.

Volver

Image: Este elemento de página se usa para encadenar.

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

`setTitle(title)`

Establece el título del texto alternativo del elemento de 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 en la que se establecerá el título del texto alternativo.

Volver

Image: Es el elemento de esta 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

`setTop(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`	Es la nueva posición vertical que se establecerá, en puntos.

Volver

Image: Este elemento de página se usa para encadenar.

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

`setTransform(transform)`

Establece la transformación del elemento de página con la transformación proporcionada.

Si actualizas la transformación de un grupo, se cambia la transformación absoluta de los elementos de la página en ese grupo, lo que puede cambiar su apariencia visual.

Si actualizas la transformación de un elemento de página que está en un grupo, solo se cambiará la transformación de ese elemento de página, no se verán afectadas las transformaciones del grupo ni de otros elementos de página del grupo.

Para obtener detalles sobre cómo las transformaciones afectan la apariencia visual de los elementos de la página, consulta getTransform().

Parámetros

Nombre	Tipo	Descripción
`transform`	`AffineTransform`	Es la transformación que se establece para este elemento de página.

Volver

Image: Este elemento es para encadenar.

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

`setWidth(width)`

Establece el ancho del elemento en puntos, que es el ancho del cuadro de límite 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 página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Parámetros

Nombre	Tipo	Descripción
`width`	`Number`	Es el nuevo ancho de este elemento de página que se establecerá, en puntos.

Volver

Image: Este elemento de página se usa para encadenar.

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