Class Presentation

Apresentação

Uma apresentação.

Métodos

MétodoTipo de retornoBreve descrição
addEditor(emailAddress)PresentationAdiciona o usuário especificado à lista de editores do Presentation.
addEditor(user)PresentationAdiciona o usuário especificado à lista de editores do Presentation.
addEditors(emailAddresses)PresentationAdiciona a matriz de usuários especificada à lista de editores do Presentation.
addViewer(emailAddress)PresentationAdiciona o usuário especificado à lista de leitores do Presentation.
addViewer(user)PresentationAdiciona o usuário especificado à lista de leitores do Presentation.
addViewers(emailAddresses)PresentationAdiciona a matriz de usuários especificada à lista de leitores para o Presentation.
appendSlide()SlideAnexa um slide ao final da apresentação usando o layout predefinido PredefinedLayout.BLANK com base no mestre atual.
appendSlide(layout)SlideAnexa um slide ao final da apresentação usando o layout especificado com base no mestre atual.
appendSlide(predefinedLayout)SlideAnexa um slide ao final da apresentação usando o layout predefinido especificado com base no mestre atual.
appendSlide(slide)SlideAnexa uma cópia do Slide fornecido ao final da apresentação.
appendSlide(slide, linkingMode)SlideAnexa 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()StringExtrai o identificador exclusivo da apresentação.
getLayouts()Layout[]Extrai os layouts da apresentação.
getMasters()Master[]Extrai os mestres na apresentação.
getName()StringExtrai o nome ou título da apresentação.
getNotesMaster()NotesMasterExtrai as notas mestre da apresentação.
getNotesPageHeight()NumberDefine a altura da página da nota mestre e das páginas de notas da apresentação em pontos.
getNotesPageWidth()NumberExtrai a largura da página das notas mestre e das páginas de notas da apresentação em pontos.
getPageElementById(id)PageElementRetorna o PageElement com o ID fornecido ou null se não houver nenhum.
getPageHeight()NumberDefine a altura da página dos slides, layouts e mestres da apresentação em pontos.
getPageWidth()NumberDefine a largura da página dos slides, layouts e mestres da apresentação em pontos.
getSelection()SelectionExtrai a seleção do usuário na apresentação ativa.
getSlideById(id)SlideRetorna o Slide com o ID fornecido ou null se não houver nenhum.
getSlides()Slide[]Extrai os slides da apresentação.
getUrl()StringRecupera a URL para acessar esta apresentação.
getViewers()User[]Recebe a lista de leitores e comentadores deste Presentation.
insertSlide(insertionIndex)SlideInsere um slide no índice especificado na apresentação usando o layout predefinido PredefinedLayout.BLANK com base no mestre atual.
insertSlide(insertionIndex, layout)SlideInsere um slide no índice especificado na apresentação usando o layout especificado com base no mestre atual.
insertSlide(insertionIndex, predefinedLayout)SlideInsere um slide no índice especificado na apresentação usando o layout predefinido definido com base no mestre atual.
insertSlide(insertionIndex, slide)SlideInsere uma cópia do Slide fornecido no índice especificado na apresentação.
insertSlide(insertionIndex, slide, linkingMode)SlideInsere 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)PresentationRemove o usuário especificado da lista de editores do Presentation.
removeEditor(user)PresentationRemove o usuário especificado da lista de editores do Presentation.
removeViewer(emailAddress)PresentationRemove o usuário especificado da lista de leitores e comentadores do Presentation.
removeViewer(user)PresentationRemove o usuário especificado da lista de leitores e comentadores do Presentation.
replaceAllText(findText, replaceText)IntegerSubstitui todas as instâncias do texto correspondente ao texto de substituição pelo texto de substituição.
replaceAllText(findText, replaceText, matchCase)IntegerSubstitui todas as instâncias do texto correspondente ao texto de substituição pelo texto de substituição.
saveAndClose()voidSalva o Presentation atual.
setName(name)voidDefine 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

NomeTipoDescrição
emailAddressStringO 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

NomeTipoDescrição
userUserUma 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

NomeTipoDescrição
emailAddressesString[]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

NomeTipoDescrição
emailAddressStringO 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

NomeTipoDescrição
userUserUma 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

NomeTipoDescrição
emailAddressesString[]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

NomeTipoDescrição
layoutLayoutO 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

NomeTipoDescrição
predefinedLayoutPredefinedLayoutO 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

NomeTipoDescrição
slideSlideO 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

NomeTipoDescrição
slideSlideO slide a ser copiado, anexado e vinculado.
linkingModeSlideLinkingModeO 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()

Extrai os layouts da apresentação.

Retorno

Layout[]: a lista de layouts 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

getMasters()

Extrai os mestres na apresentação.

Retorno

Master[]: a lista de mestres 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

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

NomeTipoDescrição
idStringO 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

NomeTipoDescrição
idStringO 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()

Extrai os slides da apresentação.

Retorno

Slide[]: a lista de slides 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

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

NomeTipoDescrição
insertionIndexIntegerO í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

NomeTipoDescrição
insertionIndexIntegerO índice baseado em zero que indica onde inserir o slide.
layoutLayoutO 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

NomeTipoDescrição
insertionIndexIntegerO índice baseado em zero que indica onde inserir o slide.
predefinedLayoutPredefinedLayoutO 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

NomeTipoDescrição
insertionIndexIntegerO índice baseado em zero que indica onde inserir o slide.
slideSlideO 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

NomeTipoDescrição
insertionIndexIntegerO índice baseado em zero que indica onde inserir o slide.
slideSlideO slide a ser copiado e inserido.
linkingModeSlideLinkingModeO 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

NomeTipoDescrição
emailAddressStringO 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

NomeTipoDescrição
userUserUma 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

NomeTipoDescrição
emailAddressStringO 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

NomeTipoDescrição
userUserUma 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

NomeTipoDescrição
findTextStringO texto a ser encontrado.
replaceTextStringO 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

NomeTipoDescrição
findTextStringO texto a ser encontrado.
replaceTextStringO texto para substituir o texto correspondente.
matchCaseBooleanSe 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

NomeTipoDescrição
nameStringO 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