Class SheetsChart

SheetsChart

Un PageElement que representa un gráfico vinculado incorporado desde Hojas de cálculo de Google.

Métodos

MétodoTipo de datos que se muestraDescripción breve
alignOnPage(alignmentPosition)SheetsChartAlinea el elemento con la posición de alineación especificada en la página.
asImage()ImageMuestra el gráfico como una imagen o null si no es una imagen incorporada.
bringForward()SheetsChartAvanza el elemento de página en la página un elemento.
bringToFront()SheetsChartColoca el elemento de página en la parte frontal de la página.
duplicate()PageElementDuplica el elemento de página.
getChartId()IntegerObtiene el ID del gráfico específico en la hoja de cálculo de Hojas de cálculo de Google que está incorporado.
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.
getDescription()StringMuestra la descripción del texto alternativo del elemento de página.
getEmbedType()SheetsChartEmbedTypeMuestra el tipo de incorporación del gráfico de Hojas de cálculo.
getHeight()NumberObtiene la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando este no tiene rotación.
getInherentHeight()NumberMuestra la altura inherente del elemento en puntos.
getInherentWidth()NumberMuestra el ancho inherente del elemento en puntos.
getLeft()NumberMuestra 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()LinkMuestra Link o null si no hay un vínculo.
getObjectId()StringMuestra el ID único de este objeto.
getPageElementType()PageElementTypeMuestra el tipo del elemento de página, representado como una enumeración PageElementType.
getParentGroup()GroupMuestra el grupo al que pertenece este elemento de página o null si el elemento no está en un grupo.
getParentPage()PageMuestra la página en la que se encuentra este elemento de página.
getRotation()NumberMuestra 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.
getSpreadsheetId()StringObtiene el ID de la hoja de cálculo de Hojas de cálculo de Google que contiene el gráfico de origen.
getTitle()StringMuestra el título del texto alternativo del elemento de página.
getTop()NumberObtiene 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()AffineTransformDevuelve la transformación del elemento de página.
getWidth()NumberMuestra 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)SheetsChartPreconecta la transformación proporcionada con la transformación existente del elemento de página.
refresh()voidActualiza el gráfico reemplazándolo por la versión más reciente de Hojas de cálculo de Google.
remove()voidQuita el elemento de página.
removeLink()voidQuita un Link.
scaleHeight(ratio)SheetsChartEscala la altura del elemento según la proporción especificada.
scaleWidth(ratio)SheetsChartEscala el ancho del elemento según la proporción especificada.
select()voidSelecciona solo el PageElement en la presentación activa y quita cualquier selección anterior.
select(replace)voidSelecciona el PageElement en la presentación activa.
sendBackward()SheetsChartEnvía el elemento de página hacia atrás en la página por un elemento.
sendToBack()SheetsChartEnvía el elemento de página al final de la página.
setDescription(description)SheetsChartEstablece la descripción del texto alternativo del elemento de página.
setHeight(height)SheetsChartEstablece 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)SheetsChartEstablece 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)LinkEstablece un Link en el Slide determinado con el índice basado en cero de la diapositiva.
setLinkSlide(slide)LinkEstablece un Link en el Slide determinado. El vínculo se establece con el ID de diapositiva determinado.
setLinkSlide(slidePosition)LinkEstablece un Link en el Slide determinado con la posición relativa de la diapositiva.
setLinkUrl(url)LinkEstablece un Link en la cadena de URL no vacía que se proporciona.
setRotation(angle)SheetsChartEstablece el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro en grados.
setTitle(title)SheetsChartEstablece el título del texto alternativo del elemento de página.
setTop(top)SheetsChartEstablece 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)SheetsChartEstablece la transformación del elemento de página con la transformación proporcionada.
setWidth(width)SheetsChartEstablece 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

NombreTipoDescripción
alignmentPositionAlignmentPositionEs la posición en la que se alinea este elemento de página.

Volver

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


asImage()

Muestra el gráfico como una imagen o null si no es una imagen incorporada.

Volver

Image: Este gráfico como una imagen, o null si el gráfico no es una imagen incorporada.

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

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

SheetsChart: 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

SheetsChart: 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

getChartId()

Obtiene el ID del gráfico específico en la hoja de cálculo de Hojas de cálculo de Google que está incorporado.

Volver

Integer: Es el ID del gráfico incorporado.

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

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

getEmbedType()

Muestra el tipo de incorporación del gráfico de Hojas de cálculo.

Volver

SheetsChartEmbedType: Es el tipo de incorporación de este gráfico.

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

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

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

getSpreadsheetId()

Obtiene el ID de la hoja de cálculo de Hojas de cálculo de Google que contiene el gráfico de origen.

Volver

String: Es el ID de la hoja de cálculo que contiene el gráfico 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

NombreTipoDescripción
transformAffineTransformEs la transformación que se preconcatenará en la transformación de este elemento de página.

Volver

SheetsChart: 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

refresh()

Actualiza el gráfico reemplazándolo por la versión más reciente de Hojas de cálculo de Google. Si el gráfico ya está actualizado, no realiza ningún cambio en el gráfico de la presentació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/spreadsheets.readonly

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 elemento principal o de 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

Quita un Link.

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

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

NombreTipoDescripción
ratioNumberEs la proporción con la que se escalará la altura de este elemento de página.

Volver

SheetsChart: 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

NombreTipoDescripción
ratioNumberEs la proporción con la que se escalará el ancho de este elemento de página.

Volver

SheetsChart: 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:

  1. El Page superior del objeto PageElement debe ser current page selection.
  2. 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

NombreTipoDescripción
replaceBooleanSi 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

SheetsChart: 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

SheetsChart: 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

NombreTipoDescripción
descriptionStringEs la cadena en la que se establecerá la descripción del texto alternativo.

Volver

SheetsChart: 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

NombreTipoDescripción
heightNumberEs la nueva altura de este elemento de página que se establecerá, en puntos.

Volver

SheetsChart: 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

NombreTipoDescripción
leftNumberEs la nueva posición horizontal que se establecerá, en puntos.

Volver

SheetsChart: 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

NombreTipoDescripción
slideIndexIntegerEs 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

NombreTipoDescripción
slideSlideEl 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

NombreTipoDescripción
slidePositionSlidePositionEl 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

NombreTipoDescripción
urlStringEs 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

NombreTipoDescripción
angleNumberEs el nuevo ángulo de rotación en el sentido de las manecillas del reloj que se debe establecer, en grados.

Volver

SheetsChart: 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

NombreTipoDescripción
titleStringEs la cadena en la que se establecerá el título del texto alternativo.

Volver

SheetsChart: 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

NombreTipoDescripción
topNumberEs la nueva posición vertical que se establecerá, en puntos.

Volver

SheetsChart: 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

NombreTipoDescripción
transformAffineTransformEs la transformación que se establece para este elemento de página.

Volver

SheetsChart: 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

NombreTipoDescripción
widthNumberEs el nuevo ancho de este elemento de página que se establecerá, en puntos.

Volver

SheetsChart: 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