Eine Präsentation
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
addEditor(emailAddress) | Presentation | Fügt den angegebenen Nutzer der Liste der Bearbeiter für Presentation hinzu. |
addEditor(user) | Presentation | Fügt den angegebenen Nutzer der Liste der Bearbeiter für Presentation hinzu. |
addEditors(emailAddresses) | Presentation | Fügt das angegebene Array von Nutzern der Liste der Bearbeiter für Presentation hinzu. |
addViewer(emailAddress) | Presentation | Fügt den angegebenen Nutzer der Liste der Betrachter für Presentation hinzu. |
addViewer(user) | Presentation | Fügt den angegebenen Nutzer der Liste der Betrachter für Presentation hinzu. |
addViewers(emailAddresses) | Presentation | Fügt das angegebene Array von Nutzern der Liste der Betrachter für Presentation hinzu. |
appendSlide() | Slide | Hängt eine Folie mit dem vordefinierten Layout PredefinedLayout.BLANK basierend auf dem aktuellen Master an das Ende der Präsentation an. |
appendSlide(layout) | Slide | Hängt eine Folie im angegebenen Layout des aktuellen Masters an das Ende der Präsentation an. |
appendSlide(predefinedLayout) | Slide | Hängt eine Folie im angegebenen vordefinierten Layout basierend auf dem aktuellen Master an das Ende der Präsentation an. |
appendSlide(slide) | Slide | Hängt eine Kopie der angegebenen Slide an das Ende der Präsentation an. |
appendSlide(slide, linkingMode) | Slide | Hängt eine Kopie des bereitgestellten Slide aus der Quellpräsentation an das Ende der aktuellen Präsentation an und legt den Folienlink wie in SlideLinkingMode angegeben fest. |
getEditors() | User[] | Ruft die Liste der Bearbeiter für diesen Presentation ab. |
getId() | String | Ruft die eindeutige ID der Präsentation ab. |
getLayouts() | Layout[] | Ruft die Layouts in der Präsentation ab. |
getMasters() | Master[] | Ruft die Master in der Präsentation ab. |
getName() | String | Ruft den Namen oder Titel der Präsentation ab. |
getNotesMaster() | NotesMaster | Ruft den Notizenmaster der Präsentation ab. |
getNotesPageHeight() | Number | Ruft die Seitenhöhe der Notizenseite und der Notizenseiten in der Präsentation in Punkten ab. |
getNotesPageWidth() | Number | Ruft die Seitenbreite des Notizenmasters und der Notizenseiten in der Präsentation in Punkten ab. |
getPageElementById(id) | PageElement | Gibt das PageElement mit der angegebenen ID oder null zurück, wenn keine vorhanden ist. |
getPageHeight() | Number | Ruft die Seitenhöhe der Folien, Layouts und Master der Präsentation in Punkten ab. |
getPageWidth() | Number | Ruft die Seitenbreite der Folien, Layouts und Master in der Präsentation in Punkten ab. |
getSelection() | Selection | Ruft die Auswahl des Nutzers in der aktiven Präsentation ab. |
getSlideById(id) | Slide | Gibt das Slide mit der angegebenen ID oder null zurück, wenn keine vorhanden ist. |
getSlides() | Slide[] | Ruft die Folien in der Präsentation ab. |
getUrl() | String | Ruft die URL für den Zugriff auf diese Präsentation ab. |
getViewers() | User[] | Liste der Betrachter und Kommentatoren für diesen Presentation abrufen |
insertSlide(insertionIndex) | Slide | Fügt eine Folie am angegebenen Index in der Präsentation mit dem vordefinierten Layout PredefinedLayout.BLANK basierend auf dem aktuellen Master ein. |
insertSlide(insertionIndex, layout) | Slide | Fügt eine Folie mit dem angegebenen Layout basierend auf dem aktuellen Master in die Präsentation am angegebenen Index ein. |
insertSlide(insertionIndex, predefinedLayout) | Slide | Fügt eine Folie mit dem angegebenen vordefinierten Layout basierend auf dem aktuellen Master in die Präsentation am angegebenen Index ein. |
insertSlide(insertionIndex, slide) | Slide | Fügt eine Kopie des bereitgestellten Slide am angegebenen Index in die Präsentation ein. |
insertSlide(insertionIndex, slide, linkingMode) | Slide | Fügt eine Kopie der bereitgestellten Slide aus der Quellpräsentation in den angegebenen Index in der aktuellen Präsentation ein und legt den Folienlink wie in SlideLinkingMode angegeben fest. |
removeEditor(emailAddress) | Presentation | Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Presentation . |
removeEditor(user) | Presentation | Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Presentation . |
removeViewer(emailAddress) | Presentation | Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Presentation . |
removeViewer(user) | Presentation | Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Presentation . |
replaceAllText(findText, replaceText) | Integer | Ersetzt alle Vorkommnisse von Text, der mit „Text suchen“ übereinstimmt, durch „Text ersetzen“. |
replaceAllText(findText, replaceText, matchCase) | Integer | Ersetzt alle Vorkommnisse von Text, der mit „Text suchen“ übereinstimmt, durch „Text ersetzen“. |
saveAndClose() | void | Speichert den aktuellen Presentation . |
setName(name) | void | Legt den Namen oder Titel der Präsentation fest. |
Detaillierte Dokumentation
addEditor(emailAddress)
Fügt den angegebenen Nutzer der Liste der Bearbeiter für Presentation
hinzu. Wenn der Nutzer bereits in der Liste der Betrachter enthalten war, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des Nutzers, der hinzugefügt werden soll. |
Return
Presentation
: Dieses Presentation
für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addEditor(user)
Fügt den angegebenen Nutzer der Liste der Bearbeiter für Presentation
hinzu. Wenn der Nutzer bereits in der Liste der Betrachter enthalten war, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des hinzuzufügenden Nutzers. |
Return
Presentation
: Dieses Presentation
für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addEditors(emailAddresses)
Fügt das angegebene Array von Nutzern der Liste der Bearbeiter für Presentation
hinzu. Wenn einer der Nutzer bereits in der Liste der Betrachter enthalten war, wird er mit dieser Methode aus der Liste der Betrachter herausgestuft.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddresses | String[] | Ein Array mit E-Mail-Adressen der hinzuzufügenden Nutzer. |
Return
Presentation
: Dieses Presentation
für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addViewer(emailAddress)
Fügt den angegebenen Nutzer der Liste der Betrachter für Presentation
hinzu. Wenn sich der Nutzer bereits in der Liste der Bearbeiter befand, hat diese Methode keine Auswirkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des Nutzers, der hinzugefügt werden soll. |
Return
Presentation
: Dieses Presentation
für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addViewer(user)
Fügt den angegebenen Nutzer der Liste der Betrachter für Presentation
hinzu. Wenn sich der Nutzer bereits in der Liste der Bearbeiter befand, hat diese Methode keine Auswirkungen.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des hinzuzufügenden Nutzers. |
Return
Presentation
: Dieses Presentation
für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
addViewers(emailAddresses)
Fügt das angegebene Array von Nutzern der Liste der Betrachter für Presentation
hinzu. Wenn sich Nutzer bereits in der Liste der Bearbeiter befanden, hat diese Methode keine Auswirkungen auf sie.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddresses | String[] | Ein Array mit E-Mail-Adressen der hinzuzufügenden Nutzer. |
Return
Presentation
: Dieses Presentation
für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendSlide()
Hängt eine Folie mit dem vordefinierten Layout PredefinedLayout.BLANK
basierend auf dem aktuellen Master an das Ende der Präsentation an. Der aktuelle Master ist einer der folgenden:
- Der Master der aktuellen letzten Folie.
- Der erste Master in der Präsentation, falls keine Folie vorhanden ist.
Return
Slide
: Die neue Folie, die angehängt wird.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendSlide(layout)
Hängt eine Folie im angegebenen Layout des aktuellen Masters an das Ende der Präsentation an. Der aktuelle Master ist einer der folgenden:
- Der Master der aktuellen letzten Folie.
- Der erste Master in der Präsentation, falls keine Folie vorhanden ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
layout | Layout | Das Layout, das für die neue Folie verwendet werden soll. Es sollte im aktuellen Master vorhanden sein. |
Return
Slide
: Die neue Folie, die angehängt wird.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendSlide(predefinedLayout)
Hängt eine Folie im angegebenen vordefinierten Layout basierend auf dem aktuellen Master an das Ende der Präsentation an. Der aktuelle Master ist einer der folgenden:
- Der Master der aktuellen letzten Folie.
- Der erste Master in der Präsentation, falls keine Folie vorhanden ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
predefinedLayout | PredefinedLayout | Das vordefinierte Layout für die neue Folie; sollte im aktuellen Master vorhanden sein. |
Return
Slide
: Die neue Folie, die angehängt wird.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendSlide(slide)
Hängt eine Kopie der angegebenen Slide
an das Ende der Präsentation an.
Wenn die kopierte Folie aus einer anderen Präsentation stammt, werden auch die übergeordneten Master- und Layoutseiten kopiert, sofern sie in dieser Präsentation noch nicht vorhanden sind.
// Copy a slide from another presentation and appends it. var otherPresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = otherPresentation.getSlides()[0]; currentPresentation.appendSlide(slide);
Parameter
Name | Typ | Beschreibung |
---|---|---|
slide | Slide | Die Folie, die kopiert und angehängt werden soll. |
Return
Slide
: Die neue Folie, die angehängt wird.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendSlide(slide, linkingMode)
Hängt eine Kopie des bereitgestellten Slide
aus der Quellpräsentation an das Ende der aktuellen Präsentation an und legt den Folienlink wie in SlideLinkingMode
angegeben fest.
Wenn die kopierte Folie aus einer anderen Präsentation stammt, werden auch die übergeordneten Master- und Layoutseiten kopiert, sofern sie in der aktuellen Präsentation noch nicht vorhanden sind.
Wenn der Verknüpfungsmodus SlideLinkingMode.LINKED
ist, kann die angehängte Folie so aktualisiert werden, dass sie der angegebenen Quellfolie entspricht, wenn Slide.refreshSlide()
aufgerufen wird. Andere Mitbearbeiter können den Link zur Quellfolie sehen. SlideLinkingMode.LINKED
kann nicht mit Quellfolien aus der aktuellen Präsentation verwendet werden.
// Copy a slide from another presentation, then append and link it. var sourcePresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = sourcePresentation.getSlides()[0]; var appendedSlide = currentPresentation.appendSlide(slide, SlidesApp.SlideLinkingMode.LINKED);
Parameter
Name | Typ | Beschreibung |
---|---|---|
slide | Slide | Die Folie, die kopiert, angehängt und verknüpft werden soll. |
linkingMode | SlideLinkingMode | Der zu verwendende Linkmodus. |
Return
Slide
– die neue Folie.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEditors()
Ruft die Liste der Bearbeiter für diesen Presentation
ab.
Return
User[]
: Ein Array von Nutzern mit Bearbeitungsberechtigung.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getId()
Ruft die eindeutige ID der Präsentation ab. Die Präsentations-ID wird mit SlidesApp.openById()
verwendet, um eine bestimmte Präsentationsinstanz zu öffnen.
Return
String
: Die ID der Präsentation.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLayouts()
Ruft die Layouts in der Präsentation ab.
Return
Layout[]
– Die Liste der Layouts in dieser Präsentation.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getMasters()
Ruft die Master in der Präsentation ab.
Return
Master[]
: Die Liste der Master in dieser Präsentation.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getName()
Ruft den Namen oder Titel der Präsentation ab.
Return
String
: Der Titel der Präsentation.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getNotesMaster()
Ruft den Notizenmaster der Präsentation ab.
Return
NotesMaster
: Der Notizenmaster der Präsentation.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getNotesPageHeight()
Ruft die Seitenhöhe der Notizenseite und der Notizenseiten in der Präsentation in Punkten ab. Die Seitenhöhe ist für alle gleich.
Return
Number
: Die Höhe der Notizenseite in Punkten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getNotesPageWidth()
Ruft die Seitenbreite des Notizenmasters und der Notizenseiten in der Präsentation in Punkten ab. Alle haben dieselbe Seitenbreite.
Return
Number
: Die Breite der Notizenseite in Punkten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementById(id)
Gibt das PageElement
mit der angegebenen ID oder null
zurück, wenn keine vorhanden ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
id | String | Die ID des abgerufenen Seitenelements. |
Return
PageElement
: das Seitenelement mit der angegebenen ID.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageHeight()
Ruft die Seitenhöhe der Folien, Layouts und Master der Präsentation in Punkten ab. Die Seitenhöhe ist für alle gleich.
Return
Number
: Die Seitenhöhe in Punkten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageWidth()
Ruft die Seitenbreite der Folien, Layouts und Master in der Präsentation in Punkten ab. Alle haben dieselbe Seitenbreite.
Return
Number
: Die Seitenbreite in Punkten.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSelection()
Ruft die Auswahl des Nutzers in der aktiven Präsentation ab. Ein Skript kann nur auf die Auswahl des Nutzers zugreifen, der das Skript ausführt, und auch nur dann, wenn das Skript an die Präsentation gebunden ist.
Die zurückgegebene Auswahl ist die aktuell gültige Auswahl. Während das Skript verschiedene Änderungen an der Präsentation vornimmt, wird die Auswahl entsprechend angepasst. Wenn beispielsweise zwei Formen A und B ausgewählt werden und das Skript dann Form B entfernt, wird das zurückgegebene Auswahlobjekt implizit aktualisiert, sodass nur Form A ausgewählt wird.
// Gets the current active page that is selected in the active presentation. var selection = SlidesApp.getActivePresentation().getSelection(); var currentPage = selection.getCurrentPage();
Return
Selection
: Eine Darstellung der Auswahl des Nutzers oder null
, wenn das Skript nicht an die Präsentation gebunden ist oder keine gültige Nutzerauswahl vorhanden ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlideById(id)
Gibt das Slide
mit der angegebenen ID oder null
zurück, wenn keine vorhanden ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
id | String | Die ID der abgerufenen Folie. |
Return
Slide
: Die Folie mit der angegebenen ID.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlides()
Ruft die Folien in der Präsentation ab.
Return
Slide[]
– Die Liste der Folien in dieser Präsentation.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getUrl()
Ruft die URL für den Zugriff auf diese Präsentation ab.
var presentation = SlidesApp.getActivePresentation(); // Send out the link to open the presentation. MailApp.sendEmail("<email-address>", presentation.getName(), presentation.getUrl());
Return
String
: Die URL für den Zugriff auf die aktuelle Präsentation.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getViewers()
Liste der Betrachter und Kommentatoren für diesen Presentation
abrufen
Return
User[]
: ein Array von Nutzern mit Lese- oder Kommentarberechtigung.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex)
Fügt eine Folie am angegebenen Index in der Präsentation mit dem vordefinierten Layout PredefinedLayout.BLANK
basierend auf dem aktuellen Master ein. Der aktuelle Master ist einer der folgenden:
- Der Master der vorherigen Folie.
- Master der ersten Folie, wenn der Wert für die Einfügung (EinfügungIndex) null ist.
- Der erste Master in der Präsentation, falls keine Folie vorhanden ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
insertionIndex | Integer | Der nullbasierte Index, der angibt, wo die Folie eingefügt werden soll. |
Return
Slide
: Die neue Folie, die eingefügt wird.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex, layout)
Fügt eine Folie mit dem angegebenen Layout basierend auf dem aktuellen Master in die Präsentation am angegebenen Index ein. Der aktuelle Master ist einer der folgenden:
- Der Master der vorherigen Folie.
- Master der ersten Folie, wenn der Wert für die Einfügung (EinfügungIndex) null ist.
- Der erste Master in der Präsentation, falls keine Folie vorhanden ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
insertionIndex | Integer | Der nullbasierte Index, der angibt, wo die Folie eingefügt werden soll. |
layout | Layout | Das Layout, das für die neue Folie verwendet werden soll. Es sollte im aktuellen Master vorhanden sein. |
Return
Slide
: Die neue Folie, die eingefügt wird.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex, predefinedLayout)
Fügt eine Folie mit dem angegebenen vordefinierten Layout basierend auf dem aktuellen Master in die Präsentation am angegebenen Index ein. Der aktuelle Master ist einer der folgenden:
- Der Master der vorherigen Folie.
- Master der ersten Folie, wenn der Wert für die Einfügung (EinfügungIndex) null ist.
- Der erste Master in der Präsentation, falls keine Folie vorhanden ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
insertionIndex | Integer | Der nullbasierte Index, der angibt, wo die Folie eingefügt werden soll. |
predefinedLayout | PredefinedLayout | Das vordefinierte Layout für die neue Folie; sollte im aktuellen Master vorhanden sein. |
Return
Slide
: Die neue Folie, die eingefügt wird.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex, slide)
Fügt eine Kopie des bereitgestellten Slide
am angegebenen Index in die Präsentation ein.
Wenn die kopierte Folie aus einer anderen Präsentation stammt, werden auch die übergeordneten Master- und Layoutseiten kopiert, sofern sie in dieser Präsentation noch nicht vorhanden sind.
// Copy a slide from another presentation and inserts it. var otherPresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = otherPresentation.getSlides()[0]; var insertionIndex = 1; currentPresentation.insertSlide(insertionIndex, slide);
Parameter
Name | Typ | Beschreibung |
---|---|---|
insertionIndex | Integer | Der nullbasierte Index, der angibt, wo die Folie eingefügt werden soll. |
slide | Slide | Folie, die kopiert und eingefügt werden soll |
Return
Slide
: Die neue Folie, die eingefügt wird.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSlide(insertionIndex, slide, linkingMode)
Fügt eine Kopie der bereitgestellten Slide
aus der Quellpräsentation in den angegebenen Index in der aktuellen Präsentation ein und legt den Folienlink wie in SlideLinkingMode
angegeben fest.
Wenn die kopierte Folie aus einer anderen Präsentation stammt, werden auch die übergeordneten Master- und Layoutseiten kopiert, sofern sie in der aktuellen Präsentation noch nicht vorhanden sind.
Wenn der Linkmodus SlideLinkingMode.LINKED
ist, kann die eingefügte Folie aktualisiert werden, damit sie der angegebenen Quellfolie entspricht, wenn Slide.refreshSlide()
aufgerufen wird. Andere Mitbearbeiter können den Link zur Quellfolie sehen. SlideLinkingMode.LINKED
kann nicht mit Quellfolien aus der aktuellen Präsentation verwendet werden.
// Copy a slide from another presentation, then insert and link it. var sourcePresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = sourcePresentation.getSlides()[0]; var insertionIndex = 1; var insertedSlide = currentPresentation.insertSlide( insertionIndex, slide, SlidesApp.SlideLinkingMode.LINKED);
Parameter
Name | Typ | Beschreibung |
---|---|---|
insertionIndex | Integer | Der nullbasierte Index, der angibt, wo die Folie eingefügt werden soll. |
slide | Slide | Folie, die kopiert und eingefügt werden soll |
linkingMode | SlideLinkingMode | Der zu verwendende Linkmodus. |
Return
Slide
– die neue Folie.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeEditor(emailAddress)
Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Presentation
. Diese Methode verhindert nicht, dass Nutzer auf Presentation
zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinen Zugriff gehören. Das ist z. B. der Fall, wenn Presentation
für die gesamte Domain des Nutzers freigegeben ist oder wenn sich Presentation
in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer auch aus der Liste der Viewer entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des Nutzers, der entfernt werden soll. |
Return
Presentation
: Dieses Presentation
für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeEditor(user)
Entfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Presentation
. Diese Methode verhindert nicht, dass Nutzer auf Presentation
zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinen Zugriff gehören. Das ist z. B. der Fall, wenn Presentation
für die gesamte Domain des Nutzers freigegeben ist oder wenn sich Presentation
in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer auch aus der Liste der Viewer entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des Nutzers, der entfernt werden soll. |
Return
Presentation
: Dieses Presentation
für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeViewer(emailAddress)
Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Presentation
. Diese Methode hat keine Auswirkungen, wenn der Nutzer Bearbeiter und kein Betrachter oder Kommentator ist. Außerdem wird durch diese Methode nicht verhindert, dass Nutzer auf Presentation
zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn die Presentation
für die gesamte Domain des Nutzers freigegeben ist oder wenn sich Presentation
in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer auch aus der Liste der Bearbeiter entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
emailAddress | String | Die E-Mail-Adresse des Nutzers, der entfernt werden soll. |
Return
Presentation
: Presentation
für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeViewer(user)
Entfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Presentation
. Diese Methode hat keine Auswirkungen, wenn der Nutzer Bearbeiter und kein Betrachter ist. Außerdem verhindert diese Methode nicht, dass Nutzer auf Presentation
zugreifen, wenn sie zu einer Klasse von Nutzern mit allgemeinem Zugriff gehören, z. B. wenn Presentation
für die gesamte Domain des Nutzers freigegeben ist oder wenn sich Presentation
in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.
Bei Drive-Dateien wird der Nutzer auch aus der Liste der Bearbeiter entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
user | User | Eine Darstellung des Nutzers, der entfernt werden soll. |
Return
Presentation
: Presentation
für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText)
Ersetzt alle Vorkommnisse von Text, der mit „Text suchen“ übereinstimmt, durch „Text ersetzen“. Bei der Suche wird die Groß-/Kleinschreibung nicht berücksichtigt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
findText | String | Der zu suchende Text. |
replaceText | String | Text, der den übereinstimmenden Text ersetzen soll |
Return
Integer
: Die Anzahl der Wiederholungen wurde geändert.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
Ersetzt alle Vorkommnisse von Text, der mit „Text suchen“ übereinstimmt, durch „Text ersetzen“.
Parameter
Name | Typ | Beschreibung |
---|---|---|
findText | String | Der zu suchende Text. |
replaceText | String | Text, der den übereinstimmenden Text ersetzen soll |
matchCase | Boolean | Bei true wird zwischen Groß- und Kleinschreibung unterschieden. Bei false wird die Groß- und Kleinschreibung nicht berücksichtigt. |
Return
Integer
: Die Anzahl der Wiederholungen wurde geändert.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
saveAndClose()
Speichert den aktuellen Presentation
. Führt dazu, dass ausstehende Aktualisierungen geleert und angewendet werden.
Die Methode saveAndClose()
wird am Ende der Skriptausführung für jede offene Presentation
automatisch aufgerufen, auch wenn die Skriptausführung mit einem Fehler beendet wurde.
Eine geschlossene Presentation
kann nicht bearbeitet werden. Verwenden Sie eine der geöffneten Methoden in SlidesApp
, um eine bestimmte Präsentation zur Bearbeitung erneut zu öffnen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setName(name)
Legt den Namen oder Titel der Präsentation fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | Der für diese Präsentation festzulegende Name. |
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations