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 das Presentation hinzu.
addViewer(user)PresentationFügt den angegebenen Nutzer der Liste der Betrachter für das Presentation hinzu.
addViewers(emailAddresses)PresentationFügt das angegebene Array von Nutzern der Betrachterliste für Presentation hinzu.
appendSlide()SlideHängt mithilfe der Funktion PredefinedLayout.BLANK eine Folie an das Ende der Präsentation an. vordefiniertes Layout basierend auf dem aktuellen Master.
appendSlide(layout)SlideHängt eine Folie mit dem festgelegten Layout basierend auf dem aktuellen Master.
appendSlide(predefinedLayout)SlideFügt eine Folie mit dem angegebenen vordefinierten Layout an das Ende der Präsentation an. die aktuelle Master-Instanz.
appendSlide(slide)SlideHängt eine Kopie der bereitgestellten 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 des aktuelle Präsentation und legt den Folienlink gemäß SlideLinkingMode fest.
getEditors()User[]Ruft die Liste der Bearbeiter für dieses Presentation-Element ab.
getId()StringRuft die eindeutige ID der Präsentation ab.
getLayouts()Layout[]Ruft die Layouts in der Präsentation ab.
getMasters()Master[]Ruft die Masterdateien 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 Notizenvorlage und der Notizenseiten in der Präsentation in Punkten ab.
getNotesPageWidth()NumberRuft die Seitenbreite der Notizenvorlage 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 in 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[]Ruft die Liste der Betrachter und Kommentatoren für dieses Presentation ab.
insertSlide(insertionIndex)SlideFügt eine Folie mithilfe des vordefinierten PredefinedLayout.BLANK-Layouts auf Grundlage des aktuellen Masters beim angegebenen Index in die Präsentation ein.
insertSlide(insertionIndex, layout)SlideFügt eine Folie mit dem angegebenen Layout beim angegebenen Index in die Präsentation basierend auf die aktuelle Master-Instanz.
insertSlide(insertionIndex, predefinedLayout)SlideFügt eine Folie mit dem angegebenen vordefinierten Index in der Präsentation ein. des aktuellen Master-Layouts.
insertSlide(insertionIndex, slide)SlideFügt eine Kopie der bereitgestellten Slide im angegebenen Index in der Präsentation ein.
insertSlide(insertionIndex, slide, linkingMode)SlideFügt eine Kopie des bereitgestellten Slide aus der Quellpräsentation in das angegebene in der aktuellen Präsentation und legt den Folienlink gemäß SlideLinkingMode 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 das Presentation.
removeViewer(user)PresentationEntfernt den angegebenen Nutzer aus der Liste der Betrachter und Kommentatoren für das Presentation.
replaceAllText(findText, replaceText)IntegerErsetzt alle Vorkommen von Text, der mit "Text suchen" übereinstimmt, durch "Text ersetzen".
replaceAllText(findText, replaceText, matchCase)IntegerErsetzt alle Vorkommen 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 wird der Nutzer mit dieser Methode aus der Betrachterliste hochgestuft.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des hinzuzufügenden Nutzers.

Rückflug

Presentation: Diese Presentation zum Verketten.

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 wird der Nutzer mit dieser Methode aus der Betrachterliste hochgestuft.

Parameter

NameTypBeschreibung
userUserDarstellung des hinzuzufügenden Nutzers.

Rückflug

Presentation: Diese Presentation zum Verketten.

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 eines der Nutzer, die bereits auf der Liste der Betrachter stehen, werden sie mit dieser Methode aus der Liste der Zuschauer*innen.

Parameter

NameTypBeschreibung
emailAddressesString[]Ein Array mit E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen.

Rückflug

Presentation: Diese Presentation zum Verketten.

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 das Presentation hinzu. Wenn der Nutzer auf der Liste der Bearbeiter enthält, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des hinzuzufügenden Nutzers.

Rückflug

Presentation: Diese Presentation zum Verketten.

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 das Presentation hinzu. Wenn der Nutzer auf der Liste der Bearbeiter enthält, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
userUserDarstellung des hinzuzufügenden Nutzers.

Rückflug

Presentation: Diese Presentation zum Verketten.

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 Betrachterliste für Presentation hinzu. Wenn eines der Benutzer, die bereits auf der Liste der Bearbeiter waren, hat diese Methode keine Auswirkungen auf sie.

Parameter

NameTypBeschreibung
emailAddressesString[]Ein Array mit E-Mail-Adressen der Nutzer, die hinzugefügt werden sollen.

Rückflug

Presentation: Diese Presentation zum Verketten.

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 mithilfe der Funktion PredefinedLayout.BLANK eine Folie an das Ende der Präsentation an. vordefiniertes Layout basierend auf dem aktuellen Master. Die aktuelle Master-Instanz ist eine der folgenden:

  • Der Master der aktuellen letzten Folie.
  • Der erste Master der Präsentation, falls keine Folie vorhanden ist.

Rückflug

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 mit dem festgelegten Layout basierend auf dem aktuellen Master. Der aktuelle Master ist einer der folgenden:

  • Der Master der aktuellen letzten Folie.
  • Der erste Master der Präsentation, falls keine Folie vorhanden ist.

Parameter

NameTypBeschreibung
layoutLayoutDas für die neue Folie zu verwendende Layout sollte sie im aktuellen Master vorhanden sein.

Rückflug

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)

Fügt eine Folie mit dem angegebenen vordefinierten Layout an das Ende der Präsentation an. die aktuelle Master-Instanz. Der aktuelle Master ist einer der folgenden:

  • Der Master der aktuellen letzten Folie.
  • Der erste Master der Präsentation, falls keine Folie vorhanden ist.

Parameter

NameTypBeschreibung
predefinedLayoutPredefinedLayoutDas vordefinierte Layout für die neue Folie. sollte es in der die aktuelle Master-Instanz.

Rückflug

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 bereitgestellten Slide an das Ende der Präsentation an.

Stammt die kopierte Folie aus einer anderen Präsentation, werden der übergeordnete Master und das Layout Seiten werden ebenfalls kopiert, sofern sie noch nicht in dieser Präsentation 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.

Rückflug

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 des aktuelle Präsentation und legt den Folienlink gemäß SlideLinkingMode fest.

Stammt die kopierte Folie aus einer anderen Präsentation, werden der übergeordnete Master und das Layout Seiten, die noch nicht in der aktuellen Präsentation vorhanden sind, werden ebenfalls kopiert.

Wenn der Linkmodus SlideLinkingMode.LINKED ist, kann die angehängte Folie so geändert werden, stimmt mit der angegebenen Quellfolie überein, wenn Slide.refreshSlide() aufgerufen wird. Weitere Mitbearbeiter den Link zur Quellfolie. SlideLinkingMode.LINKED kann nicht verwendet werden mit Quellfolien aus der aktuellen Präsentation.

// 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 Verknüpfungsmodus.

Rückflug

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 dieses Presentation-Element ab.

Rückflug

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.

Rückflug

String: Die ID 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

getLayouts()

Ruft die Layouts in der Präsentation ab.

Rückflug

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 Masterdateien in der Präsentation ab.

Rückflug

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.

Rückflug

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.

Rückflug

NotesMaster: Der Master für Notizen 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 Notizenvorlage und der Notizenseiten in der Präsentation in Punkten ab. Sie alle dieselbe Seitenhöhe haben.

Rückflug

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 der Notizenvorlage und der Notizenseiten in der Präsentation in Punkten ab. Alle dieselbe Seitenbreite haben.

Rückflug

Number: 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.

Rückflug

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 in der Präsentation in Punkten ab. Sie alle dieselbe Seitenhöhe haben.

Rückflug

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 dieselbe Seitenbreite haben.

Rückflug

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 den Nutzer, der das Skript ausführt, und nur dann, wenn das Skript an die Präsentation gebunden ist.

Beachten Sie, dass die zurückgegebene Auswahl die aktuell geltende Auswahl ist. Während das Skript ausgeführt wird, verschiedene Änderungen an der Präsentation vornehmen, wird die Auswahl geändert, um diese zu berücksichtigen. Wenn z. B. die beiden Formen A und B ausgewählt werden und das Skript dann die Form B entfernt, das zurückgegebene Auswahlobjekt implizit aktualisiert wird, 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();

Rückflug

Selection: Darstellung der Auswahl des Nutzers oder null, wenn das Skript nicht an folgende Adresse gebunden ist: oder wenn 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
idStringID der abzurufenden Folie

Rückflug

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.

Rückflug

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

Rückflug

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

Ruft die Liste der Betrachter und Kommentatoren für dieses Presentation ab.

Rückflug

User[]: ein Array von Nutzern mit Berechtigung zum Ansehen oder Kommentieren.

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 mit dem vordefinierten Layout PredefinedLayout.BLANK auf Grundlage des aktuellen Masters beim angegebenen Index in die Präsentation ein. Der aktuelle Master ist eines der folgenden:

  • Der Master der vorherigen Folie.
  • Master der ersten Folie, wenn der Platzhalter für den Platzhalter null ist.
  • Der erste Master der Präsentation, falls keine Folie vorhanden ist.

Parameter

NameTypBeschreibung
insertionIndexIntegerDer nullbasierte Index, der angibt, wo die Folie eingefügt werden soll.

Rückflug

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 beim angegebenen Index in die Präsentation basierend auf die aktuelle Master-Instanz. Der aktuelle Master ist einer der folgenden:

  • Der Master der vorherigen Folie.
  • Master der ersten Folie, wenn der Platzhalter für den Platzhalter null ist.
  • Der erste Master der Präsentation, falls keine Folie vorhanden ist.

Parameter

NameTypBeschreibung
insertionIndexIntegerDer nullbasierte Index, der angibt, wo die Folie eingefügt werden soll.
layoutLayoutDas für die neue Folie zu verwendende Layout sollte sie im aktuellen Master vorhanden sein.

Rückflug

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 Index in der Präsentation ein. des aktuellen Master-Layouts. Der aktuelle Master ist einer der folgenden:

  • Der Master der vorherigen Folie.
  • Master der ersten Folie, wenn der Platzhalter für den Platzhalter null ist.
  • Der erste Master 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 es in der die aktuelle Master-Instanz.

Rückflug

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 der bereitgestellten Slide im angegebenen Index in der Präsentation ein.

Stammt die kopierte Folie aus einer anderen Präsentation, werden der übergeordnete Master und das Layout Seiten, die noch nicht in dieser Präsentation vorhanden sind, werden ebenfalls kopiert.

// 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.
slideSlideDie Folie, die kopiert und eingefügt werden soll.

Rückflug

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 des bereitgestellten Slide aus der Quellpräsentation in das angegebene in der aktuellen Präsentation und legt den Folienlink gemäß SlideLinkingMode fest.

Stammt die kopierte Folie aus einer anderen Präsentation, werden der übergeordnete Master und das Layout Seiten, die noch nicht in der aktuellen Präsentation vorhanden sind, werden ebenfalls kopiert.

Wenn der Linkmodus SlideLinkingMode.LINKED ist, kann die eingefügte Folie so geändert werden, dass stimmt mit der angegebenen Quellfolie überein, wenn Slide.refreshSlide() aufgerufen wird. Weitere Mitbearbeiter den Link zur Quellfolie. SlideLinkingMode.LINKED kann nicht verwendet werden mit Quellfolien aus der aktuellen Präsentation.

// 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.
slideSlideDie Folie, die kopiert und eingefügt werden soll.
linkingModeSlideLinkingModeDer zu verwendende Verknüpfungsmodus.

Rückflug

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. Bei dieser Methode werden keine Nutzer am Zugriff auf Presentation blockieren, wenn sie zu einer Nutzerklasse gehören, die allgemeinen Zugriff haben, z. B. wenn die Presentation für das gesamte Domain oder die Presentation befindet sich in einer geteilten Ablage, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer dadurch auch aus der Betrachterliste entfernt.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des zu entfernenden Nutzers.

Rückflug

Presentation: Diese Presentation zum Verketten.

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. Bei dieser Methode werden keine Nutzer am Zugriff auf Presentation blockieren, wenn sie zu einer Nutzerklasse gehören, die allgemeinen Zugriff haben, z. B. wenn die Presentation für das gesamte Domain oder die Presentation befindet sich in einer geteilten Ablage, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer dadurch auch aus der Betrachterliste entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

Presentation: Diese Presentation zum Verketten.

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 das Presentation. Dieses hat keine Auswirkungen, wenn der Nutzer ein Bearbeiter, kein Betrachter oder Kommentator ist. Bei dieser Methode Der Zugriff auf Presentation wird nicht blockiert, wenn sie zu einer Klasse von Nutzern gehören, die allgemeinen Zugriff haben, z. B. wenn die Presentation für das oder wenn sich die Presentation in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer dadurch auch aus der Liste der Bearbeiter entfernt.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des zu entfernenden Nutzers.

Rückflug

Presentation: Diese Presentation für die Verkettung.

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 das Presentation. Dieses hat keine Auswirkungen, wenn der Nutzer ein Bearbeiter und kein Betrachter ist. Diese Methode blockiert auch nicht Nutzer, die nicht auf die Presentation zugreifen, wenn sie zu einer Nutzerklasse mit allgemeinen Zugriff haben, z. B. wenn die Presentation für die gesamte Domain des Nutzers freigegeben ist oder Presentation befindet sich in einer geteilten Ablage, auf die der Nutzer zugreifen kann.

Bei Drive-Dateien wird der Nutzer dadurch auch aus der Liste der Bearbeiter entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

Presentation: Diese Presentation für die Verkettung.

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 Vorkommen von Text, der mit "Text suchen" übereinstimmt, durch "Text ersetzen". Bei der Suche handelt es sich um die Groß-/Kleinschreibung. unsensibel.

Parameter

NameTypBeschreibung
findTextStringDer zu suchende Text.
replaceTextStringDer Text, durch den der übereinstimmende Text ersetzt werden soll.

Rückflug

Integer: Anzahl der geänderten Vorkommen

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 Vorkommen von Text, der mit "Text suchen" übereinstimmt, durch "Text ersetzen".

Parameter

NameTypBeschreibung
findTextStringDer zu suchende Text.
replaceTextStringDer Text, durch den der übereinstimmende Text ersetzt werden soll.
matchCaseBooleanWenn true, wird bei der Suche zwischen Groß- und Kleinschreibung unterschieden. Wenn false, lautet die Suche Groß- und Kleinschreibung nicht berücksichtigt werden.

Rückflug

Integer: Anzahl der geänderten Vorkommen

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. Veranlasst, dass ausstehende Updates geleert und angewendet werden.

Die Methode saveAndClose() wird am Ende der Skriptausführung automatisch aufgerufen für jede offene Presentation, auch wenn die Skriptausführung mit einem Fehler beendet wurde.

Ein geschlossener Presentation kann nicht bearbeitet werden. Verwenden Sie eine der Methoden zum Öffnen von SlidesApp, um eine bestimmte Präsentation zum Bearbeiten wieder 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