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 Nutzer-Array der Liste der Bearbeiter für Presentation hinzu.
addViewer(emailAddress)PresentationFügt den angegebenen Nutzer der Liste der Zuschauer für Presentation hinzu.
addViewer(user)PresentationFügt den angegebenen Nutzer der Liste der Zuschauer für Presentation hinzu.
addViewers(emailAddresses)PresentationFügt das angegebene Nutzer-Array der Liste der Betrachter für Presentation hinzu.
appendSlide()SlideHängt eine Folie an das Ende der Präsentation an. Dabei wird das vordefinierte Layout PredefinedLayout.BLANK basierend auf dem aktuellen Master verwendet.
appendSlide(layout)SlideFügt eine Folie mit dem angegebenen Layout basierend auf dem aktuellen Master am Ende der Präsentation an.
appendSlide(predefinedLayout)SlideFügt der Präsentation eine Folie mit dem angegebenen vordefinierten Layout basierend auf dem aktuellen Master hinzu.
appendSlide(slide)SlideFügt eine Kopie des angegebenen Slide an das Ende der Präsentation an.
appendSlide(slide, linkingMode)SlideHängt eine Kopie der angegebenen Slide aus der Quellpräsentation an das Ende der aktuellen Präsentation an und legt den Folienlink gemäß der SlideLinkingMode fest.
getEditors()User[]Ruft die Liste der Mitbearbeiter für diese Presentation ab.
getId()StringRuft die eindeutige Kennung 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 die Notizen-Masterfolie der Präsentation ab.
getNotesPageHeight()NumberRuft die Seitenhöhe des Notizenmasters 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)PageElement|nullGibt die PageElement mit der angegebenen ID oder null zurück, wenn keine vorhanden ist.
getPageHeight()NumberGibt die Seitenhöhe der Folien, Layouts und Master in der Präsentation in Punkten zurück.
getPageWidth()NumberRuft die Seitenbreite der Folien, Layouts und Master in der Präsentation in Punkten ab.
getSelection()Selection|nullRuft die Auswahl des Nutzers in der aktiven Präsentation ab.
getSlideById(id)Slide|nullGibt die 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 diese Presentation ab.
insertSlide(insertionIndex)SlideFügt eine Folie mit dem vordefinierten Layout PredefinedLayout.BLANK basierend auf dem aktuellen Master an der angegebenen Position in die Präsentation ein.
insertSlide(insertionIndex, layout)SlideFügt eine Folie mit dem angegebenen Layout basierend auf dem aktuellen Master an der angegebenen Position in die Präsentation ein.
insertSlide(insertionIndex, predefinedLayout)SlideFügt eine Folie mit dem angegebenen Index in die Präsentation ein. Dabei wird das angegebene vordefinierte Layout basierend auf der aktuellen Masterfolie verwendet.
insertSlide(insertionIndex, slide)SlideFügt eine Kopie des angegebenen Slide an der angegebenen Indexposition in die Präsentation ein.
insertSlide(insertionIndex, slide, linkingMode)SlideFügt eine Kopie der angegebenen Slide aus der Quellpräsentation an der angegebenen Indexposition in die aktuelle Präsentation ein und legt den Folienlink gemäß der Angabe in SlideLinkingMode fest.
removeEditor(emailAddress)PresentationEntfernt den angegebenen Nutzer aus der Liste der Mitbearbeiter für die Presentation.
removeEditor(user)PresentationEntfernt den angegebenen Nutzer aus der Liste der Mitbearbeiter für die Presentation.
removeViewer(emailAddress)PresentationEntfernt den angegebenen Nutzer aus der Liste der Zuschauer und Kommentatoren für die Presentation.
removeViewer(user)PresentationEntfernt den angegebenen Nutzer aus der Liste der Zuschauer und Kommentatoren für die Presentation.
replaceAllText(findText, replaceText)IntegerErsetzt alle Instanzen von Text, der mit „find_text“ übereinstimmt, durch „replace_text“.
replaceAllText(findText, replaceText, matchCase)IntegerErsetzt alle Instanzen von Text, der mit „find_text“ übereinstimmt, durch „replace_text“.
saveAndClose()voidSpeichert die aktuelle 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 Zuschauer war, 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 – Diese Presentation zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Zuschauer war, wird er durch diese Methode aus der Liste entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Rückflug

Presentation – Diese Presentation zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

addEditors(emailAddresses)

Fügt das angegebene Nutzer-Array der Liste der Bearbeiter für Presentation hinzu. Wenn einer der Nutzer bereits in der Liste der Zuschauer war, wird er durch diese Methode aus der Liste der Zuschauer entfernt.

Parameter

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

Rückflug

Presentation – Diese Presentation zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

addViewer(emailAddress)

Fügt den angegebenen Nutzer der Liste der Zuschauer für Presentation hinzu. Wenn der Nutzer bereits in der Liste der Bearbeiter enthalten war, hat diese Methode keine Auswirkungen.

Parameter

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

Rückflug

Presentation – Diese Presentation zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

addViewer(user)

Fügt den angegebenen Nutzer der Liste der Zuschauer für Presentation hinzu. Wenn der Nutzer bereits in der Liste der Bearbeiter enthalten war, hat diese Methode keine Auswirkungen.

Parameter

NameTypBeschreibung
userUserEine Darstellung des hinzuzufügenden Nutzers.

Rückflug

Presentation – Diese Presentation zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

addViewers(emailAddresses)

Fügt das angegebene Nutzer-Array der Liste der Betrachter für Presentation hinzu. Wenn einer der Nutzer bereits in der Liste der Bearbeiter enthalten 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 – Diese Presentation zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

appendSlide()

Hängt eine Folie an das Ende der Präsentation an. Dabei wird das vordefinierte Layout PredefinedLayout.BLANK basierend auf dem aktuellen Master verwendet. Der aktuelle Master ist einer der folgenden:

  • Die Masterfolie der aktuellen letzten Folie.
  • Die erste Masterfolie 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

appendSlide(layout)

Fügt eine Folie mit dem angegebenen Layout basierend auf dem aktuellen Master am Ende der Präsentation an. Der aktuelle Master ist einer der folgenden:

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

Parameter

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

appendSlide(predefinedLayout)

Fügt der Präsentation eine Folie mit dem angegebenen vordefinierten Layout basierend auf dem aktuellen Master hinzu. Der aktuelle Master ist einer der folgenden:

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

Parameter

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

appendSlide(slide)

Fügt eine Kopie des 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.
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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

appendSlide(slide, linkingMode)

Hängt eine Kopie der angegebenen Slide aus der Quellpräsentation an das Ende der aktuellen Präsentation an und legt den Folienlink gemäß der SlideLinkingMode fest.

Wenn die zu kopierende 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 verlinkt werden soll.
linkingModeSlideLinkingModeDer zu verwendende Linkmodus.

Rückflug

Slide: Die neue Folie.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getId()

Ruft die eindeutige Kennung 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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[]: Die Liste der Master in dieser Präsentation.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getNotesMaster()

Ruft die Notizen-Masterfolie der Präsentation ab.

Rückflug

NotesMaster: Die Notizen-Masterfolie der Präsentation.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getNotesPageHeight()

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

Rückflug

Number: Die Höhe der Notizenseite in Punkten.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Rückflug

Number: Die Breite der Notizenseite in Punkten.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getPageElementById(id)

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

Parameter

NameTypBeschreibung
idStringDie ID des abzurufenden Seitenelements.

Rückflug

PageElement|null: Das Seitenelement mit der angegebenen ID.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getPageHeight()

Gibt die Seitenhöhe der Folien, Layouts und Master in der Präsentation in Punkten zurück. Sie haben alle dieselbe Seitenhöhe.

Rückflug

Number: Die Seitenhöhe in Punkten.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

Rückflug

Number: Die Seitenbreite in Punkten.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 nur, wenn das Skript an die Präsentation gebunden ist.

Die zurückgegebene Auswahl ist die aktuelle effektive Auswahl. Da das Script verschiedene Änderungen an der Präsentation vornimmt, wird die Auswahl entsprechend angepasst. Wenn beispielsweise zwei Formen A und B ausgewählt sind und dann durch das Skript Form B entfernt wird, wird das zurückgegebene Auswahlobjekt implizit aktualisiert, sodass 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|null: Eine Darstellung der Auswahl des Nutzers oder null, wenn das Script nicht an die Präsentation gebunden ist oder keine gültige Auswahl des Nutzers vorliegt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getSlideById(id)

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

Parameter

NameTypBeschreibung
idStringDie ID der abzurufenden Folie.

Rückflug

Slide|null: Die Folie mit der angegebenen ID.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Berechtigungen zum Anzeigen oder Kommentieren.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 basierend auf dem aktuellen Master an der angegebenen Position in die Präsentation ein. Der aktuelle Master ist einer der folgenden:

  • Die Masterfolie der vorherigen Folie.
  • Der Master der ersten Folie, wenn „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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 an der angegebenen Position in die Präsentation ein. Der aktuelle Master ist einer der folgenden:

  • Die Masterfolie der vorherigen Folie.
  • Der Master der ersten Folie, wenn „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 muss im aktuellen Master vorhanden sein.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

insertSlide(insertionIndex, predefinedLayout)

Fügt eine Folie mit dem angegebenen Index in die Präsentation ein. Dabei wird das angegebene vordefinierte Layout basierend auf der aktuellen Masterfolie verwendet. Der aktuelle Master ist einer der folgenden:

  • Die Masterfolie der vorherigen Folie.
  • Der Master der ersten Folie, wenn „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 muss im aktuellen Master vorhanden sein.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

insertSlide(insertionIndex, slide)

Fügt eine Kopie des angegebenen Slide an der angegebenen Indexposition 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

insertSlide(insertionIndex, slide, linkingMode)

Fügt eine Kopie der angegebenen Slide aus der Quellpräsentation an der angegebenen Indexposition in die aktuelle Präsentation ein und legt den Folienlink gemäß der Angabe in SlideLinkingMode fest.

Wenn die zu kopierende 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 Link-Modus.

Rückflug

Slide: Die neue Folie.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

removeEditor(emailAddress)

Entfernt den angegebenen Nutzer aus der Liste der Mitbearbeiter für die Presentation. Mit dieser Methode wird der Zugriff von Nutzern auf die Presentation nicht blockiert, wenn sie zu einer Nutzerklasse gehören, die allgemeinen Zugriff hat. 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 dadurch auch aus der Liste der Betrachter entfernt.

Parameter

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

Rückflug

Presentation – Diese Presentation zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

removeEditor(user)

Entfernt den angegebenen Nutzer aus der Liste der Mitbearbeiter für die Presentation. Mit dieser Methode wird der Zugriff von Nutzern auf die Presentation nicht blockiert, wenn sie zu einer Nutzerklasse gehören, die allgemeinen Zugriff hat. 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 dadurch auch aus der Liste der Betrachter entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

Presentation – Diese Presentation zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

removeViewer(emailAddress)

Entfernt den angegebenen Nutzer aus der Liste der Zuschauer und Kommentatoren für die Presentation. Diese Methode hat keine Auswirkungen, wenn der Nutzer ein Bearbeiter und kein Betrachter oder Kommentator ist. Mit dieser Methode wird auch nicht verhindert, dass Nutzer auf die Presentation zugreifen, wenn sie zu einer Nutzergruppe gehören, die allgemeinen Zugriff hat. Das ist beispielsweise der Fall, wenn die Presentation für die gesamte Domain des Nutzers freigegeben ist 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 Mitbearbeiter entfernt.

Parameter

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

Rückflug

Presentation – Diese Presentation für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

removeViewer(user)

Entfernt den angegebenen Nutzer aus der Liste der Zuschauer und Kommentatoren für die Presentation. Diese Methode hat keine Auswirkungen, wenn der Nutzer ein Bearbeiter und kein Betrachter ist. Mit dieser Methode wird auch nicht verhindert, dass Nutzer auf die Presentation zugreifen, wenn sie zu einer Nutzerklasse gehören, die allgemeinen Zugriff hat. Das ist beispielsweise der Fall, wenn die Presentation für die gesamte Domain des Nutzers freigegeben ist 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 Mitbearbeiter entfernt.

Parameter

NameTypBeschreibung
userUserEine Darstellung des zu entfernenden Nutzers.

Rückflug

Presentation – Diese Presentation für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

replaceAllText(findText, replaceText)

Ersetzt alle Instanzen von Text, der mit „find_text“ übereinstimmt, durch „replace_text“. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Parameter

NameTypBeschreibung
findTextStringDer zu suchende Text.
replaceTextStringDer Text, der den übereinstimmenden Text ersetzen soll.

Rückflug

Integer: Die Anzahl der Vorkommen wurde geändert.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

replaceAllText(findText, replaceText, matchCase)

Ersetzt alle Instanzen von Text, der mit „find_text“ übereinstimmt, durch „replace_text“.

Parameter

NameTypBeschreibung
findTextStringDer zu suchende Text.
replaceTextStringDer Text, der den übereinstimmenden Text ersetzen soll.
matchCaseBooleanWenn true, wird bei der Suche zwischen Groß- und Kleinschreibung unterschieden. Wenn false, wird die Groß-/Kleinschreibung bei der Suche nicht beachtet.

Rückflug

Integer: Die Anzahl der Vorkommen wurde geändert.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

saveAndClose()

Speichert die aktuelle Presentation. Bewirkt, dass ausstehende Updates verworfen und angewendet werden.

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

Ein geschlossenes Presentation kann nicht bearbeitet werden. Verwenden Sie eine der offenen Methoden für SlidesApp, um eine bestimmte Präsentation zur Bearbeitung wieder zu öffnen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Name, der für diese Präsentation festgelegt werden soll.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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