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
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
get | Page | Recupera lo sfondo della pagina. |
get | Color | Recupera l'elemento Color associato alla pagina. |
get | Group[] | Restituisce l'elenco degli oggetti Group nella pagina. |
get | Image[] | Restituisce l'elenco degli oggetti Image nella pagina. |
get | Layout[] | Recupera i layout di questo master. |
get | Line[] | Restituisce l'elenco degli oggetti Line nella pagina. |
get | String | Recupera l'ID univoco della pagina. |
get | Page | Restituisce Page nella pagina con l'ID specificato o null se non esiste. |
get | Page | Restituisce l'elenco degli oggetti Page visualizzati nella pagina. |
get | Page | Restituisce il tipo di pagina. |
get | Page | Restituisce l'oggetto segnaposto Page per un Placeholder o un null specificato se non è presente un segnaposto corrispondente. |
get | Page | Restituisce l'oggetto segnaposto Page per un Placeholder specificato e
un indice segnaposto oppure null se il segnaposto non è presente. |
get | Page | Restituisce l'elenco degli oggetti segnaposto Page nella pagina. |
get | Shape[] | Restituisce l'elenco degli oggetti Shape nella pagina. |
get | Sheets | Restituisce l'elenco degli oggetti Sheets nella pagina. |
get | Table[] | Restituisce l'elenco degli oggetti Table nella pagina. |
get | Video[] | Restituisce l'elenco degli oggetti Video nella pagina. |
get | Word | Restituisce l'elenco degli oggetti Word nella pagina. |
group(pageElements) | Group | Raggruppa tutti gli elementi della pagina specificati. |
insert | Group | Inserisce una copia dell'elemento Group fornito nella pagina. |
insert | Image | Inserisce un'immagine nell'angolo in alto a sinistra della pagina con una dimensione predefinita dal blob immagine specificato. |
insert | Image | Inserisce un'immagine nella pagina con la posizione e le dimensioni fornite dal blob immagine specificato. |
insert | Image | Inserisce una copia dell'elemento Image fornito nella pagina. |
insert | Image | Inserisce un'immagine nell'angolo in alto a sinistra della pagina con una dimensione predefinita dall'URL fornito. |
insert | Image | Inserisce un'immagine nella pagina con la posizione e le dimensioni fornite dall'URL specificato. |
insert | Line | Inserisce una copia dell'elemento Line fornito nella pagina. |
insert | Line | Inserisce una linea nella pagina che collega due connection sites. |
insert | Line | Inserisce una linea nella pagina. |
insert | Page | Inserisce una copia dell'elemento Page fornito nella pagina. |
insert | Shape | Inserisce una copia dell'elemento Shape fornito nella pagina. |
insert | Shape | Inserisce una forma nella pagina. |
insert | Shape | Inserisce una forma nella pagina. |
insert | Sheets | Inserisce un grafico di Fogli Google nella pagina. |
insert | Sheets | Inserisce un grafico di Fogli Google nella pagina con la posizione e le dimensioni fornite. |
insert | Sheets | Inserisce una copia dell'elemento Sheets fornito nella pagina. |
insert | Image | Inserisce un grafico di Fogli Google come Image nella pagina. |
insert | Image | Inserisce un grafico di Fogli Google come Image nella pagina con la posizione e le dimensioni fornite. |
insert | Table | Inserisce una tabella nella pagina. |
insert | Table | Inserisce una tabella nella pagina con la posizione e le dimensioni fornite. |
insert | Table | Inserisce una copia dell'elemento Table fornito nella pagina. |
insert | Shape | Inserisce una casella di testo Shape contenente la stringa fornita nella pagina. |
insert | Shape | Inserisce una casella di testo Shape contenente la stringa fornita nella pagina. |
insert | Video | Inserisce un video nell'angolo in alto a sinistra della pagina con una dimensione predefinita. |
insert | Video | Inserisce un video nella pagina con la posizione e le dimensioni fornite. |
insert | Video | Inserisce una copia dell'elemento Video fornito nella pagina. |
insert | Word | Inserisce una copia dell'elemento Word fornito nella pagina. |
remove() | void | Rimuove la pagina. |
replace | Integer | Sostituisce tutte le istanze di testo corrispondenti al testo di ricerca con il testo sostitutivo. |
replace | Integer | Sostituisce tutte le istanze di testo corrispondenti al testo di ricerca con il testo sostitutivo. |
select | void | Seleziona Page nella presentazione attiva come current page selection e rimuove qualsiasi selezione precedente. |
Documentazione dettagliata
get Background()
Recupera lo sfondo della pagina.
Indietro
Page: 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
get Color Scheme()
Recupera l'elemento Color associato alla pagina.
Indietro
Color: 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
get Groups()
get Images()
get Layouts()
get Lines()
get Object Id()
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
get Page Element By Id(id)
Restituisce Page 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. |
Indietro
Page: 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
get Page Elements()
Restituisce l'elenco degli oggetti Page visualizzati nella pagina.
Indietro
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
get Page Type()
get Placeholder(placeholderType)
Restituisce l'oggetto segnaposto Page per un Placeholder 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
| Nome | Tipo | Descrizione |
|---|---|---|
placeholder | Placeholder |
Indietro
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
get Placeholder(placeholderType, placeholderIndex)
Restituisce l'oggetto segnaposto Page per un Placeholder 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
| Nome | Tipo | Descrizione |
|---|---|---|
placeholder | Placeholder | |
placeholder | Integer |
Indietro
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
get Placeholders()
Restituisce l'elenco degli oggetti segnaposto Page nella pagina.
const master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log( `Number of placeholders in the master: ${master.getPlaceholders().length}`, );
Indietro
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
get Shapes()
get Sheets Charts()
Restituisce l'elenco degli oggetti Sheets nella pagina.
Indietro
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
get Tables()
get Videos()
get Word Arts()
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
| Nome | Tipo | Descrizione |
|---|---|---|
page | Page | 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
insert Group(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
| Nome | Tipo | Descrizione |
|---|---|---|
group | Group | Il 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
insert Image(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 Blob 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
| Nome | Tipo | Descrizione |
|---|---|---|
blob | Blob | I 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
insert Image(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 Blob 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
| Nome | Tipo | Descrizione |
|---|---|---|
blob | Blob | 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. |
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
insert Image(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
| Nome | Tipo | Descrizione |
|---|---|---|
image | Image | L'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
insert Image(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
| Nome | Tipo | Descrizione |
|---|---|---|
image | String | L'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
insert Image(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
| Nome | Tipo | Descrizione |
|---|---|---|
image | 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. |
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
insert Line(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
| Nome | Tipo | Descrizione |
|---|---|---|
line | Line | La 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
insert Line(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
| Nome | Tipo | Descrizione |
|---|---|---|
line | Line | La categoria della riga da inserire. |
start | Connection | Il sito di connessione in cui deve essere collegato l'inizio della linea. |
end | Connection | Il 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
insert Line(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
| Nome | Tipo | Descrizione |
|---|---|---|
line | Line | La categoria della riga da inserire. |
start | Number | La posizione orizzontale del punto iniziale della linea, misurata in punti dall'angolo in alto a sinistra della pagina. |
start | Number | La posizione verticale del punto iniziale della linea, misurata in punti dall'angolo in alto a sinistra della pagina. |
end | Number | La posizione orizzontale del punto finale della linea, misurata in punti dall'angolo in alto a sinistra della pagina. |
end | Number | La 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
insert Page Element(pageElement)
Inserisce una copia dell'elemento Page 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
| Nome | Tipo | Descrizione |
|---|---|---|
page | Page | L'elemento della pagina da copiare e inserire. |
Indietro
Page: 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
insert Shape(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
| Nome | Tipo | Descrizione |
|---|---|---|
shape | Shape | La 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
insert Shape(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
| Nome | Tipo | Descrizione |
|---|---|---|
shape | Shape | Il 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
insert Shape(shapeType, left, top, width, height)
Inserisce una forma nella pagina.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
shape | Shape | 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. |
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
insert Sheets Chart(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
| Nome | Tipo | Descrizione |
|---|---|---|
source | Embedded | Il grafico in un foglio di lavoro da inserire nella pagina. |
Indietro
Sheets: 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
insert Sheets Chart(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
| Nome | Tipo | Descrizione |
|---|---|---|
source | Embedded | 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. |
Indietro
Sheets: 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
insert Sheets Chart(sheetsChart)
Inserisce una copia dell'elemento Sheets 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
| Nome | Tipo | Descrizione |
|---|---|---|
sheets | Sheets | Il grafico del foglio da copiare e inserire. |
Indietro
Sheets: 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
insert Sheets Chart As Image(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
| Nome | Tipo | Descrizione |
|---|---|---|
source | Embedded | Il 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
insert Sheets Chart As Image(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
| Nome | Tipo | Descrizione |
|---|---|---|
source | Embedded | 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. |
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
insert Table(numRows, numColumns)
Inserisce una tabella nella pagina.
La tabella è centrata nella pagina con dimensioni predefinite e righe e colonne distribuite in modo uniforme.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
num | Integer | Il numero di righe nella tabella. |
num | Integer | Il 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
insert Table(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
| Nome | Tipo | Descrizione |
|---|---|---|
num | Integer | Il numero di righe nella tabella. |
num | 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 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
insert Table(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
| Nome | Tipo | Descrizione |
|---|---|---|
table | Table | La 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
insert Text Box(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
| Nome | Tipo | Descrizione |
|---|---|---|
text | String | La 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
insert Text Box(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
| Nome | Tipo | Descrizione |
|---|---|---|
text | String | La stringa che deve contenere la forma della casella di testo. |
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. |
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
insert Video(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
| Nome | Tipo | Descrizione |
|---|---|---|
video | String | L'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
insert Video(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
| Nome | Tipo | Descrizione |
|---|---|---|
video | 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. |
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
insert Video(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
| Nome | Tipo | Descrizione |
|---|---|---|
video | Video | Il 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
insert Word Art(wordArt)
Inserisce una copia dell'elemento Word 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
| Nome | Tipo | Descrizione |
|---|---|---|
word | Word | Il gruppo da copiare e inserire. |
Indietro
Word: 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
replace All Text(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
| Nome | Tipo | Descrizione |
|---|---|---|
find | String | Il testo da trovare. |
replace | String | Il 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
replace All Text(findText, replaceText, matchCase)
Sostituisce tutte le istanze di testo corrispondenti al testo di ricerca con il testo sostitutivo.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
find | String | Il testo da trovare. |
replace | String | Il testo con cui sostituire il testo corrispondente. |
match | Boolean | Se 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
select As Current Page()
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