Class Presentation

Präsentation

Eine Präsentation

Methoden

MethodeRückgabetypKurzbeschreibung
addEditor(emailAddress)PresentationFügt den angegebenen Nutzer der Liste der Bearbeiter für Presentation hinzu.
addEditor(user)PresentationFügt den angegebenen Nutzer der Liste der Bearbeiter für Presentation hinzu.
addEditors(emailAddresses)PresentationFügt das angegebene Array von Nutzern der Liste der Bearbeiter für Presentation hinzu.
addViewer(emailAddress)PresentationFügt den angegebenen Nutzer der Liste der Betrachter für Presentation hinzu.
addViewer(user)PresentationFügt den angegebenen Nutzer der Liste der Betrachter für Presentation hinzu.
addViewers(emailAddresses)PresentationFügt das angegebene Array von Nutzern der Liste der Betrachter für Presentation hinzu.
appendSlide()SlideHängt eine Folie mit dem vordefinierten Layout PredefinedLayout.BLANK basierend auf dem aktuellen Master an das Ende der Präsentation an.
appendSlide(layout)SlideHängt eine Folie im angegebenen Layout des aktuellen Masters an das Ende der Präsentation an.
appendSlide(predefinedLayout)SlideHängt eine Folie im angegebenen vordefinierten Layout basierend auf dem aktuellen Master an das Ende der Präsentation an.
appendSlide(slide)SlideHängt eine Kopie der angegebenen Slide an das Ende der Präsentation an.
appendSlide(slide, linkingMode)SlideHä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()StringRuft 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()StringRuft den Namen oder Titel der Präsentation ab.
getNotesMaster()NotesMasterRuft den Notizenmaster der Präsentation ab.
getNotesPageHeight()NumberRuft die Seitenhöhe der Notizenseite und der Notizenseiten in der Präsentation in Punkten ab.
getNotesPageWidth()NumberRuft die Seitenbreite des Notizenmasters und der Notizenseiten in der Präsentation in Punkten ab.
getPageElementById(id)PageElementGibt das PageElement mit der angegebenen ID oder null zurück, wenn keine vorhanden ist.
getPageHeight()NumberRuft die Seitenhöhe der Folien, Layouts und Master der Präsentation in Punkten ab.
getPageWidth()NumberRuft die Seitenbreite der Folien, Layouts und Master in der Präsentation in Punkten ab.
getSelection()SelectionRuft die Auswahl des Nutzers in der aktiven Präsentation ab.
getSlideById(id)SlideGibt 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()StringRuft 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)SlideFü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)SlideFügt eine Folie mit dem angegebenen Layout basierend auf dem aktuellen Master in die Präsentation am angegebenen Index ein.
insertSlide(insertionIndex, predefinedLayout)SlideFügt eine Folie mit dem angegebenen vordefinierten Layout basierend auf dem aktuellen Master in die Präsentation am angegebenen Index ein.
insertSlide(insertionIndex, slide)SlideFügt eine Kopie des bereitgestellten Slide am angegebenen Index in die Präsentation ein.
insertSlide(insertionIndex, slide, linkingMode)SlideFü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)PresentationEntfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Presentation.
removeEditor(user)PresentationEntfernt den angegebenen Nutzer aus der Liste der Bearbeiter für Presentation.
removeViewer(emailAddress)PresentationEntfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Presentation.
removeViewer(user)PresentationEntfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für Presentation.
replaceAllText(findText, replaceText)IntegerErsetzt alle Vorkommnisse von Text, der mit „Text suchen“ übereinstimmt, durch „Text ersetzen“.
replaceAllText(findText, replaceText, matchCase)IntegerErsetzt alle Vorkommnisse von Text, der mit „Text suchen“ übereinstimmt, durch „Text ersetzen“.
saveAndClose()voidSpeichert den aktuellen Presentation.
setName(name)voidLegt 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

NameTypBeschreibung
emailAddressStringDie 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

NameTypBeschreibung
userUserEine 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

NameTypBeschreibung
emailAddressesString[]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

NameTypBeschreibung
emailAddressStringDie 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

NameTypBeschreibung
userUserEine 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

NameTypBeschreibung
emailAddressesString[]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

NameTypBeschreibung
layoutLayoutDas 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

NameTypBeschreibung
predefinedLayoutPredefinedLayoutDas 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

NameTypBeschreibung
slideSlideDie 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

NameTypBeschreibung
slideSlideDie Folie, die kopiert, angehängt und verknüpft werden soll.
linkingModeSlideLinkingModeDer 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

NameTypBeschreibung
idStringDie 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

NameTypBeschreibung
idStringDie 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

NameTypBeschreibung
insertionIndexIntegerDer 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

NameTypBeschreibung
insertionIndexIntegerDer nullbasierte Index, der angibt, wo die Folie eingefügt werden soll.
layoutLayoutDas 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

NameTypBeschreibung
insertionIndexIntegerDer nullbasierte Index, der angibt, wo die Folie eingefügt werden soll.
predefinedLayoutPredefinedLayoutDas 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

NameTypBeschreibung
insertionIndexIntegerDer nullbasierte Index, der angibt, wo die Folie eingefügt werden soll.
slideSlideFolie, 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

NameTypBeschreibung
insertionIndexIntegerDer nullbasierte Index, der angibt, wo die Folie eingefügt werden soll.
slideSlideFolie, die kopiert und eingefügt werden soll
linkingModeSlideLinkingModeDer 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

NameTypBeschreibung
emailAddressStringDie 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

NameTypBeschreibung
userUserEine 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

NameTypBeschreibung
emailAddressStringDie 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

NameTypBeschreibung
userUserEine 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

NameTypBeschreibung
findTextStringDer zu suchende Text.
replaceTextStringText, 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

NameTypBeschreibung
findTextStringDer zu suchende Text.
replaceTextStringText, der den übereinstimmenden Text ersetzen soll
matchCaseBooleanBei 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

NameTypBeschreibung
nameStringDer 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