Class Presentation

Präsentation

Eine Präsentation.

Methoden

MethodeRückgabetypKurzbeschreibung
addEditor(emailAddress)PresentationDer angegebene Nutzer wird der Liste der Mitbearbeiter für die Presentation hinzugefügt.
addEditor(user)PresentationDer angegebene Nutzer wird der Liste der Mitbearbeiter für die Presentation hinzugefügt.
addEditors(emailAddresses)PresentationFügt der Liste der Mitbearbeiter für die Presentation das angegebene Nutzerarray hinzu.
addViewer(emailAddress)PresentationDer angegebene Nutzer wird der Liste der Zuschauer für die Presentation hinzugefügt.
addViewer(user)PresentationDer angegebene Nutzer wird der Liste der Zuschauer für die Presentation hinzugefügt.
addViewers(emailAddresses)PresentationFügen Sie der Liste der Zuschauer für die Presentation das angegebene Nutzerarray hinzu.
appendSlide()SlideFängt am Ende der Präsentation eine Folie mit dem PredefinedLayout.BLANK-vordefinierten Layout an, das auf dem aktuellen Master basiert.
appendSlide(layout)SlideFügen Sie am Ende der Präsentation eine Folie mit dem angegebenen Layout hinzu, das auf dem aktuellen Master basiert.
appendSlide(predefinedLayout)SlideFügen Sie am Ende der Präsentation eine Folie mit dem angegebenen vordefinierten Layout hinzu, das auf dem aktuellen Master basiert.
appendSlide(slide)SlideAm Ende der Präsentation wird eine Kopie der bereitgestellten Slide angehängt.
appendSlide(slide, linkingMode)SlideFügen Sie eine Kopie der bereitgestellten Slide aus der Quellpräsentation an das Ende der aktuellen Präsentation an und legen Sie den Folienlink gemäß der SlideLinkingMode fest.
getEditors()User[]Ruft die Liste der Mitbearbeiter für diese Presentation ab.
getId()StringDie eindeutige Kennung der Präsentation wird abgerufen.
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 des Notizen-Masters und der Notizenseiten in der Präsentation in Punkten ab.
getNotesPageWidth()NumberDie Seitenbreite des Notizen-Masters und der Notizenseiten in der Präsentation in Punkten.
getPageElementById(id)PageElementGibt die PageElement mit der angegebenen ID zurück oder null, wenn keine vorhanden ist.
getPageHeight()NumberDie Seitenhöhe der Folien, Layouts und Master in der Präsentation in Punkten.
getPageWidth()NumberDie Seitenbreite der Folien, Layouts und Master in der Präsentation in Punkten.
getSelection()SelectionRuft die Auswahl des Nutzers in der aktiven Präsentation ab.
getSlideById(id)SlideGibt die Slide mit der angegebenen ID zurück oder null, 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 diese Presentation ab.
insertSlide(insertionIndex)SlideHiermit wird an der angegebenen Position in der Präsentation eine Folie mit dem vordefinierten Layout PredefinedLayout.BLANK eingefügt, das auf dem aktuellen Master basiert.
insertSlide(insertionIndex, layout)SlideHiermit wird an der angegebenen Position in der Präsentation eine Folie mit dem angegebenen Layout eingefügt, das auf dem aktuellen Master basiert.
insertSlide(insertionIndex, predefinedLayout)SlideHiermit wird an der angegebenen Position in der Präsentation eine Folie mit dem angegebenen vordefinierten Layout eingefügt, das auf dem aktuellen Master basiert.
insertSlide(insertionIndex, slide)SlideFängt eine Kopie der bereitgestellten Slide an der angegebenen Position in die Präsentation ein.
insertSlide(insertionIndex, slide, linkingMode)SlideHiermit wird eine Kopie der angegebenen Slide aus der Quellpräsentation an der angegebenen Stelle in der aktuellen Präsentation eingefügt. Der Folienlink wird gemäß der SlideLinkingMode festgelegt.
removeEditor(emailAddress)PresentationDer angegebene Nutzer wird aus der Liste der Mitbearbeiter der Presentation entfernt.
removeEditor(user)PresentationDer angegebene Nutzer wird aus der Liste der Mitbearbeiter der Presentation entfernt.
removeViewer(emailAddress)PresentationDer angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die Presentation entfernt.
removeViewer(user)PresentationDer angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die Presentation entfernt.
replaceAllText(findText, replaceText)IntegerErsetzt alle Textstellen, die mit dem Suchtext übereinstimmen, durch den Ersatztext.
replaceAllText(findText, replaceText, matchCase)IntegerErsetzt alle Textstellen, die mit dem Suchtext übereinstimmen, durch den Ersatztext.
saveAndClose()voidSpeichert die aktuelle Presentation.
setName(name)voidHier legen Sie den Namen oder Titel der Präsentation fest.

Detaillierte Dokumentation

addEditor(emailAddress)

Der angegebene Nutzer wird der Liste der Mitbearbeiter für die Presentation hinzugefügt. Wenn der Nutzer bereits auf der Liste der Zuschauer stand, wird er durch diese Methode aus der Liste entfernt.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, den Sie hinzufügen möchten.

Rückflug

Presentation – Dieses Presentation für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

addEditor(user)

Der angegebene Nutzer wird der Liste der Mitbearbeiter für die Presentation hinzugefügt. Wenn der Nutzer bereits auf der Liste der Zuschauer stand, wird er durch diese Methode aus der Liste entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Rückflug

Presentation – Dieses Presentation für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

addEditors(emailAddresses)

Fügt der Liste der Mitbearbeiter für die Presentation das angegebene Nutzerarray hinzu. Wenn sich einer der Nutzer bereits in der Liste der Zuschauer befand, wird er durch diese Methode aus der Liste entfernt.

Parameter

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

Rückflug

Presentation – Dieses Presentation für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

addViewer(emailAddress)

Der angegebene Nutzer wird der Liste der Zuschauer für die Presentation hinzugefügt. Wenn der Nutzer bereits in der Liste der Mitbearbeiter aufgeführt war, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, den Sie hinzufügen möchten.

Rückflug

Presentation – Dieses Presentation für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

addViewer(user)

Der angegebene Nutzer wird der Liste der Zuschauer für die Presentation hinzugefügt. Wenn der Nutzer bereits in der Liste der Mitbearbeiter aufgeführt war, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Rückflug

Presentation – Dieses Presentation für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

addViewers(emailAddresses)

Fügen Sie der Liste der Zuschauer für die Presentation das angegebene Nutzerarray hinzu. Wenn einer der Nutzer bereits in der Liste der Mitbearbeiter aufgeführt war, hat diese Methode keine Auswirkungen auf ihn.

Parameter

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

Rückflug

Presentation – Dieses Presentation für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendSlide()

Fängt am Ende der Präsentation eine Folie mit dem PredefinedLayout.BLANK-vordefinierten Layout an, das auf dem aktuellen Master basiert. Der aktuelle Master ist einer der folgenden:

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

Rückflug

Slide: Die neue Folie, die angehängt wird.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendSlide(layout)

Fügen Sie am Ende der Präsentation eine Folie mit dem angegebenen Layout hinzu, das auf dem aktuellen Master basiert. Der aktuelle Master ist einer der folgenden:

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

Parameter

NameTypBeschreibung
layoutLayoutDas Layout, das für die neue Folie verwendet werden soll. Es sollte im aktuellen Master vorhanden sein.

Rückflug

Slide: Die neue Folie, die angehängt wird.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendSlide(predefinedLayout)

Fügen Sie am Ende der Präsentation eine Folie mit dem angegebenen vordefinierten Layout hinzu, das auf dem aktuellen Master basiert. Der aktuelle Master ist einer der folgenden:

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

Parameter

NameTypBeschreibung
predefinedLayoutPredefinedLayoutDas vordefinierte Layout, das für die neue Folie verwendet werden soll. Es sollte im aktuellen Master vorhanden sein.

Rückflug

Slide: Die neue Folie, die angehängt wird.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendSlide(slide)

Am Ende der Präsentation wird eine Kopie der bereitgestellten Slide angehängt.

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.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const 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

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

appendSlide(slide, linkingMode)

Fügen Sie eine Kopie der bereitgestellten Slide aus der Quellpräsentation an das Ende der aktuellen Präsentation an und legen Sie den Folienlink gemäß der SlideLinkingMode 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 aktualisiert werden, damit sie der bereitgestellten Quellfolie entspricht, wenn Slide.refreshSlide() aufgerufen wird. Andere Mitbearbeiter sehen den Link zur Quellfolie. SlideLinkingMode.LINKED kann nicht mit Quellfolien aus der aktuellen Präsentation verwendet werden. 

// Copy a slide from another presentation, then append and link it.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const appendedSlide = currentPresentation.appendSlide(
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

Parameter

NameTypBeschreibung
slideSlideDie Folie, die kopiert, angehängt und verknüpft werden soll.
linkingModeSlideLinkingModeDer zu verwendende Linkmodus.

Rückflug

Slide – die neue Folie.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getEditors()

Ruft die Liste der Mitbearbeiter für diese Presentation ab.

Rückflug

User[]: Ein Array von Nutzern mit Bearbeitungsberechtigung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getId()

Die eindeutige Kennung der Präsentation wird abgerufen. Die Präsentations-ID wird mit SlidesApp.openById() verwendet, um eine bestimmte Präsentations-Instanz zu öffnen.

Rückflug

String: Die ID dieser Präsentation.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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.

Rückflug

Master[]: Liste der Masterfolien in dieser Präsentation.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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 dieser Präsentation.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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 Notizenmaster der Präsentation.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getNotesPageHeight()

Ruft die Seitenhöhe des Notizen-Masters und der Notizenseiten in der Präsentation in Punkten ab. Sie haben alle dieselbe Seitenhöhe.

Rückflug

Number: Höhe der Notizenseite in Punkten.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getNotesPageWidth()

Die Seitenbreite des Notizen-Masters und der Notizenseiten in der Präsentation in Punkten. Sie haben alle dieselbe Seitenbreite.

Rückflug

Number: Die Breite der Notizenseite in Punkten.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageElementById(id)

Gibt die PageElement mit der angegebenen ID zurück oder null, wenn keine vorhanden ist.

Parameter

NameTypBeschreibung
idStringDie ID des Seitenelements, das abgerufen wird.

Rückflug

PageElement: Das Seitenelement mit der angegebenen ID.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageHeight()

Die Seitenhöhe der Folien, Layouts und Master in der Präsentation in Punkten. Sie haben alle dieselbe Seitenhöhe.

Rückflug

Number: Die Seitenhöhe in Punkten.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageWidth()

Die Seitenbreite der Folien, Layouts und Master in der Präsentation in Punkten. Sie haben alle dieselbe Seitenbreite.

Rückflug

Number: Die Seitenbreite in Punkten.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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 Script kann nur auf die Auswahl des Nutzers zugreifen, der das Script ausführt, und nur dann, wenn das Script an die Präsentation gebunden ist.

Die zurückgegebene Auswahl ist die aktuell gültige Auswahl. Da das Script verschiedene Änderungen an der Präsentation vornimmt, wird die Auswahl entsprechend transformiert. Wenn beispielsweise zwei Formen A und B ausgewählt sind und das Script dann Form B entfernt, wird das zurückgegebene Auswahlobjekt implizit so aktualisiert, dass nur Form A ausgewählt ist. 

// Gets the current active page that is selected in the active presentation.
const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();

Rückflug

Selection – eine Darstellung der Auswahl des Nutzers oder null, wenn das Script nicht an die Präsentation gebunden ist oder keine gültige Nutzerauswahl vorliegt.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSlideById(id)

Gibt die Slide mit der angegebenen ID zurück oder null, wenn keine vorhanden ist.

Parameter

NameTypBeschreibung
idStringDie ID der Folie, die abgerufen wird.

Rückflug

Slide: Die Folie mit der angegebenen ID.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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. 

const 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

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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 diese Presentation ab.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSlide(insertionIndex)

Hiermit wird an der angegebenen Position in der Präsentation eine Folie mit dem vordefinierten Layout PredefinedLayout.BLANK eingefügt, das auf dem aktuellen Master basiert. Der aktuelle Master ist einer der folgenden:

  • Der Master der vorherigen Folie.
  • Der Master der ersten Folie, wenn der „insertionIndex“ null ist.
  • Der erste Master in der Präsentation, wenn 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

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSlide(insertionIndex, layout)

Hiermit wird an der angegebenen Position in der Präsentation eine Folie mit dem angegebenen Layout eingefügt, das auf dem aktuellen Master basiert. Der aktuelle Master ist einer der folgenden:

  • Der Master der vorherigen Folie.
  • Der Master der ersten Folie, wenn der „insertionIndex“ null ist.
  • Der erste Master in der Präsentation, wenn 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.

Rückflug

Slide: Die neue Folie, die eingefügt wird.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSlide(insertionIndex, predefinedLayout)

Hiermit wird an der angegebenen Position in der Präsentation eine Folie mit dem angegebenen vordefinierten Layout eingefügt, das auf dem aktuellen Master basiert. Der aktuelle Master ist einer der folgenden:

  • Der Master der vorherigen Folie.
  • Der Master der ersten Folie, wenn der „insertionIndex“ null ist.
  • Der erste Master in der Präsentation, wenn keine Folie vorhanden ist.

Parameter

NameTypBeschreibung
insertionIndexIntegerDer nullbasierte Index, der angibt, wo die Folie eingefügt werden soll.
predefinedLayoutPredefinedLayoutDas vordefinierte Layout, das für die neue Folie verwendet werden soll. Es sollte im aktuellen Master vorhanden sein.

Rückflug

Slide: Die neue Folie, die eingefügt wird.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSlide(insertionIndex, slide)

Fängt eine Kopie der bereitgestellten Slide an der angegebenen Position 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.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
const 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

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSlide(insertionIndex, slide, linkingMode)

Hiermit wird eine Kopie der angegebenen Slide aus der Quellpräsentation an der angegebenen Stelle in der aktuellen Präsentation eingefügt. Der Folienlink wird gemäß der SlideLinkingMode festgelegt.

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 eingefügte Folie aktualisiert werden, damit sie der bereitgestellten Quellfolie entspricht, wenn Slide.refreshSlide() aufgerufen wird. Andere Mitbearbeiter sehen den Link zur Quellfolie. SlideLinkingMode.LINKED kann nicht mit Quellfolien aus der aktuellen Präsentation verwendet werden. 

// Copy a slide from another presentation, then insert and link it.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const insertionIndex = 1;
const 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 Linkmodus.

Rückflug

Slide – die neue Folie.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

removeEditor(emailAddress)

Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der Presentation entfernt. Mit dieser Methode wird der Zugriff von Nutzern auf die Presentation nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die Presentation für die gesamte Domain des Nutzers freigegeben wurde oder 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 Betrachter entfernt.

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der entfernt werden soll.

Rückflug

Presentation – Dieses Presentation für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

removeEditor(user)

Der angegebene Nutzer wird aus der Liste der Mitbearbeiter der Presentation entfernt. Mit dieser Methode wird der Zugriff von Nutzern auf die Presentation nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die Presentation für die gesamte Domain des Nutzers freigegeben wurde oder 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 Betrachter entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

Presentation – Dieses Presentation für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

removeViewer(emailAddress)

Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die Presentation entfernt. Diese Methode hat keine Auswirkungen, wenn der Nutzer ein Mitbearbeiter und kein Betrachter oder Kommentator ist. Außerdem wird mit dieser Methode der Zugriff von Nutzern auf die Presentation nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die Presentation für die gesamte Domain des Nutzers freigegeben wurde oder sich die Presentation in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.Presentation

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

Parameter

NameTypBeschreibung
emailAddressStringDie E-Mail-Adresse des Nutzers, der entfernt werden soll.

Rückflug

Presentation – Dieses Presentation für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

removeViewer(user)

Der angegebene Nutzer wird aus der Liste der Zuschauer und Kommentatoren für die Presentation entfernt. Diese Methode hat keine Auswirkungen, wenn der Nutzer ein Mitbearbeiter und kein Betrachter ist. Außerdem wird mit dieser Methode der Zugriff von Nutzern auf die Presentation nicht blockiert, wenn sie zu einer Gruppe von Nutzern mit allgemeinem Zugriff gehören. Das ist beispielsweise der Fall, wenn die Presentation für die gesamte Domain des Nutzers freigegeben ist oder sich die Presentation in einer geteilten Ablage befindet, auf die der Nutzer zugreifen kann.

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

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

Presentation – Dieses Presentation für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText)

Ersetzt alle Textstellen, die mit dem Suchtext übereinstimmen, durch den Ersatztext. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Parameter

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

Rückflug

Integer – die Anzahl der Wiederholungen hat sich geändert

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText, matchCase)

Ersetzt alle Textstellen, die mit dem Suchtext übereinstimmen, durch den Ersatztext.

Parameter

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

Rückflug

Integer – die Anzahl der Wiederholungen hat sich geändert

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

saveAndClose()

Speichert die aktuelle Presentation. Dadurch werden ausstehende Updates gelöscht und angewendet.

Die Methode saveAndClose() wird am Ende der Scriptausführung automatisch für jeden geöffneten Presentation aufgerufen, auch wenn die Scriptausführung mit einem Fehler beendet wurde.

Geschlossene Presentation können nicht bearbeitet werden. Verwenden Sie eine der Öffnungsmethoden unter SlidesApp, um eine bestimmte Präsentation zur Bearbeitung wieder zu öffnen.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setName(name)

Hier legen Sie den Namen oder Titel der Präsentation fest.

Parameter

NameTypBeschreibung
nameStringDer Name, der für diese Präsentation festgelegt werden soll.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations