Class Master

Master

Uno schema in una presentazione.

I master contengono tutti gli elementi comuni della pagina e le proprietà comuni per un insieme di layout. Hanno tre scopi:

  • Le forme segnaposto in una slide master contengono gli stili di testo e le proprietà delle forme predefiniti di tutte le forme segnaposto nelle pagine che utilizzano quella slide master.
  • Le proprietà di una pagina master definiscono le proprietà comuni della pagina ereditate dai relativi layout.
  • Tutte le altre forme nello schema vengono visualizzate su tutte le slide che utilizzano lo schema, indipendentemente dal layout.

Metodi

MetodoTipo restituitoBreve descrizione
getBackground()PageBackgroundRecupera lo sfondo della pagina.
getColorScheme()ColorSchemeRecupera l'elemento ColorScheme associato alla pagina.
getGroups()Group[]Restituisce l'elenco degli oggetti Group nella pagina.
getImages()Image[]Restituisce l'elenco degli oggetti Image nella pagina.
getLayouts()Layout[]Recupera i layout di questo master.
getLines()Line[]Restituisce l'elenco degli oggetti Line nella pagina.
getObjectId()StringRecupera l'ID univoco della pagina.
getPageElementById(id)PageElement|nullRestituisce PageElement nella pagina con l'ID specificato o null se non esiste.
getPageElements()PageElement[]Restituisce l'elenco degli oggetti PageElement visualizzati nella pagina.
getPageType()PageTypeRestituisce il tipo di pagina.
getPlaceholder(placeholderType)PageElement|nullRestituisce l'oggetto segnaposto PageElement per un PlaceholderType o un null specificato se non è presente un segnaposto corrispondente.
getPlaceholder(placeholderType, placeholderIndex)PageElement|nullRestituisce l'oggetto segnaposto PageElement per un PlaceholderType specificato e un indice segnaposto 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)GroupRaggruppa tutti gli elementi della pagina specificati.
insertGroup(group)GroupInserisce una copia dell'elemento Group fornito nella pagina.
insertImage(blobSource)ImageInserisce un'immagine nell'angolo in alto a sinistra della pagina con una dimensione predefinita dal blob immagine specificato.
insertImage(blobSource, left, top, width, height)ImageInserisce un'immagine nella pagina con la posizione e le dimensioni fornite dal blob immagine specificato.
insertImage(image)ImageInserisce una copia dell'elemento Image fornito nella pagina.
insertImage(imageUrl)ImageInserisce un'immagine nell'angolo in alto a sinistra della pagina con una dimensione predefinita dall'URL fornito.
insertImage(imageUrl, left, top, width, height)ImageInserisce un'immagine nella pagina con la posizione e le dimensioni fornite dall'URL specificato.
insertLine(line)LineInserisce una copia dell'elemento Line fornito nella pagina.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineInserisce una linea nella pagina che collega due connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)LineInserisce una linea nella pagina.
insertPageElement(pageElement)PageElementInserisce una copia dell'elemento PageElement fornito nella pagina.
insertShape(shape)ShapeInserisce una copia dell'elemento Shape fornito nella pagina.
insertShape(shapeType)ShapeInserisce una forma nella pagina.
insertShape(shapeType, left, top, width, height)ShapeInserisce una forma nella pagina.
insertSheetsChart(sourceChart)SheetsChartInserisce un grafico di Fogli Google nella pagina.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartInserisce un grafico di Fogli Google nella pagina con la posizione e le dimensioni fornite.
insertSheetsChart(sheetsChart)SheetsChartInserisce una copia dell'elemento SheetsChart fornito nella pagina.
insertSheetsChartAsImage(sourceChart)ImageInserisce un grafico di Fogli Google come Image nella pagina.
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageInserisce un grafico di Fogli Google come Image nella pagina con la posizione e le dimensioni fornite.
insertTable(numRows, numColumns)TableInserisce una tabella nella pagina.
insertTable(numRows, numColumns, left, top, width, height)TableInserisce una tabella nella pagina con la posizione e le dimensioni fornite.
insertTable(table)TableInserisce una copia dell'elemento Table fornito nella pagina.
insertTextBox(text)ShapeInserisce una casella di testo Shape contenente la stringa fornita nella pagina.
insertTextBox(text, left, top, width, height)ShapeInserisce una casella di testo Shape contenente la stringa fornita nella pagina.
insertVideo(videoUrl)VideoInserisce un video nell'angolo in alto a sinistra della pagina con una dimensione predefinita.
insertVideo(videoUrl, left, top, width, height)VideoInserisce un video nella pagina con la posizione e le dimensioni fornite.
insertVideo(video)VideoInserisce una copia dell'elemento Video fornito nella pagina.
insertWordArt(wordArt)WordArtInserisce una copia dell'elemento WordArt fornito nella pagina.
remove()voidRimuove la pagina.
replaceAllText(findText, replaceText)IntegerSostituisce tutte le istanze di testo corrispondenti al testo di ricerca con il testo sostitutivo.
replaceAllText(findText, replaceText, matchCase)IntegerSostituisce tutte le istanze di testo corrispondenti al testo di ricerca con il testo sostitutivo.
selectAsCurrentPage()voidSeleziona Page nella presentazione attiva come current page selection e rimuove qualsiasi selezione precedente.

Documentazione dettagliata

getBackground()

Recupera lo sfondo della pagina.

Indietro

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 l'elemento ColorScheme associato alla pagina.

Indietro

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.

Indietro

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.

Indietro

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

getLayouts()

Recupera i layout di questo master.

Indietro

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

getLines()

Restituisce l'elenco degli oggetti Line nella pagina.

Indietro

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.

Indietro

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 PageElement nella pagina con l'ID specificato o null se non esiste.

Parametri

NomeTipoDescrizione
idStringL'ID dell'elemento della pagina che viene recuperato.

Indietro

PageElement|null: 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.

Indietro

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

Restituisce il tipo di pagina.

Indietro

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 un 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 della raccolta di elementi della pagina.

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

Parametri

NomeTipoDescrizione
placeholderTypePlaceholderType

Indietro

PageElement|null

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 specificato e un indice segnaposto oppure null se il segnaposto non è presente.

Se sono presenti più segnaposto con lo stesso tipo e indice, restituisce il primo segnaposto della raccolta di elementi della pagina.

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

Parametri

NomeTipoDescrizione
placeholderTypePlaceholderType
placeholderIndexInteger

Indietro

PageElement|null

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}`,
);

Indietro

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.

Indietro

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.

Indietro

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.

Indietro

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.

Indietro

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.

Indietro

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.

Devono essere presenti almeno due elementi della pagina nella stessa pagina che non si trovano già in un altro gruppo. Alcuni elementi della pagina, come Videos, Tables e placeholder Shapes, non possono essere raggruppati.

Parametri

NomeTipoDescrizione
pageElementsPageElement[]Gli elementi da raggruppare.

Indietro

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 dell'elemento Group fornito nella pagina.

La posizione dell'elemento inserito in questa pagina è determinata dalla posizione dell'elemento sorgente nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dall'interno del file di presentazione corrente, anche le proprietà ereditate dalle pagine master o di layout vengono ereditate nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà ereditate 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

NomeTipoDescrizione
groupGroupIl gruppo da copiare e inserire.

Indietro

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 una dimensione predefinita dal blob immagine specificato.

L'inserimento dell'immagine la recupera da BlobSource una sola 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.

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

Parametri

NomeTipoDescrizione
blobSourceBlobSourceI dati immagine.

Indietro

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 sola volta al momento dell'inserimento e ne viene memorizzata una copia da visualizzare 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 scalata 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

NomeTipoDescrizione
blobSourceBlobSourceI dati immagine.
leftNumberLa posizione orizzontale dell'immagine in punti, misurata dall'angolo in alto a sinistra della pagina.
topNumberLa posizione verticale dell'immagine in punti, misurata dall'angolo in alto a sinistra della pagina.
widthNumberLa larghezza dell'immagine in punti.
heightNumberL'altezza dell'immagine in punti.

Indietro

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 dell'elemento Image fornito nella pagina.

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

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

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

// 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

NomeTipoDescrizione
imageImageL'immagine da copiare e inserire.

Indietro

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 una dimensione predefinita dall'URL fornito.

L'inserimento dell'immagine la recupera dall'URL una sola 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 accessibile pubblicamente e non più grande di 2 kB. L'URL stesso viene salvato con l'immagine ed esposto tramite Image.getSourceUrl().

Parametri

NomeTipoDescrizione
imageUrlStringL'URL dell'immagine.

Indietro

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 fornite dall'URL specificato.

L'inserimento dell'immagine la recupera dall'URL una sola 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 accessibile pubblicamente e non più grande di 2 kB. L'URL stesso viene salvato con l'immagine ed esposto tramite Image.getSourceUrl().

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

Parametri

NomeTipoDescrizione
imageUrlStringL'URL dell'immagine.
leftNumberLa posizione orizzontale dell'immagine in punti, misurata dall'angolo in alto a sinistra della pagina.
topNumberLa posizione verticale dell'immagine in punti, misurata dall'angolo in alto a sinistra della pagina.
widthNumberLa larghezza dell'immagine in punti.
heightNumberL'altezza dell'immagine in punti.

Indietro

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 dell'elemento Line fornito nella pagina.

La posizione dell'elemento inserito in questa pagina è determinata dalla posizione dell'elemento sorgente nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dall'interno del file di presentazione corrente, anche le proprietà ereditate dalle pagine master o di layout vengono ereditate nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà ereditate 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

NomeTipoDescrizione
lineLineLa riga da copiare e inserire.

Indietro

Line: la linea 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 connessione 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

NomeTipoDescrizione
lineCategoryLineCategoryLa categoria della riga da inserire.
startConnectionSiteConnectionSiteIl sito di connessione in cui deve essere collegato l'inizio della linea.
endConnectionSiteConnectionSiteIl sito di connessione a cui collegare l'estremità della linea.

Indietro

Line: la linea 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 linea 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

NomeTipoDescrizione
lineCategoryLineCategoryLa categoria della riga da inserire.
startLeftNumberLa posizione orizzontale del punto iniziale della linea, misurata in punti dall'angolo in alto a sinistra della pagina.
startTopNumberLa posizione verticale del punto iniziale della linea, misurata in punti dall'angolo in alto a sinistra della pagina.
endLeftNumberLa posizione orizzontale del punto finale della linea, misurata in punti dall'angolo in alto a sinistra della pagina.
endTopNumberLa posizione verticale del punto finale della linea, misurata in punti dall'angolo in alto a sinistra della pagina.

Indietro

Line: la linea 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 dell'elemento PageElement fornito nella pagina.

La posizione dell'elemento inserito in questa pagina è determinata dalla posizione dell'elemento sorgente nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dall'interno del file di presentazione corrente, anche le proprietà ereditate dalle pagine master o di layout vengono ereditate nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà ereditate 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

NomeTipoDescrizione
pageElementPageElementL'elemento della pagina da copiare e inserire.

Indietro

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 dell'elemento Shape fornito nella pagina.

La posizione dell'elemento inserito in questa pagina è determinata dalla posizione dell'elemento sorgente nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dall'interno del file di presentazione corrente, anche le proprietà ereditate dalle pagine master o di layout vengono ereditate nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà ereditate 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

NomeTipoDescrizione
shapeShapeLa forma da copiare e inserire.

Indietro

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 una dimensione predefinita 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

NomeTipoDescrizione
shapeTypeShapeTypeIl tipo di forma da inserire.

Indietro

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

NomeTipoDescrizione
shapeTypeShapeTypeIl tipo di forma da inserire.
leftNumberLa posizione orizzontale della forma, misurata dall'angolo in alto a sinistra della pagina.
topNumberLa posizione verticale della forma, misurata dall'angolo in alto a sinistra della pagina.
widthNumberLa larghezza della forma.
heightNumberL'altezza della forma.

Indietro

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 una dimensione predefinita nell'angolo in alto a sinistra della pagina.

Il grafico inserito è collegato al grafico di origine di Fogli Google, il che consente di aggiornarlo. Gli altri collaboratori possono visualizzare 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

NomeTipoDescrizione
sourceChartEmbeddedChartIl grafico in un foglio di lavoro da inserire nella pagina.

Indietro

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 la posizione e le dimensioni fornite.

Per mantenere le proporzioni del grafico, quest'ultimo viene scalato e centrato rispetto alle dimensioni fornite.

Il grafico inserito è collegato al grafico di origine di Fogli Google, il che consente di aggiornarlo. Gli altri collaboratori possono visualizzare 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

NomeTipoDescrizione
sourceChartEmbeddedChartIl grafico in un foglio di lavoro da inserire nella pagina.
leftNumberLa posizione orizzontale del grafico in punti, misurata dall'angolo in alto a sinistra della pagina.
topNumberLa posizione verticale del grafico in punti, misurata dall'angolo in alto a sinistra della pagina.
widthNumberLa larghezza del grafico in punti.
heightNumberL'altezza del grafico in punti.

Indietro

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 dell'elemento SheetsChart fornito nella pagina.

La posizione dell'elemento inserito in questa pagina è determinata dalla posizione dell'elemento sorgente nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dall'interno del file di presentazione corrente, anche le proprietà ereditate dalle pagine master o di layout vengono ereditate nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà ereditate 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

NomeTipoDescrizione
sheetsChartSheetsChartIl grafico del foglio da copiare e inserire.

Indietro

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 una dimensione predefinita nell'angolo in alto a sinistra della pagina.

L'immagine inserita del grafico 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

NomeTipoDescrizione
sourceChartEmbeddedChartIl grafico in un foglio di lavoro da inserire nella pagina.

Indietro

Image: l'immagine inserita del grafico 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 scalata e centrata rispetto alle dimensioni fornite.

L'immagine inserita del grafico 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

NomeTipoDescrizione
sourceChartEmbeddedChartIl grafico in un foglio di lavoro da inserire nella pagina.
leftNumberLa posizione orizzontale del grafico in punti, misurata dall'angolo in alto a sinistra della pagina.
topNumberLa posizione verticale del grafico in punti, misurata dall'angolo in alto a sinistra della pagina.
widthNumberLa larghezza del grafico in punti.
heightNumberL'altezza del grafico in punti.

Indietro

Image: l'immagine inserita del grafico 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 in modo uniforme.

Parametri

NomeTipoDescrizione
numRowsIntegerIl numero di righe nella tabella.
numColumnsIntegerIl numero di colonne nella tabella.

Indietro

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 fornite.

Le righe e le colonne sono distribuite in modo uniforme nella tabella creata.

Parametri

NomeTipoDescrizione
numRowsIntegerIl numero di righe nella tabella.
numColumnsIntegerIl numero di colonne nella tabella.
leftNumberLa posizione orizzontale della tabella, misurata dall'angolo in alto a sinistra della pagina.
topNumberLa posizione verticale della tabella, misurata dall'angolo in alto a sinistra della pagina.
widthNumberLa larghezza della tabella.
heightNumberL'altezza minima della tabella. L'altezza effettiva della tabella visualizzata dipende da fattori quali le dimensioni del carattere del testo.

Indietro

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 dell'elemento Table fornito nella pagina.

La posizione dell'elemento inserito in questa pagina è determinata dalla posizione dell'elemento sorgente nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dall'interno del file di presentazione corrente, anche le proprietà ereditate dalle pagine master o di layout vengono ereditate nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà ereditate 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

NomeTipoDescrizione
tableTableLa tabella da copiare e inserire.

Indietro

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 una casella di testo Shape contenente la stringa fornita nella pagina.

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

NomeTipoDescrizione
textStringLa stringa che deve contenere la forma della casella di testo.

Indietro

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 una casella di testo Shape contenente la stringa fornita nella pagina.

// 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

NomeTipoDescrizione
textStringLa stringa che deve contenere la forma della casella di testo.
leftNumberLa posizione orizzontale della forma della casella di testo, misurata dall'angolo in alto a sinistra della pagina.
topNumberLa posizione verticale della forma della casella di testo, misurata dall'angolo in alto a sinistra della pagina.
widthNumberLa larghezza della forma della casella di testo.
heightNumberL'altezza della forma della casella di testo.

Indietro

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 una dimensione predefinita.

Al momento sono supportati solo i video di YouTube.

Parametri

NomeTipoDescrizione
videoUrlStringL'URL del video da inserire.

Indietro

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 fornite.

Al momento sono supportati solo i video di YouTube.

Parametri

NomeTipoDescrizione
videoUrlStringL'URL del video da inserire.
leftNumberLa posizione orizzontale del video in punti, misurata dall'angolo in alto a sinistra della pagina.
topNumberLa posizione verticale del video in punti, misurata dall'angolo in alto a sinistra della pagina.
widthNumberLa larghezza del video in punti.
heightNumberL'altezza del video in punti.

Indietro

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 dell'elemento Video fornito nella pagina.

La posizione dell'elemento inserito in questa pagina è determinata dalla posizione dell'elemento sorgente nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dall'interno del file di presentazione corrente, anche le proprietà ereditate dalle pagine master o di layout vengono ereditate nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà ereditate 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

NomeTipoDescrizione
videoVideoIl video da copiare e inserire.

Indietro

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 dell'elemento WordArt fornito nella pagina.

La posizione dell'elemento inserito in questa pagina è determinata dalla posizione dell'elemento sorgente nella rispettiva pagina.

Se l'elemento fornito è un segnaposto copiato dall'interno del file di presentazione corrente, anche le proprietà ereditate dalle pagine master o di layout vengono ereditate nell'elemento inserito.

Se l'elemento fornito è un segnaposto copiato da un'altra presentazione, le proprietà ereditate 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

NomeTipoDescrizione
wordArtWordArtIl gruppo da copiare e inserire.

Indietro

WordArt: la word art 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 di ricerca con il testo sostitutivo. La ricerca non distingue tra maiuscole e minuscole.

Parametri

NomeTipoDescrizione
findTextStringIl testo da trovare.
replaceTextStringIl testo con cui sostituire il testo corrispondente.

Indietro

Integer: il numero di occorrenze è cambiato

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 di ricerca con il testo sostitutivo.

Parametri

NomeTipoDescrizione
findTextStringIl testo da trovare.
replaceTextStringIl testo con cui sostituire il testo corrispondente.
matchCaseBooleanSe true, la ricerca è sensibile alle maiuscole; se false, la ricerca non distingue tra maiuscole e minuscole.

Indietro

Integer: il numero di occorrenze è cambiato

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

Seleziona Page nella presentazione attiva come current page selection e rimuove qualsiasi selezione precedente.

Uno script può accedere solo alla selezione dell'utente che lo esegue e solo se lo script è associato 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