Class Slide

Folie

Eine Folie in einer Präsentation.

Diese Seiten enthalten die Inhalte, die Sie Ihrem Publikum präsentieren. Die meisten Folien basieren auf einem Master und einem Layout. Sie können beim Erstellen einer Folie angeben, welches Layout verwendet werden soll.

Methoden

MethodeRückgabetypKurzbeschreibung
duplicate()SlideDie Folie wird dupliziert.
getBackground()PageBackgroundDer Hintergrund der Seite.
getColorScheme()ColorSchemeRuft die ColorScheme ab, die der Seite zugeordnet ist.
getGroups()Group[]Gibt die Liste der Group-Objekte auf der Seite zurück.
getImages()Image[]Gibt die Liste der Image-Objekte auf der Seite zurück.
getLayout()LayoutDas Layout, auf dem die Folie basiert, oder null, wenn die Folie nicht auf einem Layout basiert.
getLines()Line[]Gibt die Liste der Line-Objekte auf der Seite zurück.
getNotesPage()NotesPageGibt die Notizenseite zurück, die mit der Folie verknüpft ist.
getObjectId()StringDie eindeutige ID der Seite wird abgerufen.
getPageElementById(id)PageElementGibt die PageElement auf der Seite mit der angegebenen ID zurück oder null, wenn keine vorhanden ist.
getPageElements()PageElement[]Gibt die Liste der PageElement-Objekte zurück, die auf der Seite gerendert werden.
getPageType()PageTypeRuft den Typ der Seite ab.
getPlaceholder(placeholderType)PageElementGibt das Platzhalter-PageElement-Objekt für ein bestimmtes PlaceholderType oder null zurück, wenn kein passender Platzhalter vorhanden ist.
getPlaceholder(placeholderType, placeholderIndex)PageElementGibt das Platzhalter-PageElement-Objekt für eine angegebene PlaceholderType und einen Platzhalterindex zurück oder null, wenn der Platzhalter nicht vorhanden ist.
getPlaceholders()PageElement[]Gibt die Liste der Platzhalter-PageElement-Objekte auf der Seite zurück.
getShapes()Shape[]Gibt die Liste der Shape-Objekte auf der Seite zurück.
getSheetsCharts()SheetsChart[]Gibt die Liste der SheetsChart-Objekte auf der Seite zurück.
getSlideLinkingMode()SlideLinkingModeGibt ein SlideLinkingMode zurück, das angibt, ob die Folie mit einer anderen verknüpft ist.
getSourcePresentationId()StringGibt die Presentation-ID der Quelle zurück oder null, wenn die Folie nicht verknüpft ist.
getSourceSlideObjectId()StringGibt die ID der Quellfolie zurück oder null, wenn die Folie nicht verknüpft ist.
getTables()Table[]Gibt die Liste der Table-Objekte auf der Seite zurück.
getVideos()Video[]Gibt die Liste der Video-Objekte auf der Seite zurück.
getWordArts()WordArt[]Gibt die Liste der WordArt-Objekte auf der Seite zurück.
group(pageElements)GroupHiermit werden alle angegebenen Seitenelemente gruppiert.
insertGroup(group)GroupFügt eine Kopie des bereitgestellten Group auf der Seite ein.
insertImage(blobSource)ImageEin Bild wird links oben auf der Seite mit der Standardgröße aus dem angegebenen Bild-Blob eingefügt.
insertImage(blobSource, left, top, width, height)ImageFügt ein Bild aus dem angegebenen Bild-Blob auf der Seite an der angegebenen Position und Größe ein.
insertImage(image)ImageFügt eine Kopie des bereitgestellten Image auf der Seite ein.
insertImage(imageUrl)ImageEin Bild wird oben links auf der Seite in der Standardgröße aus der angegebenen URL eingefügt.
insertImage(imageUrl, left, top, width, height)ImageEin Bild wird an der angegebenen Position und Größe von der angegebenen URL auf der Seite eingefügt.
insertLine(line)LineFügt eine Kopie des bereitgestellten Line auf der Seite ein.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineFügt eine Linie auf der Seite ein, die zwei connection sites verbindet.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)LineFügt eine Linie auf der Seite ein.
insertPageElement(pageElement)PageElementFügt eine Kopie des bereitgestellten PageElement auf der Seite ein.
insertShape(shape)ShapeFügt eine Kopie des bereitgestellten Shape auf der Seite ein.
insertShape(shapeType)ShapeHiermit wird eine Form auf der Seite eingefügt.
insertShape(shapeType, left, top, width, height)ShapeHiermit wird eine Form auf der Seite eingefügt.
insertSheetsChart(sourceChart)SheetsChartEin Google Sheets-Diagramm wird auf der Seite eingefügt.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartEin Google Tabellen-Diagramm wird an der angegebenen Position und mit der angegebenen Größe auf der Seite eingefügt.
insertSheetsChart(sheetsChart)SheetsChartFügt eine Kopie des bereitgestellten SheetsChart auf der Seite ein.
insertSheetsChartAsImage(sourceChart)ImageEin Google Tabellen-Diagramm wird als Image auf der Seite eingefügt.
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageEin Google Tabellen-Diagramm wird als Image an der angegebenen Position und Größe auf der Seite eingefügt.
insertTable(numRows, numColumns)TableHiermit wird eine Tabelle auf der Seite eingefügt.
insertTable(numRows, numColumns, left, top, width, height)TableFügt eine Tabelle mit der angegebenen Position und Größe auf der Seite ein.
insertTable(table)TableFügt eine Kopie des bereitgestellten Table auf der Seite ein.
insertTextBox(text)ShapeEin Textfeld Shape mit dem angegebenen String wird auf der Seite eingefügt.
insertTextBox(text, left, top, width, height)ShapeEin Textfeld Shape mit dem angegebenen String wird auf der Seite eingefügt.
insertVideo(videoUrl)VideoEin Video wird links oben auf der Seite in der Standardgröße eingefügt.
insertVideo(videoUrl, left, top, width, height)VideoEin Video wird an der angegebenen Position und Größe auf der Seite eingefügt.
insertVideo(video)VideoFügt eine Kopie des bereitgestellten Video auf der Seite ein.
insertWordArt(wordArt)WordArtFügt eine Kopie des bereitgestellten WordArt auf der Seite ein.
isSkipped()BooleanGibt zurück, ob die Folie im Präsentationsmodus übersprungen wird.
move(index)voidVerschieben Sie die Folie an den angegebenen Index.
refreshSlide()voidDie Folie wird aktualisiert, um alle Änderungen an der verknüpften Quellfolie widerzuspiegeln.
remove()voidDie Seite wird 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.
selectAsCurrentPage()voidWählt die Page in der aktiven Präsentation als current page selection aus und entfernt alle vorherigen Auswahlen.
setSkipped(isSkipped)voidLegt fest, ob die Folie im Präsentationsmodus übersprungen wird.
unlink()voidDie Verknüpfung der aktuellen Slide mit der Quellfolie wird aufgehoben.

Detaillierte Dokumentation

duplicate()

Die Folie wird dupliziert.

Die duplizierte Folie wird direkt nach der ursprünglichen Folie erstellt.

Rückflug

Slide – Die duplizierte 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

getBackground()

Der Hintergrund der Seite.

Rückflug

PageBackground: Der Hintergrund der Seite.

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

getColorScheme()

Ruft die ColorScheme ab, die der Seite zugeordnet ist.

Rückflug

ColorScheme: Das Farbschema der Seite.

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

getGroups()

Gibt die Liste der Group-Objekte auf der Seite zurück.

Rückflug

Group[]

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

getImages()

Gibt die Liste der Image-Objekte auf der Seite zurück.

Rückflug

Image[]

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

getLayout()

Das Layout, auf dem die Folie basiert, oder null, wenn die Folie nicht auf einem Layout basiert.

Rückflug

Layout

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

getLines()

Gibt die Liste der Line-Objekte auf der Seite zurück.

Rückflug

Line[]

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

getNotesPage()

Gibt die Notizenseite zurück, die mit der Folie verknüpft ist.

Rückflug

NotesPage

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

getObjectId()

Die eindeutige ID der Seite wird abgerufen. Die Objekt-IDs, die von Seiten und Seitenelementen verwendet werden, haben denselben Namespace.

Rückflug

String

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 auf der Seite 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

getPageElements()

Gibt die Liste der PageElement-Objekte zurück, die auf der Seite gerendert werden.

Rückflug

PageElement[]

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

getPageType()

Ruft den Typ der Seite ab.

Rückflug

PageType: Der Seitentyp.

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

getPlaceholder(placeholderType)

Gibt das Platzhalter-PageElement-Objekt für ein bestimmtes PlaceholderType oder null zurück, wenn kein passender Platzhalter vorhanden ist.

Wenn es mehrere Platzhalter mit demselben Typ gibt, wird derjenige mit dem minimalen Platzhalterindex zurückgegeben. Wenn es mehrere übereinstimmende Platzhalter mit demselben Index gibt, wird der erste Platzhalter aus der Sammlung der Seitenelemente der Seite zurückgegeben.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

Parameter

NameTypBeschreibung
placeholderTypePlaceholderType

Rückflug

PageElement

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

getPlaceholder(placeholderType, placeholderIndex)

Gibt das Platzhalter-PageElement-Objekt für eine angegebene PlaceholderType und einen Platzhalterindex zurück oder null, wenn der Platzhalter nicht vorhanden ist.

Wenn es mehrere Platzhalter mit demselben Typ und Index gibt, wird der erste Platzhalter aus der Sammlung der Seitenelemente der Seite zurückgegeben.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

Parameter

NameTypBeschreibung
placeholderTypePlaceholderType
placeholderIndexInteger

Rückflug

PageElement

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

getPlaceholders()

Gibt die Liste der Platzhalter-PageElement-Objekte auf der Seite zurück.

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

Rückflug

PageElement[]

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

getShapes()

Gibt die Liste der Shape-Objekte auf der Seite zurück.

Rückflug

Shape[]

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

getSheetsCharts()

Gibt die Liste der SheetsChart-Objekte auf der Seite zurück.

Rückflug

SheetsChart[]

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

getSlideLinkingMode()

Gibt ein SlideLinkingMode zurück, das angibt, ob die Folie mit einer anderen verknüpft ist.

Rückflug

SlideLinkingMode – Der Modus für die Folienverknüpfung.

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

getSourcePresentationId()

Gibt die Presentation-ID der Quelle zurück oder null, wenn die Folie nicht verknüpft ist.

Eine Folie hat nur dann eine Quell-Presentation-ID, wenn sie mit einer Folie in einer anderen Präsentation verknüpft ist.

Rückflug

String – Die ID der Quellpräsentation oder null.

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

getSourceSlideObjectId()

Gibt die ID der Quellfolie zurück oder null, wenn die Folie nicht verknüpft ist.

Eine Folie hat nur dann eine Quellfolien-ID, wenn sie mit einer Folie in einer anderen Präsentation verknüpft ist.

Rückflug

String – Die ID der Quellfolie oder null.

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

getTables()

Gibt die Liste der Table-Objekte auf der Seite zurück.

Rückflug

Table[]

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

getVideos()

Gibt die Liste der Video-Objekte auf der Seite zurück.

Rückflug

Video[]

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

getWordArts()

Gibt die Liste der WordArt-Objekte auf der Seite zurück.

Rückflug

WordArt[]

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

group(pageElements)

Hiermit werden alle angegebenen Seitenelemente gruppiert.

Auf derselben Seite sollten mindestens zwei Seitenelemente vorhanden sein, die sich nicht bereits in einer anderen Gruppe befinden. Einige Seitenelemente wie Videos, Tables und placeholder Shapes können nicht gruppiert werden.

Parameter

NameTypBeschreibung
pageElementsPageElement[]Die Elemente, die gruppiert werden sollen.

Rückflug

Group – die neue Gruppe.

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

insertGroup(group)

Fügt eine Kopie des bereitgestellten Group auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.

// Copy a group between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(
    group);  // Also available for Layout, Master, and Page.

Parameter

NameTypBeschreibung
groupGroupDie Gruppe, die kopiert und eingefügt werden soll.

Rückflug

Group: Eingefügte Gruppe.

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

insertImage(blobSource)

Ein Bild wird links oben auf der Seite mit der Standardgröße aus dem angegebenen Bild-Blob eingefügt.

Wenn Sie das Bild einfügen, wird es einmal aus der BlobSource abgerufen und eine Kopie wird zur Anzeige in der Präsentation gespeichert. Bilder dürfen nicht größer als 50 MB und 25 Megapixel sein. Sie müssen im PNG-, JPEG- oder GIF-Format vorliegen.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
slide.insertImage(image);

Parameter

NameTypBeschreibung
blobSourceBlobSourceDie Bilddaten.

Rückflug

Image: Das eingefügte Bild.

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

insertImage(blobSource, left, top, width, height)

Fügt ein Bild aus dem angegebenen Bild-Blob auf der Seite an der angegebenen Position und Größe ein.

Das Bild wird beim Einfügen einmal von der angegebenen BlobSource abgerufen und eine Kopie wird zur Anzeige in der Präsentation gespeichert. Bilder dürfen nicht größer als 50 MB und 25 Megapixel sein. Sie müssen im PNG-, JPEG- oder GIF-Format vorliegen.

Um das Seitenverhältnis des Bildes beizubehalten, wird es skaliert und anhand der angegebenen Größe zentriert.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 300,
  height: 100
};
slide.insertImage(image, position.left, position.top, size.width, size.height);

Parameter

NameTypBeschreibung
blobSourceBlobSourceDie Bilddaten.
leftNumberDie horizontale Position des Bildes in Punkten, gemessen von der linken oberen Ecke der Seite.
topNumberDie vertikale Position des Bildes in Punkten, gemessen von der linken oberen Ecke der Seite.
widthNumberDie Breite des Bilds in Punkten.
heightNumberDie Höhe des Bilds in Punkten.

Rückflug

Image: Das eingefügte Bild.

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

insertImage(image)

Fügt eine Kopie des bereitgestellten Image auf der Seite ein.

Die Position der eingefügten Bilder auf dieser Seite wird anhand der Position des Quellbilds auf der jeweiligen Seite bestimmt.

Wenn das bereitgestellte Bild ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Bild angewendet.

Wenn das bereitgestellte Bild ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Bild kopiert. Wenn das kopierte Platzhalterbild leer ist, wird in der Zielpräsentation nichts eingefügt.

// Copy an image between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

Parameter

NameTypBeschreibung
imageImageDas Bild, das kopiert und eingefügt werden soll.

Rückflug

Image: Das eingefügte Bild.

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

insertImage(imageUrl)

Ein Bild wird oben links auf der Seite in der Standardgröße aus der angegebenen URL eingefügt.

Wenn Sie das Bild einfügen, wird es einmal von der URL abgerufen und eine Kopie wird zur Anzeige in der Präsentation gespeichert. Bilder dürfen nicht größer als 50 MB und nicht mehr als 25 Megapixel haben. Sie müssen im PNG-, JPEG- oder GIF-Format vorliegen.

Die angegebene URL muss öffentlich zugänglich und nicht größer als 2 KB sein. Die URL selbst wird mit dem Bild gespeichert und über Image.getSourceUrl() freigegeben.

Parameter

NameTypBeschreibung
imageUrlStringDie Bild-URL.

Rückflug

Image: Das eingefügte Bild.

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

insertImage(imageUrl, left, top, width, height)

Ein Bild wird an der angegebenen Position und Größe von der angegebenen URL auf der Seite eingefügt.

Wenn Sie das Bild einfügen, wird es einmal von der URL abgerufen und eine Kopie wird zur Anzeige in der Präsentation gespeichert. Bilder dürfen nicht größer als 50 MB und nicht mehr als 25 Megapixel haben. Sie müssen im PNG-, JPEG- oder GIF-Format vorliegen.

Die angegebene URL muss öffentlich zugänglich und nicht größer als 2 KB sein. Die URL selbst wird mit dem Bild gespeichert und über Image.getSourceUrl() freigegeben.

Um das Seitenverhältnis des Bildes beizubehalten, wird es skaliert und anhand der angegebenen Größe zentriert.

Parameter

NameTypBeschreibung
imageUrlStringDie Bild-URL.
leftNumberDie horizontale Position des Bildes in Punkten, gemessen von der linken oberen Ecke der Seite.
topNumberDie vertikale Position des Bildes in Punkten, gemessen von der linken oberen Ecke der Seite.
widthNumberDie Breite des Bilds in Punkten.
heightNumberDie Höhe des Bilds in Punkten.

Rückflug

Image: Das eingefügte Bild.

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

insertLine(line)

Fügt eine Kopie des bereitgestellten Line auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.

// Copy a line between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

Parameter

NameTypBeschreibung
lineLineDie Zeile, die kopiert und eingefügt werden soll.

Rückflug

Line: Die eingefügte Zeile.

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

insertLine(lineCategory, startConnectionSite, endConnectionSite)

Fügt eine Linie auf der Seite ein, die zwei connection sites verbindet. Die beiden Verbindungsstellen müssen sich auf dieser Seite befinden.

// Insert a line in the first slide of the presentation connecting two shapes.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1],
);

Parameter

NameTypBeschreibung
lineCategoryLineCategoryDie Kategorie der einzufügenden Zeile.
startConnectionSiteConnectionSiteDie Verbindungsstelle, an der der Anfang der Linie verbunden werden soll.
endConnectionSiteConnectionSiteDie Verbindungsstelle, an der das Ende der Leitung angeschlossen werden soll.

Rückflug

Line: Die eingefügte Zeile.

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

insertLine(lineCategory, startLeft, startTop, endLeft, endTop)

Fügt eine Linie auf der Seite ein.

// Insert a line in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const endPoint = {
  left: 40,
  top: 40
};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top,
);

Parameter

NameTypBeschreibung
lineCategoryLineCategoryDie Kategorie der einzufügenden Zeile.
startLeftNumberDie horizontale Position des Startpunkts der Linie, gemessen in Punkten vom linken oberen Eckpunkt der Seite aus.
startTopNumberDie vertikale Position des Startpunkts der Linie, gemessen in Punkten von der linken oberen Ecke der Seite aus.
endLeftNumberDie horizontale Position des Endpunkts der Linie, gemessen in Punkten vom linken oberen Eckpunkt der Seite aus.
endTopNumberDie vertikale Position des Endpunkts der Linie, gemessen in Punkten vom linken oberen Seitenrand aus.

Rückflug

Line: Die eingefügte Zeile.

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

insertPageElement(pageElement)

Fügt eine Kopie des bereitgestellten PageElement auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.

// Copy a page element between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

Parameter

NameTypBeschreibung
pageElementPageElementDas Seitenelement, das kopiert und eingefügt werden soll.

Rückflug

PageElement: Das eingefügte Seitenelement.

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

insertShape(shape)

Fügt eine Kopie des bereitgestellten Shape auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.

// Copy a shape between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(
    shape);  // Also available for Layout, Master, and Page.

Parameter

NameTypBeschreibung
shapeShapeDie Form, die kopiert und eingefügt werden soll.

Rückflug

Shape – Die eingefügte Form.

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

insertShape(shapeType)

Hiermit wird eine Form auf der Seite eingefügt.

Die Form wird in der Standardgröße links oben auf der Seite eingefügt.

// Insert a shape in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

Parameter

NameTypBeschreibung
shapeTypeShapeTypeDie einzufügende Form.

Rückflug

Shape – Die eingefügte Form.

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

insertShape(shapeType, left, top, width, height)

Hiermit wird eine Form auf der Seite eingefügt.

Parameter

NameTypBeschreibung
shapeTypeShapeTypeDie einzufügende Form.
leftNumberDie horizontale Position der Form, gemessen von der linken oberen Ecke der Seite.
topNumberDie vertikale Position der Form, gemessen von der linken oberen Ecke der Seite.
widthNumberDie Breite der Form.
heightNumberDie Höhe der Form.

Rückflug

Shape – Die eingefügte Form.

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

insertSheetsChart(sourceChart)

Ein Google Sheets-Diagramm wird auf der Seite eingefügt.

Das Diagramm wird in der Standardgröße links oben auf der Seite eingefügt.

Das eingefügte Diagramm ist mit dem Google Tabellen-Quelldiagramm verknüpft und kann daher aktualisiert werden. Andere Mitbearbeiter sehen den Link zur Quelltabelle.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

Parameter

NameTypBeschreibung
sourceChartEmbeddedChartDas Diagramm in einer Tabelle, das in die Seite eingefügt werden soll.

Rückflug

SheetsChart: Das auf der Seite eingefügte Diagramm.

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

insertSheetsChart(sourceChart, left, top, width, height)

Ein Google Tabellen-Diagramm wird an der angegebenen Position und mit der angegebenen Größe auf der Seite eingefügt.

Um das Seitenverhältnis des Diagramms beizubehalten, wird es anhand der angegebenen Größe skaliert und zentriert.

Das eingefügte Diagramm ist mit dem Google Tabellen-Quelldiagramm verknüpft und kann daher aktualisiert werden. Andere Mitbearbeiter sehen den Link zur Quelltabelle.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height,
);

Parameter

NameTypBeschreibung
sourceChartEmbeddedChartDas Diagramm in einer Tabelle, das in die Seite eingefügt werden soll.
leftNumberDie horizontale Position des Diagramms in Punkten, gemessen vom linken oberen Seitenrand.
topNumberDie vertikale Position des Diagramms in Punkten, gemessen vom linken oberen Seitenrand aus.
widthNumberDie Breite des Diagramms in Punkten.
heightNumberDie Höhe des Diagramms in Punkten.

Rückflug

SheetsChart: Das auf der Seite eingefügte Diagramm.

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

insertSheetsChart(sheetsChart)

Fügt eine Kopie des bereitgestellten SheetsChart auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.

// Copy a sheets chart between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

Parameter

NameTypBeschreibung
sheetsChartSheetsChartDas Diagramm in Google Tabellen, das kopiert und eingefügt werden soll.

Rückflug

SheetsChart: Das eingefügte Diagramm aus Google Tabellen.

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

insertSheetsChartAsImage(sourceChart)

Ein Google Tabellen-Diagramm wird als Image auf der Seite eingefügt.

Das Bild des Diagramms wird in der Standardgröße links oben auf der Seite eingefügt.

Das eingefügte Diagrammbild ist nicht mit dem Quelldiagramm in Google Tabellen verknüpft.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(
    chart);  // Also available for Layout, Master, and Page.

Parameter

NameTypBeschreibung
sourceChartEmbeddedChartDas Diagramm in einer Tabelle, das in die Seite eingefügt werden soll.

Rückflug

Image: Das eingefügte Bild des Diagramms auf der Seite.

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

insertSheetsChartAsImage(sourceChart, left, top, width, height)

Ein Google Tabellen-Diagramm wird als Image an der angegebenen Position und Größe auf der Seite eingefügt.

Um das Seitenverhältnis des Diagrammbilds beizubehalten, wird es skaliert und anhand der angegebenen Größe zentriert.

Das eingefügte Bild des Diagramms ist nicht mit dem Quelldiagramm in Google Tabellen verknüpft.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height,
);

Parameter

NameTypBeschreibung
sourceChartEmbeddedChartDas Diagramm in einer Tabelle, das in die Seite eingefügt werden soll.
leftNumberDie horizontale Position des Diagramms in Punkten, gemessen vom linken oberen Seitenrand.
topNumberDie vertikale Position des Diagramms in Punkten, gemessen vom linken oberen Seitenrand aus.
widthNumberDie Breite des Diagramms in Punkten.
heightNumberDie Höhe des Diagramms in Punkten.

Rückflug

Image: Das eingefügte Bild des Diagramms auf der Seite.

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

insertTable(numRows, numColumns)

Damit wird eine Tabelle auf der Seite eingefügt.

Die Tabelle ist mit der Standardgröße und gleichmäßig verteilten Zeilen und Spalten auf der Seite zentriert.

Parameter

NameTypBeschreibung
numRowsIntegerDie Anzahl der Zeilen in der Tabelle
numColumnsIntegerDie Anzahl der Spalten in der Tabelle.

Rückflug

Table: Die eingefügte Tabelle.

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

insertTable(numRows, numColumns, left, top, width, height)

Fügt eine Tabelle mit der angegebenen Position und Größe auf der Seite ein.

Zeilen und Spalten sind in der erstellten Tabelle gleichmäßig verteilt.

Parameter

NameTypBeschreibung
numRowsIntegerDie Anzahl der Zeilen in der Tabelle
numColumnsIntegerDie Anzahl der Spalten in der Tabelle.
leftNumberDie horizontale Position der Tabelle, gemessen vom linken oberen Seitenrand.
topNumberDie vertikale Position der Tabelle, gemessen von der linken oberen Ecke der Seite.
widthNumberDie Breite der Tabelle.
heightNumberDie minimale Höhe der Tabelle. Die tatsächliche Höhe der gerenderten Tabelle hängt von Faktoren wie der Textschriftart ab.

Rückflug

Table: Die eingefügte Tabelle.

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

insertTable(table)

Fügt eine Kopie des bereitgestellten Table auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.

// Copy a table between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(
    table);  // Also available for Layout, Master, and Page.

Parameter

NameTypBeschreibung
tableTableDie Tabelle, die kopiert und eingefügt werden soll.

Rückflug

Table: Die eingefügte Tabelle.

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

insertTextBox(text)

Ein Textfeld Shape mit dem angegebenen String wird auf der Seite eingefügt.

Die Textfeldform wird in der Standardgröße oben links auf der Seite eingefügt.

// Insert text box with "Hello" on the first slide of presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello');  // Also available for Layout, Master, and Page.

Parameter

NameTypBeschreibung
textStringDer String, den die Textfeldform enthalten soll.

Rückflug

Shape: Die Form des eingefügten Textfelds.

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

insertTextBox(text, left, top, width, height)

Ein Textfeld Shape mit dem angegebenen String wird auf der Seite eingefügt.

// Insert text box with "Hello" on the first slide of presentation. This text
// box is a square with a length of 10 points on each side.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox(
    'Hello', 0, 0, 10, 10);  // Also available for Layout, Master, and Page.

Parameter

NameTypBeschreibung
textStringDer String, den die Textfeldform enthalten soll.
leftNumberDie horizontale Position des Textfelds, gemessen von der linken oberen Ecke der Seite.
topNumberDie vertikale Position des Textfelds, gemessen von der linken oberen Ecke der Seite.
widthNumberDie Breite des Textfelds.
heightNumberDie Höhe des Textfelds.

Rückflug

Shape: Die Form des eingefügten Textfelds.

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

insertVideo(videoUrl)

Ein Video wird links oben auf der Seite in der Standardgröße eingefügt.

Derzeit werden nur YouTube-Videos unterstützt.

Parameter

NameTypBeschreibung
videoUrlStringDie URL des einzufügenden Videos.

Rückflug

Video – das eingefügte Video

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

insertVideo(videoUrl, left, top, width, height)

Ein Video wird an der angegebenen Position und Größe auf der Seite eingefügt.

Derzeit werden nur YouTube-Videos unterstützt.

Parameter

NameTypBeschreibung
videoUrlStringDie URL des einzufügenden Videos.
leftNumberDie horizontale Position des Videos in Pixeln, gemessen von der linken oberen Ecke der Seite.
topNumberDie vertikale Position des Videos in Punkten, gemessen von der linken oberen Ecke der Seite.
widthNumberDie Breite des Videos in Punkten.
heightNumberDie Höhe des Videos in Punkten.

Rückflug

Video – das eingefügte Video

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

insertVideo(video)

Fügt eine Kopie des bereitgestellten Video auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.

// Copy a video between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(
    video);  // Also available for Layout, Master, and Page.

Parameter

NameTypBeschreibung
videoVideoDas Video, das kopiert und eingefügt werden soll.

Rückflug

Video – das eingefügte Video

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

insertWordArt(wordArt)

Fügt eine Kopie des bereitgestellten WordArt auf der Seite ein.

Die Position des eingefügten Elements auf dieser Seite wird anhand der Position des Quellelements auf der jeweiligen Seite bestimmt.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus der aktuellen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, auch auf das eingefügte Element angewendet.

Wenn das bereitgestellte Element ein Platzhalter ist, der aus einer anderen Präsentation kopiert wird, werden Eigenschaften, die von Master- oder Layoutseiten übernommen werden, aus der Quellpräsentation in das Element kopiert.

// Copy a word art between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

Parameter

NameTypBeschreibung
wordArtWordArtDie Gruppe, die kopiert und eingefügt werden soll.

Rückflug

WordArt: Das eingefügte WordArt-Objekt.

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

isSkipped()

Gibt zurück, ob die Folie im Präsentationsmodus übersprungen wird.

Rückflug

Boolean – True, wenn die Folie im Präsentationsmodus übersprungen 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

move(index)

Verschieben Sie die Folie an den angegebenen Index.

Parameter

NameTypBeschreibung
indexIntegerDer Index, zu dem die Folie verschoben werden soll, basierend auf der Folienanordnung vor dem Verschieben. Der Index muss zwischen null und der Anzahl der Folien in der Präsentation liegen.

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

refreshSlide()

Die Folie wird aktualisiert, um alle Änderungen an der verknüpften Quellfolie widerzuspiegeln. Wenn diese Folie nicht verknüpft ist, wird sie ohne Änderungen zurückgegeben.

Mit der Methode refreshSlide werden die entsprechenden Master- und Layoutseiten der verknüpften Quellfolie in die Präsentation der Folie kopiert, sofern sie noch nicht vorhanden sind. Wenn sie bereits vorhanden sind, werden sie ebenfalls aktualisiert, um Änderungen an der Quelle widerzuspiegeln.

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const linkedSlide = currentPresentation.append(
    sourceSlide,
    SlidesApp.SlideLinkingMode.LINKED,
);

sourceSlide.insertText(
    'hello world');  // Only the source slide has the text box.

linkedSlide.refreshSlide();  // The linked slide now has the text box.

Löst

Error – Wenn der Lesezugriff auf die Quellpräsentation nicht mehr verfügbar ist.

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

remove()

Die Seite wird entfernt.

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

selectAsCurrentPage()

Wählt die Page in der aktiven Präsentation als current page selection aus und entfernt alle vorherigen Auswahlen.

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.

// Select the first slide as the current page selection and replace any previous
// selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage();  // Also available for Layout, Master, and Page.

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

setSkipped(isSkipped)

Legt fest, ob die Folie im Präsentationsmodus übersprungen wird.

Parameter

NameTypBeschreibung
isSkippedBooleanTrue, um die Folie im Präsentationsmodus zu überspringen.

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

Die Verknüpfung der aktuellen Slide mit der Quellfolie wird aufgehoben. Wenn diese Folie nicht verknüpft ist, wird ohne Änderungen zurückgekehrt.

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const linkedSlide = currentPresentation.append(
    sourceSlide,
    SlidesApp.SlideLinkingMode.LINKED,
);

linkedSlide.unlink();

linkedSlide.getSourcePresentationId();  // returns null
linkedSlide.getSourceSlideObjectId();   // returns null
linkedSlide
    .getSlideLinkingMode();  // returns SlidesApp.SlideLinkingMode.NOT_LINKED

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