Stay organized with collections Save and categorize content based on your preferences.
PresentationA presentation.
Methods Method Return type Brief descriptionaddEditor(emailAddress) Presentation Adds the given user to the list of editors for the Presentation. addEditor(user) Presentation Adds the given user to the list of editors for the Presentation. addEditors(emailAddresses) Presentation Adds the given array of users to the list of editors for the Presentation. addViewer(emailAddress) Presentation Adds the given user to the list of viewers for the Presentation. addViewer(user) Presentation Adds the given user to the list of viewers for the Presentation. addViewers(emailAddresses) Presentation Adds the given array of users to the list of viewers for the Presentation. appendSlide() Slide Appends a slide to the end of the presentation using the PredefinedLayout.BLANK predefined layout based on the current master. appendSlide(layout) Slide Appends a slide to the end of the presentation using the specified layout based on the current master. appendSlide(predefinedLayout) Slide Appends a slide to the end of the presentation using the specified predefined layout based on the current master. appendSlide(slide) Slide Appends a copy of the provided Slide to the end of the presentation. appendSlide(slide, linkingMode) Slide Appends a copy of the provided Slide from the source presentation to the end of the current presentation, and sets the slide link as specified by the SlideLinkingMode. getEditors() User[] Gets the list of editors for this Presentation. getId() String Gets the presentation's unique identifier. getLayouts() Layout[] Gets the layouts in the presentation. getMasters() Master[] Gets the masters in the presentation. getName() String Gets the name or title of the presentation. getNotesMaster() NotesMaster Gets the notes master of the presentation. getNotesPageHeight() Number Gets the page height of the notes master and notes pages in the presentation in points. getNotesPageWidth() Number Gets the page width of the notes master and notes pages in the presentation in points. getPageElementById(id) PageElement Returns the PageElement with the given ID, or null if none exists. getPageHeight() Number Gets the page height of the slides, layouts, and masters in the presentation in points. getPageWidth() Number Gets the page width of the slides, layouts, and masters in the presentation in points. getSelection() Selection Gets the user’s selection in the active presentation. getSlideById(id) Slide Returns the Slide with the given ID, or null if none exists. getSlides() Slide[] Gets the slides in the presentation. getUrl() String Retrieves the URL to access this presentation. getViewers() User[] Gets the list of viewers and commenters for this Presentation. insertSlide(insertionIndex) Slide Inserts a slide at the specified index in the presentation using the PredefinedLayout.BLANK predefined layout based on the current master. insertSlide(insertionIndex, layout) Slide Inserts a slide at the specified index in the presentation using the specified layout based on the current master. insertSlide(insertionIndex, predefinedLayout) Slide Inserts a slide at the specified index in the presentation using the specified predefined layout based on the current master. insertSlide(insertionIndex, slide) Slide Inserts a copy of the provided Slide at the specified index in the presentation. insertSlide(insertionIndex, slide, linkingMode) Slide Inserts a copy of the provided Slide from the source presentation into the specified index in the current presentation, and sets the slide link as specified by the SlideLinkingMode. removeEditor(emailAddress) Presentation Removes the given user from the list of editors for the Presentation. removeEditor(user) Presentation Removes the given user from the list of editors for the Presentation. removeViewer(emailAddress) Presentation Removes the given user from the list of viewers and commenters for the Presentation. removeViewer(user) Presentation Removes the given user from the list of viewers and commenters for the Presentation. replaceAllText(findText, replaceText) Integer Replaces all instances of text matching find text with replace text. replaceAllText(findText, replaceText, matchCase) Integer Replaces all instances of text matching find text with replace text. saveAndClose() void Saves the current Presentation. setName(name) void Sets the name or title of the presentation. Detailed documentation addEditor(emailAddress)
Adds the given user to the list of editors for the Presentation. If the user was already on the list of viewers, this method promotes the user out of the list of viewers.
emailAddress String The email address of the user to add. Return
Presentation — This Presentation, for chaining.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsaddEditor(user)
Adds the given user to the list of editors for the Presentation. If the user was already on the list of viewers, this method promotes the user out of the list of viewers.
user User A representation of the user to add. Return
Presentation — This Presentation, for chaining.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsaddEditors(emailAddresses)
Adds the given array of users to the list of editors for the Presentation. If any of the users were already on the list of viewers, this method promotes them out of the list of viewers.
emailAddresses String[] An array of email addresses of the users to add. Return
Presentation — This Presentation, for chaining.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsaddViewer(emailAddress)
Adds the given user to the list of viewers for the Presentation. If the user was already on the list of editors, this method has no effect.
emailAddress String The email address of the user to add. Return
Presentation — This Presentation, for chaining.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsaddViewer(user)
Adds the given user to the list of viewers for the Presentation. If the user was already on the list of editors, this method has no effect.
user User A representation of the user to add. Return
Presentation — This Presentation, for chaining.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsaddViewers(emailAddresses)
Adds the given array of users to the list of viewers for the Presentation. If any of the users were already on the list of editors, this method has no effect for them.
emailAddresses String[] An array of email addresses of the users to add. Return
Presentation — This Presentation, for chaining.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsappendSlide()
Appends a slide to the end of the presentation using the PredefinedLayout.BLANK predefined layout based on the current master. The current master is one of the following:
Slide — The new slide that is appended.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsappendSlide(layout)
Appends a slide to the end of the presentation using the specified layout based on the current master. The current master is one of the following:
layout Layout The layout to use for the new slide; it should be present in the current master. Return
Slide — The new slide that is appended.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsappendSlide(predefinedLayout)
Appends a slide to the end of the presentation using the specified predefined layout based on the current master. The current master is one of the following:
predefinedLayout PredefinedLayout The predefined layout to use for the new slide; it should be present in the current master. Return
Slide — The new slide that is appended.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsappendSlide(slide)
Appends a copy of the provided Slide to the end of the presentation.
If the slide being copied is from a different presentation, the parent master and layout pages are copied as well if they do not already exist in this presentation.
// 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); Parameters Name Type Description slide Slide The slide to be copied and appended. Return
Slide — The new slide that is appended.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsappendSlide(slide, linkingMode)
Appends a copy of the provided Slide from the source presentation to the end of the current presentation, and sets the slide link as specified by the SlideLinkingMode.
If the slide being copied is from a different presentation, the parent master and layout pages are copied as well if they do not already exist in the current presentation.
If the link mode is SlideLinkingMode.LINKED, the appended slide can be updated to match the provided source slide when Slide.refreshSlide() is called. Other collaborators can see the link to the source slide. SlideLinkingMode.LINKED cannot be used with source slides from the current presentation.
// 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,
); Parameters Name Type Description slide Slide The slide to be copied, appended, and linked. linkingMode SlideLinkingMode The link mode to use. Return
Slide — The new slide.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetEditors()
Gets the list of editors for this Presentation.
User[] — An array of users with edit permission.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetId()
Gets the presentation's unique identifier. The presentation ID is used with SlidesApp.openById() to open a specific presentation instance.
String — The ID of this presentation.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetLayouts()
Gets the layouts in the presentation.
ReturnLayout[] — The list of layouts in this presentation.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetMasters()
Gets the masters in the presentation.
ReturnMaster[] — The list of masters in this presentation.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetName()
Gets the name or title of the presentation.
ReturnString — The title of this presentation.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetNotesMaster()
Gets the notes master of the presentation.
ReturnNotesMaster — The notes master of the presentation.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetNotesPageHeight()
Gets the page height of the notes master and notes pages in the presentation in points. They all have the same page height.
ReturnNumber — The notes page height in points.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetNotesPageWidth()
Gets the page width of the notes master and notes pages in the presentation in points. They all have the same page width.
ReturnNumber — The notes page width in points.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetPageElementById(id)
Returns the PageElement with the given ID, or null if none exists.
id String The ID of the page element that is being retrieved. Return
PageElement — The page element with the given ID.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetPageHeight()
Gets the page height of the slides, layouts, and masters in the presentation in points. They all have the same page height.
ReturnNumber — The page height in points.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetPageWidth()
Gets the page width of the slides, layouts, and masters in the presentation in points. They all have the same page width.
ReturnNumber — The page width in points.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetSelection()
Gets the user’s selection in the active presentation. A script can only access the selection of the user who is running the script, and only if the script is bound to the presentation.
Note that the selection returned is the current effective selection. As the script performs various changes to the presentation, the selection is transformed to take them into account. For example if two shapes A and B are selected, and then the script removes shape B, the returned selection object is implicitly updated such that only shape A is selected.
// Gets the current active page that is selected in the active presentation. const selection = SlidesApp.getActivePresentation().getSelection(); const currentPage = selection.getCurrentPage();Return
Selection — A representation of the user's selection, or null if the script is not bound to the presentation or if there is no valid user selection.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetSlideById(id)
Returns the Slide with the given ID, or null if none exists.
id String The ID of the slide that is being retrieved. Return
Slide — The slide with the given ID.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetSlides()
Gets the slides in the presentation.
ReturnSlide[] — The list of slides in this presentation.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetUrl()
Retrieves the URL to access this presentation.
const presentation = SlidesApp.getActivePresentation();
// Send out the link to open the presentation.
MailApp.sendEmail(
'<email-address>',
presentation.getName(),
presentation.getUrl(),
); Return
String — The URL to access the current presentation.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetViewers()
Gets the list of viewers and commenters for this Presentation.
User[] — An array of users with view or comment permission.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertSlide(insertionIndex)
Inserts a slide at the specified index in the presentation using the PredefinedLayout.BLANK predefined layout based on the current master. The current master is one of the following:
insertionIndex Integer The zero-based index indicating where to insert the slide. Return
Slide — The new slide that is inserted.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertSlide(insertionIndex, layout)
Inserts a slide at the specified index in the presentation using the specified layout based on the current master. The current master is one of the following:
insertionIndex Integer The zero-based index indicating where to insert the slide. layout Layout The layout to use for the new slide; it should be present in the current master. Return
Slide — The new slide that is inserted.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertSlide(insertionIndex, predefinedLayout)
Inserts a slide at the specified index in the presentation using the specified predefined layout based on the current master. The current master is one of the following:
insertionIndex Integer The zero-based index indicating where to insert the slide. predefinedLayout PredefinedLayout The predefined layout to use for the new slide; it should be present in the current master. Return
Slide — The new slide that is inserted.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertSlide(insertionIndex, slide)
Inserts a copy of the provided Slide at the specified index in the presentation.
If the slide being copied is from a different presentation, the parent master and layout pages are copied as well if they do not already exist in this presentation.
// 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); Parameters Name Type Description insertionIndex Integer The zero-based index indicating where to insert the slide. slide Slide The slide to be copied and inserted. Return
Slide — The new slide that is inserted.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertSlide(insertionIndex, slide, linkingMode)
Inserts a copy of the provided Slide from the source presentation into the specified index in the current presentation, and sets the slide link as specified by the SlideLinkingMode.
If the slide being copied is from a different presentation, the parent master and layout pages are copied as well if they do not already exist in the current presentation.
If the link mode is SlideLinkingMode.LINKED, the inserted slide can be updated to match the provided source slide when Slide.refreshSlide() is called. Other collaborators can see the link to the source slide. SlideLinkingMode.LINKED cannot be used with source slides from the current presentation.
// 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,
); Parameters Name Type Description insertionIndex Integer The zero-based index indicating where to insert the slide. slide Slide The slide to be copied and inserted. linkingMode SlideLinkingMode The link mode to use. Return
Slide — The new slide.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsremoveEditor(emailAddress)
Removes the given user from the list of editors for the Presentation. This method doesn't block users from accessing the Presentation if they belong to a class of users who have general access—for example, if the Presentation is shared with the user's entire domain, or if the Presentation is in a shared drive that the user can access.
For Drive files, this also removes the user from the list of viewers.
Parameters Name Type DescriptionemailAddress String The email address of the user to remove. Return
Presentation — This Presentation, for chaining.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsremoveEditor(user)
Removes the given user from the list of editors for the Presentation. This method doesn't block users from accessing the Presentation if they belong to a class of users who have general access—for example, if the Presentation is shared with the user's entire domain, or if the Presentation is in a shared drive that the user can access.
For Drive files, this also removes the user from the list of viewers.
Parameters Name Type Descriptionuser User A representation of the user to remove. Return
Presentation — This Presentation, for chaining.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsremoveViewer(emailAddress)
Removes the given user from the list of viewers and commenters for the Presentation. This method has no effect if the user is an editor, not a viewer or commenter. This method also doesn't block users from accessing the Presentation if they belong to a class of users who have general access—for example, if the Presentation is shared with the user's entire domain, or if the Presentation is in a shared drive that the user can access.
For Drive files, this also removes the user from the list of editors.
Parameters Name Type DescriptionemailAddress String The email address of the user to remove. Return
Presentation — This Presentation for chaining.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsremoveViewer(user)
Removes the given user from the list of viewers and commenters for the Presentation. This method has no effect if the user is an editor, not a viewer. This method also doesn't block users from accessing the Presentation if they belong to a class of users who have general access—for example, if the Presentation is shared with the user's entire domain, or if the Presentation is in a shared drive that the user can access.
For Drive files, this also removes the user from the list of editors.
Parameters Name Type Descriptionuser User A representation of the user to remove. Return
Presentation — This Presentation for chaining.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsreplaceAllText(findText, replaceText)
Replaces all instances of text matching find text with replace text. The search is case insensitive.
Parameters Name Type DescriptionfindText String The text to find. replaceText String The text to replace the matched text. Return
Integer — the number of occurrences changed
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsreplaceAllText(findText, replaceText, matchCase)
Replaces all instances of text matching find text with replace text.
Parameters Name Type DescriptionfindText String The text to find. replaceText String The text to replace the matched text. matchCase Boolean If true, the search is case sensitive; if false, the search is case insensitive. Return
Integer — the number of occurrences changed
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationssaveAndClose()
Saves the current Presentation. Causes pending updates to be flushed and applied.
The saveAndClose() method is automatically invoked at the end of script execution for each open Presentation, even if the script execution terminated with an error.
A closed Presentation cannot be edited. Use one of the open methods on SlidesApp to reopen a given presentation for editing.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationssetName(name)
Sets the name or title of the presentation.
Parameters Name Type Descriptionname String The name to set for this presentation. Authorization
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsExcept as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-02 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-12-02 UTC."],[[["The `Presentation` class in Google Apps Script provides methods for manipulating Google Slides presentations, such as adding, removing and getting slides, layouts, and masters."],["You can manage editors and viewers of the presentation, granting and revoking access as needed using specific methods."],["Various methods are available for retrieving presentation properties like ID, name, URL, and page dimensions."],["The `Presentation` class allows for text replacement and saving changes within the Google Slides presentation."],["Authorization is required to utilize most of the methods, typically needing `https://www.googleapis.com/auth/presentations.currentonly` or `https://www.googleapis.com/auth/presentations` scopes."]]],["This content outlines methods for managing presentations, slides, and user access. Key actions include adding/removing editors and viewers by email or user object, and adding/inserting slides with various layouts or copies of existing slides. Slides can be linked to source presentations. Methods also exist for retrieving presentation data like IDs, names, layouts, and user lists, and for replacing text within the presentation. Other key functions allow for setting the presentation name and saving/closing.\n"]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4