Uma apresentação.
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
addEditor(emailAddress) | Presentation | Adiciona o usuário especificado à lista de editores do Presentation . |
addEditor(user) | Presentation | Adiciona o usuário especificado à lista de editores do Presentation . |
addEditors(emailAddresses) | Presentation | Adiciona a matriz de usuários especificada à lista de editores do Presentation . |
addViewer(emailAddress) | Presentation | Adiciona o usuário especificado à lista de leitores do Presentation . |
addViewer(user) | Presentation | Adiciona o usuário especificado à lista de leitores do Presentation . |
addViewers(emailAddresses) | Presentation | Adiciona a matriz de usuários especificada à lista de leitores para o Presentation . |
appendSlide() | Slide | Anexa um slide ao final da apresentação usando o layout predefinido PredefinedLayout.BLANK
com base no mestre atual. |
appendSlide(layout) | Slide | Anexa um slide ao final da apresentação usando o layout especificado com base no mestre atual. |
appendSlide(predefinedLayout) | Slide | Anexa um slide ao final da apresentação usando o layout predefinido especificado com base no mestre atual. |
appendSlide(slide) | Slide | Anexa uma cópia do Slide fornecido ao final da apresentação. |
appendSlide(slide, linkingMode) | Slide | Anexa uma cópia do Slide fornecido da apresentação de origem ao final da
apresentação atual e define o link do slide conforme especificado por SlideLinkingMode . |
getEditors() | User[] | Recebe a lista de editores deste Presentation . |
getId() | String | Extrai o identificador exclusivo da apresentação. |
getLayouts() | Layout[] | Extrai os layouts da apresentação. |
getMasters() | Master[] | Extrai os mestres na apresentação. |
getName() | String | Extrai o nome ou título da apresentação. |
getNotesMaster() | NotesMaster | Extrai as notas mestre da apresentação. |
getNotesPageHeight() | Number | Define a altura da página da nota mestre e das páginas de notas da apresentação em pontos. |
getNotesPageWidth() | Number | Extrai a largura da página das notas mestre e das páginas de notas da apresentação em pontos. |
getPageElementById(id) | PageElement | Retorna o PageElement com o ID fornecido ou null se não houver nenhum. |
getPageHeight() | Number | Define a altura da página dos slides, layouts e mestres da apresentação em pontos. |
getPageWidth() | Number | Define a largura da página dos slides, layouts e mestres da apresentação em pontos. |
getSelection() | Selection | Extrai a seleção do usuário na apresentação ativa. |
getSlideById(id) | Slide | Retorna o Slide com o ID fornecido ou null se não houver nenhum. |
getSlides() | Slide[] | Extrai os slides da apresentação. |
getUrl() | String | Recupera a URL para acessar esta apresentação. |
getViewers() | User[] | Recebe a lista de leitores e comentadores deste Presentation . |
insertSlide(insertionIndex) | Slide | Insere um slide no índice especificado na apresentação usando o layout predefinido PredefinedLayout.BLANK com base no mestre atual. |
insertSlide(insertionIndex, layout) | Slide | Insere um slide no índice especificado na apresentação usando o layout especificado com base no mestre atual. |
insertSlide(insertionIndex, predefinedLayout) | Slide | Insere um slide no índice especificado na apresentação usando o layout predefinido definido com base no mestre atual. |
insertSlide(insertionIndex, slide) | Slide | Insere uma cópia do Slide fornecido no índice especificado na apresentação. |
insertSlide(insertionIndex, slide, linkingMode) | Slide | Insere uma cópia do Slide fornecido da apresentação de origem no índice especificado
na apresentação atual e define o link do slide conforme especificado por SlideLinkingMode . |
removeEditor(emailAddress) | Presentation | Remove o usuário especificado da lista de editores do Presentation . |
removeEditor(user) | Presentation | Remove o usuário especificado da lista de editores do Presentation . |
removeViewer(emailAddress) | Presentation | Remove o usuário especificado da lista de leitores e comentadores do Presentation . |
removeViewer(user) | Presentation | Remove o usuário especificado da lista de leitores e comentadores do Presentation . |
replaceAllText(findText, replaceText) | Integer | Substitui todas as instâncias do texto correspondente ao texto de substituição pelo texto de substituição. |
replaceAllText(findText, replaceText, matchCase) | Integer | Substitui todas as instâncias do texto correspondente ao texto de substituição pelo texto de substituição. |
saveAndClose() | void | Salva o Presentation atual. |
setName(name) | void | Define o nome ou o título da apresentação. |
Documentação detalhada
addEditor(emailAddress)
Adiciona o usuário especificado à lista de editores do Presentation
. Se o usuário já estiver
na lista de espectadores, esse método o removerá da lista.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
emailAddress | String | O endereço de e-mail do usuário a ser adicionado. |
Retorno
Presentation
: este Presentation
, para encadeamento.
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
addEditor(user)
Adiciona o usuário especificado à lista de editores do Presentation
. Se o usuário já estiver
na lista de espectadores, esse método o removerá da lista.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
user | User | Uma representação do usuário a ser adicionado. |
Retorno
Presentation
: este Presentation
, para encadeamento.
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
addEditors(emailAddresses)
Adiciona a matriz de usuários especificada à lista de editores do Presentation
. Se algum dos
usuários já estiver na lista de espectadores, esse método o removerá da lista de
espectadores.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
emailAddresses | String[] | Uma matriz de endereços de e-mail dos usuários a serem adicionados. |
Retorno
Presentation
: este Presentation
, para encadeamento.
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
addViewer(emailAddress)
Adiciona o usuário especificado à lista de leitores do Presentation
. Se o usuário já estiver na lista de editores, esse método não terá efeito.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
emailAddress | String | O endereço de e-mail do usuário a ser adicionado. |
Retorno
Presentation
: este Presentation
, para encadeamento.
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
addViewer(user)
Adiciona o usuário especificado à lista de leitores do Presentation
. Se o usuário já estiver na lista de editores, esse método não terá efeito.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
user | User | Uma representação do usuário a ser adicionado. |
Retorno
Presentation
: este Presentation
, para encadeamento.
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
addViewers(emailAddresses)
Adiciona a matriz de usuários especificada à lista de leitores para o Presentation
. Se algum dos usuários já estiver na lista de editores, esse método não terá efeito para ele.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
emailAddresses | String[] | Uma matriz de endereços de e-mail dos usuários a serem adicionados. |
Retorno
Presentation
: este Presentation
, para encadeamento.
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
appendSlide()
Anexa um slide ao final da apresentação usando o layout predefinido PredefinedLayout.BLANK
com base no mestre atual. O mestre atual é um dos seguintes:
- O mestre do último slide atual.
- O primeiro mestre da apresentação, se não houver slide.
Retorno
Slide
: o novo slide anexado.
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
appendSlide(layout)
Anexa um slide ao final da apresentação usando o layout especificado com base no mestre atual. O mestre atual é um dos seguintes:
- O mestre do último slide atual.
- O primeiro mestre da apresentação, se não houver slide.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
layout | Layout | O layout a ser usado no novo slide; ele deve estar presente no mestre atual. |
Retorno
Slide
: o novo slide anexado.
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
appendSlide(predefinedLayout)
Anexa um slide ao final da apresentação usando o layout predefinido especificado com base no mestre atual. O mestre atual é um dos seguintes:
- O mestre do último slide atual.
- O primeiro mestre da apresentação, se não houver slide.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
predefinedLayout | PredefinedLayout | O layout predefinido a ser usado no novo slide. Ele precisa estar presente no mestre atual. |
Retorno
Slide
: o novo slide anexado.
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
appendSlide(slide)
Anexa uma cópia do Slide
fornecido ao final da apresentação.
Se o slide que está sendo copiado for de uma apresentação diferente, as páginas principais e de layout também serão copiadas se ainda não existirem na apresentação.
// Copy a slide from another presentation and appends it. var otherPresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = otherPresentation.getSlides()[0]; currentPresentation.appendSlide(slide);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
slide | Slide | O slide a ser copiado e anexado. |
Retorno
Slide
: o novo slide anexado.
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
appendSlide(slide, linkingMode)
Anexa uma cópia do Slide
fornecido da apresentação de origem ao final da
apresentação atual e define o link do slide conforme especificado por SlideLinkingMode
.
Se o slide que está sendo copiado for de uma apresentação diferente, as páginas principais e de layout também serão copiadas se ainda não existirem na apresentação atual.
Se o modo de vinculação for SlideLinkingMode.LINKED
, o slide anexado poderá ser atualizado para
corresponder ao slide de origem fornecido quando Slide.refreshSlide()
for chamado. Outros colaboradores
podem ver o link para o slide de origem. SlideLinkingMode.LINKED
não pode ser usado com slides de origem da apresentação atual.
// Copy a slide from another presentation, then append and link it. var sourcePresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = sourcePresentation.getSlides()[0]; var appendedSlide = currentPresentation.appendSlide(slide, SlidesApp.SlideLinkingMode.LINKED);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
slide | Slide | O slide a ser copiado, anexado e vinculado. |
linkingMode | SlideLinkingMode | O modo de link a ser usado. |
Retorno
Slide
— O novo slide.
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
getEditors()
Recebe a lista de editores deste Presentation
.
Retorno
User[]
: uma matriz de usuários com permissão para edição.
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
getId()
Extrai o identificador exclusivo da apresentação. O ID da apresentação é usado com SlidesApp.openById()
para abrir uma instância específica.
Retorno
String
: o ID da apresentação.
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
getLayouts()
getMasters()
getName()
Extrai o nome ou título da apresentação.
Retorno
String
— O título desta apresentação.
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
getNotesMaster()
Extrai as notas mestre da apresentação.
Retorno
NotesMaster
: as notas principais da apresentação.
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
getNotesPageHeight()
Define a altura da página da nota mestre e das páginas de notas da apresentação em pontos. Todos eles têm a mesma altura de página.
Retorno
Number
: a altura da página de notas em pontos.
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
getNotesPageWidth()
Extrai a largura da página das notas mestre e das páginas de notas da apresentação em pontos. Todos eles têm a mesma largura de página.
Retorno
Number
: a largura da página de notas em pontos.
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
com o ID fornecido 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. |
Retorno
PageElement
: o elemento de página com o ID fornecido.
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
getPageHeight()
Define a altura da página dos slides, layouts e mestres da apresentação em pontos. Todos eles têm a mesma altura de página.
Retorno
Number
: a altura da página em pontos.
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
getPageWidth()
Define a largura da página dos slides, layouts e mestres da apresentação em pontos. Todos eles têm a mesma largura de página.
Retorno
Number
: a largura da página em pontos.
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
getSelection()
Extrai a seleção do usuário na apresentação ativa. Um script só pode acessar a seleção do usuário que está executando o script e apenas se ele estiver vinculado à apresentação.
A seleção retornada é a seleção atual efetiva. À medida que o script realiza várias alterações na apresentação, a seleção é transformada para considerá-las. Por exemplo, se duas formas A e B forem selecionadas e o script remover a B, o objeto de seleção retornado será atualizado implicitamente, de modo que apenas a forma A seja selecionada.
// Gets the current active page that is selected in the active presentation. var selection = SlidesApp.getActivePresentation().getSelection(); var currentPage = selection.getCurrentPage();
Retorno
Selection
: uma representação da seleção do usuário ou null
quando o script não está vinculado à apresentação ou se não há uma seleção de usuário válida.
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
getSlideById(id)
Retorna o Slide
com o ID fornecido ou null
se não houver nenhum.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
id | String | O ID do slide que está sendo recuperado. |
Retorno
Slide
: o slide com o ID fornecido.
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
getSlides()
getUrl()
Recupera a URL para acessar esta apresentação.
var presentation = SlidesApp.getActivePresentation(); // Send out the link to open the presentation. MailApp.sendEmail("<email-address>", presentation.getName(), presentation.getUrl());
Retorno
String
: o URL de acesso à apresentação atual.
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
getViewers()
Recebe a lista de leitores e comentadores deste Presentation
.
Retorno
User[]
: uma matriz de usuários com permissão de leitura ou comentário.
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
insertSlide(insertionIndex)
Insere um slide no índice especificado na apresentação usando o layout predefinido PredefinedLayout.BLANK
com base no mestre atual. O mestre atual é
um dos seguintes:
- O mestre do slide anterior.
- O mestre do primeiro slide, se oinsertIndex for zero.
- O primeiro mestre da apresentação, se não houver slide.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
insertionIndex | Integer | O índice baseado em zero que indica onde inserir o slide. |
Retorno
Slide
: o novo slide que é inserido.
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
insertSlide(insertionIndex, layout)
Insere um slide no índice especificado na apresentação usando o layout especificado com base no mestre atual. O mestre atual é um dos seguintes:
- O mestre do slide anterior.
- O mestre do primeiro slide, se oinsertIndex for zero.
- O primeiro mestre da apresentação, se não houver slide.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
insertionIndex | Integer | O índice baseado em zero que indica onde inserir o slide. |
layout | Layout | O layout a ser usado no novo slide; ele deve estar presente no mestre atual. |
Retorno
Slide
: o novo slide que é inserido.
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
insertSlide(insertionIndex, predefinedLayout)
Insere um slide no índice especificado na apresentação usando o layout predefinido definido com base no mestre atual. O mestre atual é um dos seguintes:
- O mestre do slide anterior.
- O mestre do primeiro slide, se oinsertIndex for zero.
- O primeiro mestre da apresentação, se não houver slide.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
insertionIndex | Integer | O índice baseado em zero que indica onde inserir o slide. |
predefinedLayout | PredefinedLayout | O layout predefinido a ser usado no novo slide. Ele precisa estar presente no mestre atual. |
Retorno
Slide
: o novo slide que é inserido.
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
insertSlide(insertionIndex, slide)
Insere uma cópia do Slide
fornecido no índice especificado na apresentação.
Se o slide que está sendo copiado for de uma apresentação diferente, as páginas principais e de layout também serão copiadas se ainda não existirem na apresentação.
// Copy a slide from another presentation and inserts it. var otherPresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = otherPresentation.getSlides()[0]; var insertionIndex = 1; currentPresentation.insertSlide(insertionIndex, slide);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
insertionIndex | Integer | O índice baseado em zero que indica onde inserir o slide. |
slide | Slide | O slide a ser copiado e inserido. |
Retorno
Slide
: o novo slide que é inserido.
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
insertSlide(insertionIndex, slide, linkingMode)
Insere uma cópia do Slide
fornecido da apresentação de origem no índice especificado
na apresentação atual e define o link do slide conforme especificado por SlideLinkingMode
.
Se o slide que está sendo copiado for de uma apresentação diferente, as páginas principais e de layout também serão copiadas se ainda não existirem na apresentação atual.
Se o modo de link for SlideLinkingMode.LINKED
, o slide inserido poderá ser atualizado para
corresponder ao slide de origem fornecido quando Slide.refreshSlide()
for chamado. Outros colaboradores
podem ver o link para o slide de origem. SlideLinkingMode.LINKED
não pode ser usado com slides de origem da apresentação atual.
// Copy a slide from another presentation, then insert and link it. var sourcePresentation = SlidesApp.openById('presentationId'); var currentPresentation = SlidesApp.getActivePresentation(); var slide = sourcePresentation.getSlides()[0]; var insertionIndex = 1; var insertedSlide = currentPresentation.insertSlide( insertionIndex, slide, SlidesApp.SlideLinkingMode.LINKED);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
insertionIndex | Integer | O índice baseado em zero que indica onde inserir o slide. |
slide | Slide | O slide a ser copiado e inserido. |
linkingMode | SlideLinkingMode | O modo de link a ser usado. |
Retorno
Slide
— O novo slide.
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
removeEditor(emailAddress)
Remove o usuário especificado da lista de editores do Presentation
. Esse método não impede que os usuários acessem o Presentation
se eles pertencerem a uma classe de usuários que tenham acesso geral. Por exemplo, se Presentation
for compartilhado com todo o domínio do usuário ou se o Presentation
estiver em um drive compartilhado que o usuário pode acessar.
Nos arquivos do Drive, essa ação também remove o usuário da lista de leitores.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
emailAddress | String | O endereço de e-mail do usuário a ser removido. |
Retorno
Presentation
: este Presentation
, para encadeamento.
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
removeEditor(user)
Remove o usuário especificado da lista de editores do Presentation
. Esse método não impede que os usuários acessem o Presentation
se eles pertencerem a uma classe de usuários que tenham acesso geral. Por exemplo, se Presentation
for compartilhado com todo o domínio do usuário ou se o Presentation
estiver em um drive compartilhado que o usuário pode acessar.
Nos arquivos do Drive, essa ação também remove o usuário da lista de leitores.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
user | User | Uma representação do usuário a ser removido. |
Retorno
Presentation
: este Presentation
, para encadeamento.
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
removeViewer(emailAddress)
Remove o usuário especificado da lista de leitores e comentadores do Presentation
. Esse
método não terá efeito se o usuário for um editor, não um leitor ou comentarista. Esse método também
não impede que os usuários acessem o Presentation
se eles pertencerem a uma classe de usuários com
acesso geral. Por exemplo, se Presentation
for compartilhado com todo o
domínio do usuário ou se o Presentation
estiver em um drive compartilhado que o usuário pode acessar.
Nos arquivos do Drive, essa ação também remove o usuário da lista de editores.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
emailAddress | String | O endereço de e-mail do usuário a ser removido. |
Retorno
Presentation
: esse Presentation
para encadeamento.
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
removeViewer(user)
Remove o usuário especificado da lista de leitores e comentadores do Presentation
. Esse
método não terá efeito se o usuário for um editor, não um visualizador. Esse método também não impede
que os usuários acessem o Presentation
se eles pertencerem a uma classe de usuários com acesso
geral, por exemplo, se Presentation
for compartilhado com todo o domínio do usuário ou
se o Presentation
estiver em um drive compartilhado que o usuário pode acessar.
Nos arquivos do Drive, essa ação também remove o usuário da lista de editores.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
user | User | Uma representação do usuário a ser removido. |
Retorno
Presentation
: esse Presentation
para encadeamento.
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 substituição 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 para substituir o texto correspondente. |
Retorno
Integer
: o número de ocorrências alteradas
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 substituição pelo texto de substituição.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
findText | String | O texto a ser encontrado. |
replaceText | String | O texto para substituir o texto correspondente. |
matchCase | Boolean | Se true , a pesquisa diferencia maiúsculas de minúsculas. Se false , ela não diferencia maiúsculas de minúsculas. |
Retorno
Integer
: o número de ocorrências alteradas
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
saveAndClose()
Salva o Presentation
atual. Faz com que as atualizações pendentes sejam removidas e aplicadas.
O método saveAndClose()
é invocado automaticamente no final da execução do script
para cada Presentation
aberta, mesmo que a execução do script seja encerrada com um erro.
Não é possível editar um Presentation
fechado. Use um dos métodos abertos no SlidesApp
para reabrir uma apresentação para edição.
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
setName(name)
Define o nome ou o título da apresentação.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
name | String | O nome a ser definido para esta apresentação. |
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