Class NotesPage

NotesPage

Uma página de observações em uma apresentação.

Essas páginas contêm o conteúdo dos materiais impressos da apresentação, incluindo uma forma com as anotações do apresentador do slide. Cada slide tem uma página de observações correspondente. Só é possível modificar o texto na forma das anotações do apresentador.

Métodos

Método	Tipo de retorno	Breve descrição
getGroups()	Group[]	Retorna a lista de objetos Group na página.
getImages()	Image[]	Retorna a lista de objetos Image na página.
getLines()	Line[]	Retorna a lista de objetos Line na página.
getObjectId()	String	Recebe o ID exclusivo da página.
getPageElementById(id)	PageElement|null	Retorna o PageElement na página com o ID especificado ou null se não houver nenhum.
getPageElements()	PageElement[]	Retorna a lista de objetos PageElement renderizados na página.
getPlaceholder(placeholderType)	PageElement|null	Retorna o objeto marcador de posição PageElement para um PlaceholderType especificado ou null se não houver um marcador de posição correspondente.
getPlaceholder(placeholderType, placeholderIndex)	PageElement|null	Retorna o objeto marcador de posição PageElement para um PlaceholderType especificado e um índice de marcador de posição ou null se o marcador de posição não estiver presente.
getPlaceholders()	PageElement[]	Retorna a lista de objetos PageElement de marcador de posição na página.
getShapes()	Shape[]	Retorna a lista de objetos Shape na página.
getSheetsCharts()	SheetsChart[]	Retorna a lista de objetos SheetsChart na página.
getSpeakerNotesShape()	Shape	Recebe a forma que contém as anotações do apresentador na página.
getTables()	Table[]	Retorna a lista de objetos Table na página.
getVideos()	Video[]	Retorna a lista de objetos Video na página.
getWordArts()	WordArt[]	Retorna a lista de objetos WordArt na página.
replaceAllText(findText, replaceText)	Integer	Substitui todas as instâncias do texto correspondente ao texto de pesquisa pelo texto de substituição.
replaceAllText(findText, replaceText, matchCase)	Integer	Substitui todas as instâncias do texto correspondente ao texto de pesquisa pelo texto de substituição.

Documentação detalhada

getGroups()

Retorna a lista de objetos Group na página.

Retornar

Group[]

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getImages()

Retorna a lista de objetos Image na página.

Retornar

Image[]

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getLines()

Retorna a lista de objetos Line na página.

Retornar

Line[]

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getObjectId()

Recebe o ID exclusivo da página. Os IDs de objetos usados por páginas e elementos de página compartilham o mesmo namespace.

Retornar

String

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getPageElementById(id)

Retorna o PageElement na página com o ID especificado ou null se não houver nenhum.

Parâmetros

Nome	Tipo	Descrição
id	String	O ID do elemento de página que está sendo recuperado.

Retornar

PageElement|null: o elemento de página com o ID especificado.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getPageElements()

Retorna a lista de objetos PageElement renderizados na página.

Retornar

PageElement[]

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getPlaceholder(placeholderType)

Retorna o objeto marcador de posição PageElement para um PlaceholderType especificado ou null se não houver um marcador de posição correspondente.

Se houver vários marcadores de posição do mesmo tipo, ele vai retornar aquele com o menor índice. Se houver vários marcadores de posição correspondentes com o mesmo índice, ele vai retornar o primeiro marcador de posição da coleção de elementos da página.

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

Parâmetros

Nome	Tipo	Descrição
placeholderType	PlaceholderType	O tipo de marcador a ser correspondido.

Retornar

PageElement|null: o elemento de página de marcador de posição ou null se nenhum for encontrado.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getPlaceholder(placeholderType, placeholderIndex)

Retorna o objeto marcador de posição PageElement para um PlaceholderType especificado e um índice de marcador de posição ou null se o marcador de posição não estiver presente.

Se houver vários marcadores de posição com o mesmo tipo e índice, ele vai retornar o primeiro marcador de posição da coleção de elementos da página.

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

Parâmetros

Nome	Tipo	Descrição
placeholderType	PlaceholderType	O tipo de marcador a ser correspondido.
placeholderIndex	Integer	O índice do marcador de posição a ser correspondido.

Retornar

PageElement|null: o elemento de página de marcador de posição ou null se nenhum for encontrado.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getPlaceholders()

Retorna a lista de objetos PageElement de marcador de posição na página.

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

Retornar

PageElement[]

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getShapes()

Retorna a lista de objetos Shape na página.

Retornar

Shape[]

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getSheetsCharts()

Retorna a lista de objetos SheetsChart na página.

Retornar

SheetsChart[]

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getSpeakerNotesShape()

Recebe a forma que contém as anotações do apresentador na página.

Retornar

Shape

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getTables()

Retorna a lista de objetos Table na página.

Retornar

Table[]

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getVideos()

Retorna a lista de objetos Video na página.

Retornar

Video[]

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getWordArts()

Retorna a lista de objetos WordArt na página.

Retornar

WordArt[]

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

replaceAllText(findText, replaceText)

Substitui todas as instâncias do texto correspondente ao texto de pesquisa pelo texto de substituição. A pesquisa não diferencia maiúsculas de minúsculas.

Parâmetros

Nome	Tipo	Descrição
findText	String	O texto a ser encontrado.
replaceText	String	O texto que vai substituir o texto correspondente.

Retornar

Integer: o número de ocorrências mudou.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

replaceAllText(findText, replaceText, matchCase)

Substitui todas as instâncias do texto correspondente ao texto de pesquisa pelo texto de substituição.

Parâmetros

Nome	Tipo	Descrição
findText	String	O texto a ser encontrado.
replaceText	String	O texto que vai substituir o texto correspondente.
matchCase	Boolean	Se true, a pesquisa diferencia maiúsculas de minúsculas. Se false, a pesquisa não diferencia maiúsculas de minúsculas.

Retornar

Integer: o número de ocorrências mudou.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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