Class Page

Pagina

Una pagina di una presentazione.

Metodi

Metodo	Tipo restituito	Breve descrizione
asLayout()	Layout	Restituisce la pagina come layout.
asMaster()	Master	Restituisce la pagina come principale.
asSlide()	Slide	Restituisce la pagina come diapositiva.
getBackground()	PageBackground	Recupera lo sfondo della pagina.
getColorScheme()	ColorScheme	Recupera il ColorScheme associato alla pagina.
getGroups()	Group[]	Restituisce l'elenco degli oggetti Group nella pagina.
getImages()	Image[]	Restituisce l'elenco degli oggetti Image nella pagina.
getLines()	Line[]	Restituisce l'elenco degli oggetti Line nella pagina.
getObjectId()	String	Recupera l'ID univoco della pagina.
getPageElementById(id)	PageElement	Restituisce il PageElement nella pagina con l'ID specificato o null se non esiste.
getPageElements()	PageElement[]	Restituisce l'elenco degli oggetti PageElement visualizzati nella pagina.
getPageType()	PageType	Recupera il tipo di pagina.
getPlaceholder(placeholderType)	PageElement	Restituisce l'oggetto segnaposto PageElement per un PlaceholderType o null specificato se non è presente un segnaposto corrispondente.
getPlaceholder(placeholderType, placeholderIndex)	PageElement	Restituisce l'oggetto segnaposto PageElement per un PlaceholderType e un indice segnaposto specificati oppure null se il segnaposto non è presente.
getPlaceholders()	PageElement[]	Restituisce l'elenco degli oggetti segnaposto PageElement nella pagina.
getShapes()	Shape[]	Restituisce l'elenco degli oggetti Shape nella pagina.
getSheetsCharts()	SheetsChart[]	Restituisce l'elenco degli oggetti SheetsChart nella pagina.
getTables()	Table[]	Restituisce l'elenco degli oggetti Table nella pagina.
getVideos()	Video[]	Restituisce l'elenco degli oggetti Video nella pagina.
getWordArts()	WordArt[]	Restituisce l'elenco degli oggetti WordArt nella pagina.
group(pageElements)	Group	Raggruppa tutti gli elementi della pagina specificati.
insertGroup(group)	Group	Inserisce una copia del Group fornito nella pagina.
insertImage(blobSource)	Image	Inserisce un'immagine nell'angolo in alto a sinistra della pagina con le dimensioni predefinite del blob immagine specificato.
insertImage(blobSource, left, top, width, height)	Image	Inserisce un'immagine nella pagina con la posizione e le dimensioni fornite dal blob immagine specificato.
insertImage(image)	Image	Inserisce una copia del Image fornito nella pagina.
insertImage(imageUrl)	Image	Inserisce un'immagine nell'angolo in alto a sinistra della pagina con le dimensioni predefinite dell'URL fornito.
insertImage(imageUrl, left, top, width, height)	Image	Inserisce un'immagine nella pagina con la posizione e le dimensioni specificate dall'URL fornito.
insertLine(line)	Line	Inserisce una copia del Line fornito nella pagina.
insertLine(lineCategory, startConnectionSite, endConnectionSite)	Line	Inserisce una linea nella pagina che collega due connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)	Line	Inserisce una riga nella pagina.
insertPageElement(pageElement)	PageElement	Inserisce una copia del PageElement fornito nella pagina.
insertShape(shape)	Shape	Inserisce una copia del Shape fornito nella pagina.
insertShape(shapeType)	Shape	Inserisce una forma nella pagina.
insertShape(shapeType, left, top, width, height)	Shape	Inserisce una forma nella pagina.
insertSheetsChart(sourceChart)	SheetsChart	Inserisce un grafico di Fogli Google nella pagina.
insertSheetsChart(sourceChart, left, top, width, height)	SheetsChart	Inserisce un grafico di Fogli Google nella pagina con le dimensioni e la posizione specificate.
insertSheetsChart(sheetsChart)	SheetsChart	Inserisce una copia del SheetsChart fornito nella pagina.
insertSheetsChartAsImage(sourceChart)	Image	Inserisce un grafico di Fogli Google come Image nella pagina.
insertSheetsChartAsImage(sourceChart, left, top, width, height)	Image	Inserisce un grafico di Fogli Google come Image nella pagina con la posizione e le dimensioni fornite.
insertTable(numRows, numColumns)	Table	Inserisce una tabella nella pagina.
insertTable(numRows, numColumns, left, top, width, height)	Table	Inserisce una tabella nella pagina con la posizione e le dimensioni specificate.
insertTable(table)	Table	Inserisce una copia del Table fornito nella pagina.
insertTextBox(text)	Shape	Inserisce nella pagina una casella di testo Shape contenente la stringa fornita.
insertTextBox(text, left, top, width, height)	Shape	Inserisce nella pagina una casella di testo Shape contenente la stringa fornita.
insertVideo(videoUrl)	Video	Inserisce un video nell'angolo in alto a sinistra della pagina con dimensioni predefinite.
insertVideo(videoUrl, left, top, width, height)	Video	Inserisce un video nella pagina con la posizione e le dimensioni specificate.
insertVideo(video)	Video	Inserisce una copia del Video fornito nella pagina.
insertWordArt(wordArt)	WordArt	Inserisce una copia del WordArt fornito nella pagina.
remove()	void	Rimuove la pagina.
replaceAllText(findText, replaceText)	Integer	Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo.
replaceAllText(findText, replaceText, matchCase)	Integer	Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo.
selectAsCurrentPage()	void	Consente di selezionare il Page nella presentazione attiva come current page selection e di rimuovere qualsiasi selezione precedente.

Documentazione dettagliata

asLayout()

Restituisce la pagina come layout.

Invio

Layout: la pagina come layout.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

asMaster()

Restituisce la pagina come principale.

Invio

Master: la pagina come master.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

asSlide()

Restituisce la pagina come diapositiva.

Invio

Slide: la pagina come diapositiva.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getBackground()

Recupera lo sfondo della pagina.

Invio

PageBackground: lo sfondo della pagina.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getColorScheme()

Recupera il ColorScheme associato alla pagina.

Invio

ColorScheme: la combinazione di colori della pagina.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getGroups()

Restituisce l'elenco degli oggetti Group nella pagina.

Invio

Group[]

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getImages()

Restituisce l'elenco degli oggetti Image nella pagina.

Invio

Image[]

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getLines()

Restituisce l'elenco degli oggetti Line nella pagina.

Invio

Line[]

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getObjectId()

Recupera l'ID univoco della pagina. Gli ID oggetto utilizzati dalle pagine e dagli elementi della pagina condividono lo stesso spazio dei nomi.

Invio

String

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getPageElementById(id)

Restituisce il PageElement nella pagina con l'ID specificato o null se non esiste.

Parametri

Nome	Tipo	Descrizione
id	String	L'ID dell'elemento della pagina che viene recuperato.

Invio

PageElement: l'elemento della pagina con l'ID specificato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getPageElements()

Restituisce l'elenco degli oggetti PageElement visualizzati nella pagina.

Invio

PageElement[]

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getPageType()

Recupera il tipo di pagina.

Invio

PageType: il tipo di pagina.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getPlaceholder(placeholderType)

Restituisce l'oggetto segnaposto PageElement per un PlaceholderType o null specificato se non è presente un segnaposto corrispondente.

Se sono presenti più segnaposto dello stesso tipo, viene restituito quello con l'indice del segnaposto minimo. Se sono presenti più segnaposto corrispondenti con lo stesso indice, viene restituito il primo segnaposto dalla raccolta degli elementi della pagina.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

Parametri

Nome	Tipo	Descrizione
placeholderType	PlaceholderType

Invio

PageElement

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getPlaceholder(placeholderType, placeholderIndex)

Restituisce l'oggetto segnaposto PageElement per un PlaceholderType e un indice segnaposto specificati oppure null se il segnaposto non è presente.

Se sono presenti più segnaposto con lo stesso tipo e indice, viene restituito il primo segnaposto dalla raccolta degli elementi della pagina.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

Parametri

Nome	Tipo	Descrizione
placeholderType	PlaceholderType
placeholderIndex	Integer

Invio

PageElement

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getPlaceholders()

Restituisce l'elenco degli oggetti segnaposto PageElement nella pagina.

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

Invio

PageElement[]

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getShapes()

Restituisce l'elenco degli oggetti Shape nella pagina.

Invio

Shape[]

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getSheetsCharts()

Restituisce l'elenco degli oggetti SheetsChart nella pagina.

Invio

SheetsChart[]

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getTables()

Restituisce l'elenco degli oggetti Table nella pagina.

Invio

Table[]

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getVideos()

Restituisce l'elenco degli oggetti Video nella pagina.

Invio

Video[]

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getWordArts()

Restituisce l'elenco degli oggetti WordArt nella pagina.

Invio

WordArt[]

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

group(pageElements)

Raggruppa tutti gli elementi della pagina specificati.

Nella stessa pagina devono essere presenti almeno due elementi che non sono già in un altro gruppo. Alcuni elementi della pagina, come Videos, Tables e placeholder Shapes, non possono essere raggruppati.

Parametri

Nome	Tipo	Descrizione
pageElements	PageElement[]	Gli elementi da raggruppare.

Invio

Group: il nuovo gruppo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertGroup(group)

Inserisce una copia del Group fornito nella pagina.

La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.

// Copy a group between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(
    group);  // Also available for Layout, Master, and Page.

Parametri

Nome	Tipo	Descrizione
group	Group	Il gruppo da copiare e inserire.

Invio

Group: il gruppo inserito.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertImage(blobSource)

Inserisce un'immagine nell'angolo in alto a sinistra della pagina con le dimensioni predefinite del blob immagine specificato.

L'inserimento dell'immagine la recupera una volta da BlobSource e ne viene archiviata una copia per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
slide.insertImage(image);

Parametri

Nome	Tipo	Descrizione
blobSource	BlobSource	I dati immagine.

Invio

Image: l'immagine inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertImage(blobSource, left, top, width, height)

Inserisce un'immagine nella pagina con la posizione e le dimensioni fornite dal blob immagine specificato.

L'immagine viene recuperata dal BlobSource fornito una volta al momento dell'inserimento e una copia viene archiviata per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.

Per mantenere le proporzioni dell'immagine, questa viene ridimensionata e centrata rispetto alle dimensioni fornite.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 300,
  height: 100
};
slide.insertImage(image, position.left, position.top, size.width, size.height);

Parametri

Nome	Tipo	Descrizione
blobSource	BlobSource	I dati immagine.
left	Number	La posizione orizzontale dell'immagine in punti, misurata dall'angolo in alto a sinistra della pagina.
top	Number	La posizione verticale dell'immagine in punti, misurata dall'angolo in alto a sinistra della pagina.
width	Number	La larghezza dell'immagine in punti.
height	Number	L'altezza dell'immagine in punti.

Invio

Image: l'immagine inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertImage(image)

Inserisce una copia del Image fornito nella pagina.

La posizione delle immagini inserite in questa pagina viene determinata dalla posizione dell'immagine di origine sulla rispettiva pagina.

Se l'immagine fornita è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche dall'immagine inserita.

Se l'immagine fornita è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate sull'immagine dalla presentazione di origine. Se l'immagine segnaposto copiata è vuota, nella presentazione di destinazione non viene inserito nulla.

// Copy an image between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

Parametri

Nome	Tipo	Descrizione
image	Image	L'immagine da copiare e inserire.

Invio

Image: l'immagine inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertImage(imageUrl)

Inserisce un'immagine nell'angolo in alto a sinistra della pagina con le dimensioni predefinite dell'URL fornito.

L'inserimento dell'immagine la recupera dall'URL una volta e ne viene memorizzata una copia per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.

L'URL fornito deve essere pubblicamente accessibile e non deve superare i 2 kB. L'URL stesso viene salvato con l'immagine ed esposto tramite Image.getSourceUrl().

Parametri

Nome	Tipo	Descrizione
imageUrl	String	L'URL dell'immagine.

Invio

Image: l'immagine inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertImage(imageUrl, left, top, width, height)

Inserisce un'immagine nella pagina con la posizione e le dimensioni specificate dall'URL fornito.

L'inserimento dell'immagine la recupera dall'URL una volta e ne viene memorizzata una copia per la visualizzazione all'interno della presentazione. Le immagini devono avere dimensioni inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.

L'URL fornito deve essere pubblicamente accessibile e non deve superare i 2 kB. L'URL stesso viene salvato con l'immagine ed esposto tramite Image.getSourceUrl().

Per mantenere le proporzioni dell'immagine, questa viene ridimensionata e centrata rispetto alle dimensioni fornite.

Parametri

Nome	Tipo	Descrizione
imageUrl	String	L'URL dell'immagine.
left	Number	La posizione orizzontale dell'immagine in punti, misurata dall'angolo in alto a sinistra della pagina.
top	Number	La posizione verticale dell'immagine in punti, misurata dall'angolo in alto a sinistra della pagina.
width	Number	La larghezza dell'immagine in punti.
height	Number	L'altezza dell'immagine in punti.

Invio

Image: l'immagine inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertLine(line)

Inserisce una copia del Line fornito nella pagina.

La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.

// Copy a line between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

Parametri

Nome	Tipo	Descrizione
line	Line	La riga da copiare e inserire.

Invio

Line: la riga inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertLine(lineCategory, startConnectionSite, endConnectionSite)

Inserisce una linea nella pagina che collega due connection sites. I due siti di collegamento devono trovarsi in questa pagina.

// Insert a line in the first slide of the presentation connecting two shapes.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1],
);

Parametri

Nome	Tipo	Descrizione
lineCategory	LineCategory	La categoria della riga da inserire.
startConnectionSite	ConnectionSite	Il sito di collegamento in cui deve essere collegata l'inizio della linea.
endConnectionSite	ConnectionSite	Il sito di connessione a cui deve essere collegata l'estremità della linea.

Invio

Line: la riga inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertLine(lineCategory, startLeft, startTop, endLeft, endTop)

Inserisce una riga nella pagina.

// Insert a line in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const endPoint = {
  left: 40,
  top: 40
};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top,
);

Parametri

Nome	Tipo	Descrizione
lineCategory	LineCategory	La categoria della riga da inserire.
startLeft	Number	La posizione orizzontale del punto di inizio della linea, misurata in punti dall'angolo in alto a sinistra della pagina.
startTop	Number	La posizione verticale del punto di inizio della linea, misurata in punti dall'angolo in alto a sinistra della pagina.
endLeft	Number	La posizione orizzontale del punto finale della linea, misurata in punti dall'angolo in alto a sinistra della pagina.
endTop	Number	La posizione verticale del punto finale della linea, misurata in punti dall'angolo in alto a sinistra della pagina.

Invio

Line: la riga inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertPageElement(pageElement)

Inserisce una copia del PageElement fornito nella pagina.

La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.

// Copy a page element between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

Parametri

Nome	Tipo	Descrizione
pageElement	PageElement	L'elemento della pagina da copiare e inserire.

Invio

PageElement: l'elemento di pagina inserito.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertShape(shape)

Inserisce una copia del Shape fornito nella pagina.

La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.

// Copy a shape between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(
    shape);  // Also available for Layout, Master, and Page.

Parametri

Nome	Tipo	Descrizione
shape	Shape	La forma da copiare e inserire.

Invio

Shape: la forma inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertShape(shapeType)

Inserisce una forma nella pagina.

La forma viene inserita con dimensioni predefinite nell'angolo in alto a sinistra della pagina.

// Insert a shape in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

Parametri

Nome	Tipo	Descrizione
shapeType	ShapeType	Il tipo di forma da inserire.

Invio

Shape: la forma inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertShape(shapeType, left, top, width, height)

Inserisce una forma nella pagina.

Parametri

Nome	Tipo	Descrizione
shapeType	ShapeType	Il tipo di forma da inserire.
left	Number	La posizione orizzontale della forma, misurata dall'angolo in alto a sinistra della pagina.
top	Number	La posizione verticale della forma, misurata dall'angolo in alto a sinistra della pagina.
width	Number	La larghezza della forma.
height	Number	L'altezza della forma.

Invio

Shape: la forma inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertSheetsChart(sourceChart)

Inserisce un grafico di Fogli Google nella pagina.

Il grafico viene inserito con dimensioni predefinite nell'angolo in alto a sinistra della pagina.

Il grafico inserito è collegato al grafico di Fogli Google di origine, il che consente di aggiornarlo. Gli altri collaboratori possono vedere il link al foglio di lavoro di origine.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

Parametri

Nome	Tipo	Descrizione
sourceChart	EmbeddedChart	Il grafico in un foglio di lavoro da inserire nella pagina.

Invio

SheetsChart: il grafico inserito nella pagina.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertSheetsChart(sourceChart, left, top, width, height)

Inserisce un grafico di Fogli Google nella pagina con le dimensioni e la posizione specificate.

Per mantenere le proporzioni del grafico, il grafico viene ridimensionato e centrato rispetto alle dimensioni fornite.

Il grafico inserito è collegato al grafico di Fogli Google di origine, il che consente di aggiornarlo. Gli altri collaboratori possono vedere il link al foglio di lavoro di origine.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height,
);

Parametri

Nome	Tipo	Descrizione
sourceChart	EmbeddedChart	Il grafico in un foglio di lavoro da inserire nella pagina.
left	Number	La posizione orizzontale del grafico in punti, misurata dall'angolo in alto a sinistra della pagina.
top	Number	La posizione verticale del grafico in punti, misurata dall'angolo in alto a sinistra della pagina.
width	Number	La larghezza del grafico in punti.
height	Number	L'altezza del grafico in punti.

Invio

SheetsChart: il grafico inserito nella pagina.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertSheetsChart(sheetsChart)

Inserisce una copia del SheetsChart fornito nella pagina.

La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.

// Copy a sheets chart between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

Parametri

Nome	Tipo	Descrizione
sheetsChart	SheetsChart	Il grafico di Fogli da copiare e inserire.

Invio

SheetsChart: il grafico di Fogli inserito.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertSheetsChartAsImage(sourceChart)

Inserisce un grafico di Fogli Google come Image nella pagina.

L'immagine del grafico viene inserita con dimensioni predefinite nell'angolo in alto a sinistra della pagina.

L'immagine del grafico inserita non è collegata al grafico di Fogli Google di origine.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(
    chart);  // Also available for Layout, Master, and Page.

Parametri

Nome	Tipo	Descrizione
sourceChart	EmbeddedChart	Il grafico in un foglio di lavoro da inserire nella pagina.

Invio

Image: l'immagine del grafico inserita nella pagina.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertSheetsChartAsImage(sourceChart, left, top, width, height)

Inserisce un grafico di Fogli Google come Image nella pagina con la posizione e le dimensioni fornite.

Per mantenere le proporzioni dell'immagine del grafico, l'immagine viene ridimensionata e centrata rispetto alle dimensioni fornite.

L'immagine del grafico inserita non è collegata al grafico di Fogli Google di origine.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height,
);

Parametri

Nome	Tipo	Descrizione
sourceChart	EmbeddedChart	Il grafico in un foglio di lavoro da inserire nella pagina.
left	Number	La posizione orizzontale del grafico in punti, misurata dall'angolo in alto a sinistra della pagina.
top	Number	La posizione verticale del grafico in punti, misurata dall'angolo in alto a sinistra della pagina.
width	Number	La larghezza del grafico in punti.
height	Number	L'altezza del grafico in punti.

Invio

Image: l'immagine del grafico inserita nella pagina.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertTable(numRows, numColumns)

Inserisce una tabella nella pagina.

La tabella è centrata nella pagina con dimensioni predefinite e righe e colonne distribuite uniformemente.

Parametri

Nome	Tipo	Descrizione
numRows	Integer	Il numero di righe nella tabella.
numColumns	Integer	Il numero di colonne nella tabella.

Invio

Table: la tabella inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertTable(numRows, numColumns, left, top, width, height)

Inserisce una tabella nella pagina con la posizione e le dimensioni specificate.

Le righe e le colonne sono distribuite uniformemente nella tabella creata.

Parametri

Nome	Tipo	Descrizione
numRows	Integer	Il numero di righe nella tabella.
numColumns	Integer	Il numero di colonne nella tabella.
left	Number	La posizione orizzontale della tabella, misurata dall'angolo in alto a sinistra della pagina.
top	Number	La posizione verticale della tabella, misurata dall'angolo in alto a sinistra della pagina.
width	Number	La larghezza della tabella.
height	Number	L'altezza minima della tabella. L'altezza effettiva della tabella visualizzata dipende da fattori quali le dimensioni dei caratteri del testo.

Invio

Table: la tabella inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertTable(table)

Inserisce una copia del Table fornito nella pagina.

La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.

// Copy a table between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(
    table);  // Also available for Layout, Master, and Page.

Parametri

Nome	Tipo	Descrizione
table	Table	La tabella da copiare e inserire.

Invio

Table: la tabella inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertTextBox(text)

Inserisce nella pagina una casella di testo Shape contenente la stringa fornita.

La forma della casella di testo viene inserita con una dimensione predefinita nell'angolo in alto a sinistra della pagina.

// Insert text box with "Hello" on the first slide of presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello');  // Also available for Layout, Master, and Page.

Parametri

Nome	Tipo	Descrizione
text	String	La stringa che la forma della casella di testo deve contenere.

Invio

Shape: la forma della casella di testo inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertTextBox(text, left, top, width, height)

Inserisce nella pagina una casella di testo Shape contenente la stringa fornita.

// Insert text box with "Hello" on the first slide of presentation. This text
// box is a square with a length of 10 points on each side.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox(
    'Hello', 0, 0, 10, 10);  // Also available for Layout, Master, and Page.

Parametri

Nome	Tipo	Descrizione
text	String	La stringa che la forma della casella di testo deve contenere.
left	Number	La posizione orizzontale della forma della casella di testo, misurata dall'angolo in alto a sinistra della pagina.
top	Number	La posizione verticale della forma della casella di testo, misurata dall'angolo in alto a sinistra della pagina.
width	Number	La larghezza della forma della casella di testo.
height	Number	L'altezza della forma della casella di testo.

Invio

Shape: la forma della casella di testo inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertVideo(videoUrl)

Inserisce un video nell'angolo in alto a sinistra della pagina con dimensioni predefinite.

Al momento sono supportati solo i video di YouTube.

Parametri

Nome	Tipo	Descrizione
videoUrl	String	L'URL del video da inserire.

Invio

Video: il video inserito.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertVideo(videoUrl, left, top, width, height)

Inserisce un video nella pagina con la posizione e le dimensioni specificate.

Al momento sono supportati solo i video di YouTube.

Parametri

Nome	Tipo	Descrizione
videoUrl	String	L'URL del video da inserire.
left	Number	La posizione orizzontale del video in punti, misurata dall'angolo in alto a sinistra della pagina.
top	Number	La posizione verticale del video in punti, misurata dall'angolo in alto a sinistra della pagina.
width	Number	La larghezza del video in punti.
height	Number	L'altezza del video in punti.

Invio

Video: il video inserito.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertVideo(video)

Inserisce una copia del Video fornito nella pagina.

La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.

// Copy a video between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(
    video);  // Also available for Layout, Master, and Page.

Parametri

Nome	Tipo	Descrizione
video	Video	Il video da copiare e inserire.

Invio

Video: il video inserito.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

insertWordArt(wordArt)

Inserisce una copia del WordArt fornito nella pagina.

La posizione dell'elemento inserito in questa pagina viene determinata dalla posizione dell'elemento di origine nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dalla presentazione corrente, le proprietà che ereditano dalle pagine master o di layout vengono ereditate anche nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà che ereditano dalle pagine master o di layout vengono copiate nell'elemento dalla presentazione di origine.

// Copy a word art between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

Parametri

Nome	Tipo	Descrizione
wordArt	WordArt	Il gruppo da copiare e inserire.

Invio

WordArt: la parola in WordArt inserita.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

remove()

Rimuove la pagina.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

replaceAllText(findText, replaceText)

Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo. La ricerca non fa distinzione tra maiuscole e minuscole.

Parametri

Nome	Tipo	Descrizione
findText	String	Il testo da trovare.
replaceText	String	Il testo da sostituire al testo corrispondente.

Invio

Integer: il numero di occorrenze modificate

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

replaceAllText(findText, replaceText, matchCase)

Sostituisce tutte le istanze di testo corrispondenti al testo trovato con il testo sostitutivo.

Parametri

Nome	Tipo	Descrizione
findText	String	Il testo da trovare.
replaceText	String	Il testo da sostituire al testo corrispondente.
matchCase	Boolean	Se true, la ricerca è sensibile alle maiuscole; se false, la ricerca è insensibile alle maiuscole.

Invio

Integer: il numero di occorrenze modificate

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

selectAsCurrentPage()

Consente di selezionare il Page nella presentazione attiva come current page selection e di rimuovere qualsiasi selezione precedente.

Uno script può accedere alla selezione dell'utente che lo esegue solo se è legato alla presentazione.

// Select the first slide as the current page selection and replace any previous
// selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage();  // Also available for Layout, Master, and Page.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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