Class Presentation

Apresentação

Uma apresentação.

Métodos

MétodoTipo de retornoBreve descrição
addEditor(emailAddress)PresentationAdiciona o usuário à lista de editores do Presentation.
addEditor(user)PresentationAdiciona o usuário à lista de editores do Presentation.
addEditors(emailAddresses)PresentationAdiciona o array de usuários à lista de editores do Presentation.
addViewer(emailAddress)PresentationAdiciona o usuário à lista de espectadores do Presentation.
addViewer(user)PresentationAdiciona o usuário à lista de espectadores do Presentation.
addViewers(emailAddresses)PresentationAdiciona a matriz de usuários à lista de espectadores do Presentation.
appendSlide()SlideAnexar um slide ao final da apresentação usando o layout PredefinedLayout.BLANK predefinido com base no modelo atual.
appendSlide(layout)SlideAdiciona um slide ao final da apresentação usando o layout especificado com base no modelo atual.
appendSlide(predefinedLayout)SlideAdiciona um slide ao final da apresentação usando o layout predefinido especificado com base no modelo atual.
appendSlide(slide)SlideAdiciona 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 pelo SlideLinkingMode.
getEditors()User[]Recebe a lista de editores para este Presentation.
getId()StringConsegue o identificador exclusivo da apresentação.
getLayouts()Layout[]Recebe os layouts na apresentação.
getMasters()Master[]Recebe os mestres na apresentação.
getName()StringRecebe o nome ou título da apresentação.
getNotesMaster()NotesMasterRecebe o mestre de notas da apresentação.
getNotesPageHeight()NumberRecebe a altura da página do modelo de anotações e das páginas de anotações na apresentação em pontos.
getNotesPageWidth()NumberRecebe a largura da página do master de anotações e das páginas de anotações na apresentação em pontos.
getPageElementById(id)PageElementRetorna o PageElement com o ID fornecido ou null se nenhum existir.
getPageHeight()NumberRecebe a altura da página dos slides, layouts e modelos na apresentação em pontos.
getPageWidth()NumberRecebe a largura da página dos slides, layouts e modelos na apresentação em pontos.
getSelection()SelectionRecebe a seleção do usuário na apresentação ativa.
getSlideById(id)SlideRetorna o Slide com o ID fornecido ou null se nenhum existir.
getSlides()Slide[]Consegue os slides da apresentação.
getUrl()StringRecupera o URL para acessar essa apresentação.
getViewers()User[]Mostra a lista de leitores e comentaristas desse Presentation.
insertSlide(insertionIndex)SlideInsere um slide no índice especificado na apresentação usando o layout predefinido PredefinedLayout.BLANK com base no modelo 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 especificado 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 pelo SlideLinkingMode.
removeEditor(emailAddress)PresentationRemove o usuário da lista de editores do Presentation.
removeEditor(user)PresentationRemove o usuário da lista de editores do Presentation.
removeViewer(emailAddress)PresentationRemove o usuário da lista de espectadores e comentaristas do Presentation.
removeViewer(user)PresentationRemove o usuário da lista de espectadores e comentaristas do Presentation.
replaceAllText(findText, replaceText)IntegerSubstitui todas as instâncias de texto correspondentes ao texto de pesquisa por texto de substituição.
replaceAllText(findText, replaceText, matchCase)IntegerSubstitui todas as instâncias de texto correspondentes ao texto de pesquisa por 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 à lista de editores do Presentation. Se o usuário já estava na lista de espectadores, esse método promove o usuário para fora da lista de espectadores.

Parâmetros

NomeTipoDescrição
emailAddressStringO endereço de e-mail do usuário a ser adicionado.

Retornar

Presentation: 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 à lista de editores do Presentation. Se o usuário já estava na lista de espectadores, esse método promove o usuário para fora da lista de espectadores.

Parâmetros

NomeTipoDescrição
userUserUma representação do usuário a ser adicionado.

Retornar

Presentation: 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 o array de usuários à lista de editores do Presentation. Se algum dos usuários já estiver na lista de espectadores, esse método vai promover a saída deles da lista de espectadores.

Parâmetros

NomeTipoDescrição
emailAddressesString[]Uma matriz de endereços de e-mail dos usuários a serem adicionados.

Retornar

Presentation: 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 à lista de espectadores 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.

Retornar

Presentation: 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 à lista de espectadores 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.

Retornar

Presentation: 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 à lista de espectadores do Presentation. Se algum dos usuários já estiver na lista de editores, esse método não terá efeito para eles.

Parâmetros

NomeTipoDescrição
emailAddressesString[]Uma matriz de endereços de e-mail dos usuários a serem adicionados.

Retornar

Presentation: 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()

Anexar um slide ao final da apresentação usando o layout PredefinedLayout.BLANK predefinido com base no modelo atual. O mestre atual é uma das seguintes opções:

  • O mestre do último slide atual.
  • O primeiro mestre na apresentação, se não houver um slide.

Retornar

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)

Adiciona um slide ao final da apresentação usando o layout especificado com base no modelo atual. O mestre atual é uma das seguintes opções:

  • O mestre do último slide atual.
  • O primeiro mestre na apresentação, se não houver um slide.

Parâmetros

NomeTipoDescrição
layoutLayoutO layout a ser usado para o novo slide. Ele precisa estar presente no modelo atual.

Retornar

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)

Adiciona um slide ao final da apresentação usando o layout predefinido especificado com base no modelo atual. O mestre atual é uma das seguintes opções:

  • O mestre do último slide atual.
  • O primeiro mestre na apresentação, se não houver um slide.

Parâmetros

NomeTipoDescrição
predefinedLayoutPredefinedLayoutO layout predefinido a ser usado para o novo slide. Ele precisa estar presente no modelo atual.

Retornar

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)

Adiciona uma cópia do Slide fornecido ao final da apresentação.

Se o slide copiado for de uma apresentação diferente, as páginas mestre e de layout pai também serão copiadas, se não existirem na apresentação. 

// Copy a slide from another presentation and appends it.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
currentPresentation.appendSlide(slide);

Parâmetros

NomeTipoDescrição
slideSlideO slide a ser copiado e anexado.

Retornar

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 pelo SlideLinkingMode.

Se o slide copiado for de uma apresentação diferente, as páginas mestre e de layout mãe também serão copiadas se 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 acessar 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.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const appendedSlide = currentPresentation.appendSlide(
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

Parâmetros

NomeTipoDescrição
slideSlideO slide que será copiado, anexado e vinculado.
linkingModeSlideLinkingModeO modo de vinculação a ser usado.

Retornar

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 para este Presentation.

Retornar

User[]: uma matriz de usuários com permissão de 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()

Consegue o identificador exclusivo da apresentação. O ID da apresentação é usado com SlidesApp.openById() para abrir uma instância específica.

Retornar

String: o ID 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

getLayouts()

Recebe os layouts na apresentação.

Retornar

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()

Recebe os mestres na apresentação.

Retornar

Master[]: a lista de masters nesta 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()

Recebe o nome ou título da apresentação.

Retornar

String: o título 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

getNotesMaster()

Recebe o mestre de notas da apresentação.

Retornar

NotesMaster: o master de notas 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()

Recebe a altura da página do modelo de anotações e das páginas de anotações na apresentação em pontos. Elas têm a mesma altura.

Retornar

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()

Recebe a largura da página do master de anotações e das páginas de anotações na apresentação em pontos. Todos têm a mesma largura de página.

Retornar

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 nenhum existir.

Parâmetros

NomeTipoDescrição
idStringO ID do elemento da página que está sendo recuperado.

Retornar

PageElement: o elemento da 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()

Recebe a altura da página dos slides, layouts e modelos na apresentação em pontos. Elas têm a mesma altura.

Retornar

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()

Recebe a largura da página dos slides, layouts e modelos na apresentação em pontos. Todos têm a mesma largura de página.

Retornar

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()

Recebe 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 somente se ele estiver vinculado à apresentação.

A seleção retornada é a seleção atual. À medida que o script realiza várias mudanças na apresentação, a seleção é transformada para levar isso em conta. Por exemplo, se duas formas A e B forem selecionadas e o script remover a forma B, o objeto de seleção retornado será atualizado implicitamente para que apenas a forma A seja selecionada. 

// Gets the current active page that is selected in the active presentation.
const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();

Retornar

Selection: uma representação da seleção do usuário ou null se o script não estiver vinculado à apresentação ou se não houver 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 nenhum existir.

Parâmetros

NomeTipoDescrição
idStringO ID do slide que está sendo recuperado.

Retornar

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()

Consegue os slides da apresentação.

Retornar

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 o URL para acessar essa apresentação. 

const presentation = SlidesApp.getActivePresentation();

// Send out the link to open the presentation.
MailApp.sendEmail(
    '<email-address>',
    presentation.getName(),
    presentation.getUrl(),
);

Retornar

String: o URL para acessar a 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()

Mostra a lista de leitores e comentaristas desse Presentation.

Retornar

User[]: uma matriz de usuários com permissão de visualização 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 modelo atual. O mestre atual é uma das seguintes opções:

  • O mestre do slide anterior.
  • O mestre do primeiro slide, se o insertionIndex for zero.
  • O primeiro mestre na apresentação, se não houver um slide.

Parâmetros

NomeTipoDescrição
insertionIndexIntegerO índice baseado em zero que indica onde inserir o slide.

Retornar

Slide: o novo slide 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 é uma das seguintes opções:

  • O mestre do slide anterior.
  • O mestre do primeiro slide, se o insertionIndex for zero.
  • O primeiro mestre na apresentação, se não houver um slide.

Parâmetros

NomeTipoDescrição
insertionIndexIntegerO índice baseado em zero que indica onde inserir o slide.
layoutLayoutO layout a ser usado para o novo slide. Ele precisa estar presente no modelo atual.

Retornar

Slide: o novo slide 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 especificado com base no mestre atual. O mestre atual é uma das seguintes opções:

  • O mestre do slide anterior.
  • O mestre do primeiro slide, se o insertionIndex for zero.
  • O primeiro mestre na apresentação, se não houver um slide.

Parâmetros

NomeTipoDescrição
insertionIndexIntegerO índice baseado em zero que indica onde inserir o slide.
predefinedLayoutPredefinedLayoutO layout predefinido a ser usado para o novo slide. Ele precisa estar presente no modelo atual.

Retornar

Slide: o novo slide 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 copiado for de uma apresentação diferente, as páginas mestre e de layout pai também serão copiadas, se não existirem na apresentação. 

// Copy a slide from another presentation and inserts it.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
const 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.

Retornar

Slide: o novo slide 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 pelo SlideLinkingMode.

Se o slide copiado for de uma apresentação diferente, as páginas mestre e de layout mãe também serão copiadas se não existirem na apresentação atual.

Se o modo de vinculação for SlideLinkingMode.LINKED, o slide inserido poderá ser atualizado para corresponder ao slide de origem fornecido quando Slide.refreshSlide() for chamado. Outros colaboradores podem acessar 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.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const insertionIndex = 1;
const 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 vinculação a ser usado.

Retornar

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 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 têm acesso geral. Por exemplo, se o 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.

Para arquivos do Drive, isso também remove o usuário da lista de visualizadores.

Parâmetros

NomeTipoDescrição
emailAddressStringO endereço de e-mail do usuário a ser removido.

Retornar

Presentation: 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 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 têm acesso geral. Por exemplo, se o 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.

Para arquivos do Drive, isso também remove o usuário da lista de visualizadores.

Parâmetros

NomeTipoDescrição
userUserUma representação do usuário a ser removido.

Retornar

Presentation: 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 da lista de espectadores e comentaristas do Presentation. Esse método não terá efeito se o usuário for um editor, não um espectador ou comentarista. Esse método também não impede que os usuários acessem o Presentation se eles pertencem a uma classe de usuários que têm acesso geral. Por exemplo, se o 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.

Para arquivos do Drive, isso 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.

Retornar

Presentation: 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 da lista de espectadores e comentaristas do Presentation. Esse método não terá efeito se o usuário for um editor, não um espectador. Esse método também não impede que os usuários acessem o Presentation se eles pertencerem a uma classe de usuários que têm acesso geral. Por exemplo, se o 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.

Para arquivos do Drive, isso também remove o usuário da lista de editores.

Parâmetros

NomeTipoDescrição
userUserUma representação do usuário a ser removido.

Retornar

Presentation: 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 de texto correspondentes ao texto de pesquisa por 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 que vai substituir o texto correspondente.

Retornar

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 de texto correspondentes ao texto de pesquisa por texto de substituição.

Parâmetros

NomeTipoDescrição
findTextStringO texto a ser encontrado.
replaceTextStringO texto que vai substituir o texto correspondente.
matchCaseBooleanSe 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 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 limpas e aplicadas.

O método saveAndClose() é invocado automaticamente no final da execução do script para cada Presentation aberto, mesmo que a execução do script tenha sido encerrada com um erro.

Não é possível editar uma Presentation fechada. Use um dos métodos de abertura em 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 essa 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