Class NotesMaster

    • 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.
    NotesMaster

    A notes master in a presentation.

    Notes masters define the default text styles and page elements for all notes pages. Notes masters are read-only.

    Methods

    Method Return type Brief description
    get Groups()
    		Group[] Returns the list of Group objects on the page.
    get Images()
    		Image[] Returns the list of Image objects on the page.
    get Lines()
    		Line[] Returns the list of Line objects on the page.
    get Object Id()
    		String Gets the unique ID for the page.
    get Page Element By Id(id)
    		Page Element |null Returns the Page Element on the page with the given ID, or null if none exists.
    get Page Elements()
    		Page Element[] Returns the list of Page Element objects rendered on the page.
    get Placeholder(placeholderType)
    		Page Element |null Returns the placeholder Page Element object for a specified Placeholder Type or null if a matching placeholder is not present.
    get Placeholder(placeholderType, placeholderIndex)
    		Page Element |null Returns the placeholder Page Element object for a specified Placeholder Type and a placeholder index, or null if the placeholder is not present.
    get Placeholders()
    		Page Element[] Returns the list of placeholder Page Element objects in the page.
    get Shapes()
    		Shape[] Returns the list of Shape objects on the page.
    get Sheets Charts()
    		Sheets Chart[] Returns the list of Sheets Chart objects on the page.
    get Tables()
    		Table[] Returns the list of Table objects on the page.
    get Videos()
    		Video[] Returns the list of Video objects on the page.
    get Word Arts()
    		Word Art[] Returns the list of Word Art objects on the page.

    Detailed documentation

    getGroups()

    Returns the list of Group objects on the page.

    Return

    Group[]

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getImages()

    Returns the list of Image objects on the page.

    Return

    Image[]

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getLines()

    Returns the list of Line objects on the page.

    Return

    Line[]

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getObjectId()

    Gets the unique ID for the page. Object IDs used by pages and page elements share the same namespace.

    Return

    String

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getPageElementById(id)

    Returns the PageElement on the page with the given ID, or null if none exists.

    Parameters

    Name Type Description
    id
    		String The ID of the page element that is being retrieved.

    Return

    PageElement |null — The page element with the given ID.

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getPageElements()

    Returns the list of PageElement objects rendered on the page.

    Return

    PageElement[]

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getPlaceholder(placeholderType)

    Returns the placeholder PageElement object for a specified PlaceholderType or null if a matching placeholder is not present.

    If there are multiple placeholders with the same type, it returns the one with minimal placeholder index. If there are multiple matching placeholders with the same index, it returns the first placeholder from the page's page elements collection.

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

    Parameters

    Name Type Description
    placeholder Type
    		Placeholder Type The placeholder type to match.

    Return

    PageElement |null — The placeholder page element, or null if none is found.

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getPlaceholder(placeholderType, placeholderIndex)

    Returns the placeholder PageElement object for a specified PlaceholderType and a placeholder index, or null if the placeholder is not present.

    If there are multiple placeholders with the same type and index, it returns the first placeholder from the page's page elements collection.

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

    Parameters

    Name Type Description
    placeholder Type
    		Placeholder Type The placeholder type to match.
    placeholder Index
    		Integer The placeholder index to match.

    Return

    PageElement |null — The placeholder page element, or null if none is found.

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getPlaceholders()

    Returns the list of placeholder PageElement objects in the page.

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

    Return

    PageElement[]

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getShapes()

    Returns the list of Shape objects on the page.

    Return

    Shape[]

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getSheetsCharts()

    Returns the list of SheetsChart objects on the page.

    Return

    SheetsChart[]

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getTables()

    Returns the list of Table objects on the page.

    Return

    Table[]

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getVideos()

    Returns the list of Video objects on the page.

    Return

    Video[]

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

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

    getWordArts()

    Returns the list of WordArt objects on the page.

    Return

    WordArt[]

    Authorization

    Scripts that use this method require authorization with one or more of the following scopes :

    • https://www.googleapis.com/auth/presentations.currentonly
    • https://www.googleapis.com/auth/presentations
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: