Class NotesMaster
Page Summary
Notes masters define default text styles and page elements for notes pages and are read-only.
Various methods allow retrieval of different types of page elements such as groups, images, lines, shapes, tables, videos, word arts, and charts.
You can get a unique ID for the notes master page or retrieve specific page elements by their ID or as placeholders.
Scripts using these methods generally require authorization with specific scopes related to presentations.
A notes master in a presentation.
Notes masters define the default text styles and page elements for all notes pages. Notesmasters are read-only.
Methods
| Method | Return type | Brief description |
|---|---|---|
get | Group[] | Returns the list ofGroup objects on the page. |
get | Image[] | Returns the list ofImage objects on the page. |
get | Line[] | Returns the list ofLine objects on the page. |
get | String | Gets the unique ID for the page. |
get | Page | Returns thePage on the page with the given ID, ornull if none exists. |
get | Page | Returns the list ofPage objects rendered on the page. |
get | Page | Returns the placeholderPage object for a specifiedPlaceholder ornull if a matching placeholder is not present. |
get | Page | Returns the placeholderPage object for a specifiedPlaceholder anda placeholder index, ornull if the placeholder is not present. |
get | Page | Returns the list of placeholderPage objects in the page. |
get | Shape[] | Returns the list ofShape objects on the page. |
get | Sheets | Returns the list ofSheets objects on the page. |
get | Table[] | Returns the list ofTable objects on the page. |
get | Video[] | Returns the list ofVideo objects on the page. |
get | Word | Returns the list ofWord objects on the page. |
Detailed documentation
getGroups()
getImages()
getLines()
getObjectId()
Gets the unique ID for the page. Object IDs used by pages and page elements share the samenamespace.
Return
String
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getPageElementById(id)
Returns thePage on the page with the given ID, ornull if none exists.
Parameters
| Name | Type | Description |
|---|---|---|
id | String | The ID of the page element that is being retrieved. |
Return
Page — The page element with the given ID.
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getPageElements()
Returns the list ofPage objects rendered on the page.
Return
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType)
Returns the placeholderPage object for a specifiedPlaceholder ornull if a matching placeholder is not present.
If there are multiple placeholders with the same type, it returns the one with minimalplaceholder index. If there are multiple matching placeholders with the same index, it returnsthe first placeholder from the page's page elements collection.
constslide=SlidesApp.getActivePresentation().getSlides()[0];constplaceholder=slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE,);
Parameters
| Name | Type | Description |
|---|---|---|
placeholder | Placeholder |
Return
Page
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType, placeholderIndex)
Returns the placeholderPage object for a specifiedPlaceholder anda placeholder index, ornull if the placeholder is not present.
If there are multiple placeholders with the same type and index, it returns the firstplaceholder from the page's page elements collection.
constslide=SlidesApp.getActivePresentation().getSlides()[0];constplaceholder=slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE,0,);
Parameters
| Name | Type | Description |
|---|---|---|
placeholder | Placeholder | |
placeholder | Integer |
Return
Page
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getPlaceholders()
Returns the list of placeholderPage objects in the page.
constmaster=SlidesApp.getActivePresentation().getMasters()[0];Logger.log(`Number of placeholders in the master:${master.getPlaceholders().length}`,);
Return
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getShapes()
getSheetsCharts()
Returns the list ofSheets objects on the page.
Return
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getTables()
getVideos()
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-11 UTC.