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 à 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 à lista de leitores do Presentation.
appendSlide()SlideAdiciona um slide ao final da apresentação usando o layout predefinido PredefinedLayout.BLANK 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)SlideAdiciona 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()StringRecebe 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 slide mestre de observações 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 modelo de anotações e das páginas de anotações na apresentação em pontos.
getPageElementById(id)PageElement|nullRetorna o PageElement com o ID fornecido ou null se não houver nenhum.
getPageHeight()NumberRecebe a altura da página dos slides, layouts e mestres na apresentação em pontos.
getPageWidth()NumberRecebe a largura da página dos slides, layouts e mestres na apresentação em pontos.
getSelection()Selection|nullRecebe a seleção do usuário na apresentação ativa.
getSlideById(id)Slide|nullRetorna o Slide com o ID fornecido ou null se não houver nenhum.
getSlides()Slide[]Recebe os slides na apresentação.
getUrl()StringRecupera o URL para acessar esta apresentação.
getViewers()User[]Recebe a lista de leitores e comentaristas deste Presentation.
insertSlide(insertionIndex)SlideInsere um slide no índice especificado da apresentação usando o layout predefinido PredefinedLayout.BLANK com base no modelo mestre atual.
insertSlide(insertionIndex, layout)SlideInsere um slide no índice especificado da apresentação usando o layout especificado com base no mestre atual.
insertSlide(insertionIndex, predefinedLayout)SlideInsere um slide no índice especificado da 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 da apresentação.
insertSlide(insertionIndex, slide, linkingMode)SlideInsere uma cópia do Slide fornecido da apresentação de origem no índice especificado da apresentação atual e define o link do slide conforme especificado pelo 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 espectadores e comentaristas do Presentation.
removeViewer(user)PresentationRemove o usuário especificado da lista de espectadores e comentaristas do Presentation.
replaceAllText(findText, replaceText)IntegerSubstitui todas as instâncias do texto correspondente ao texto de pesquisa pelo texto de substituição.
replaceAllText(findText, replaceText, matchCase)IntegerSubstitui todas as instâncias do texto correspondente ao texto de pesquisa pelo texto de substituição.
saveAndClose()voidSalva o Presentation atual.
setName(name)voidDefine o nome ou 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á estava na lista de leitores, esse método o remove dela.

Parâmetros

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

Retornar

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á estava na lista de leitores, esse método o remove dela.

Parâmetros

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

Retornar

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 à lista de editores do Presentation. Se algum dos usuários já estava na lista de espectadores, esse método o remove dela.

Parâmetros

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

Retornar

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á estava na lista de editores, esse método não tem efeito.

Parâmetros

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

Retornar

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á estava na lista de editores, esse método não tem efeito.

Parâmetros

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

Retornar

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 à lista de leitores 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: 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()

Adiciona um slide ao final da apresentação usando o layout predefinido PredefinedLayout.BLANK com base no modelo atual. O master atual é um dos seguintes:

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

Retornar

Slide: o novo slide que é 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 master atual é um dos seguintes:

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

Parâmetros

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

Retornar

Slide: o novo slide que é 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 master atual é um dos seguintes:

  • O modelo do último slide atual.
  • O primeiro mestre na 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 modelo atual.

Retornar

Slide: o novo slide que é 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 outra apresentação, os layouts e a página principal também serão copiados se ainda não existirem na apresentação atual. 

// 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 que é 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)

Adiciona 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 outra apresentação, as páginas de layout e modelo principal 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.
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 a 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()

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

Recebe os layouts na apresentação.

Retornar

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

getMasters()

Recebe os mestres na apresentação.

Retornar

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

Recebe o slide mestre de observações da apresentação.

Retornar

NotesMaster: o mestre de anotações 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. Todas têm a mesma altura de página.

Retornar

Number: a altura da página de anotações 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 modelo de anotações e das páginas de anotações na apresentação em pontos. Todas elas têm a mesma largura de página.

Retornar

Number: a largura da página de anotações 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 da página que está sendo recuperado.

Retornar

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

getPageHeight()

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

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 mestres na apresentação em pontos. Todas elas 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 o está executando e apenas se ele estiver vinculado à apresentação.

A seleção retornada é a seleção efetiva atual. À medida que o script faz várias mudanças na apresentação, a seleção é transformada para levar isso em consideração. 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|null: 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 válida do usuá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

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.

Retornar

Slide|null: o slide 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

getSlides()

Recebe os slides na apresentação.

Retornar

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

getUrl()

Recupera o URL para acessar esta 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()

Recebe a lista de leitores e comentaristas deste Presentation.

Retornar

User[]: uma matriz de usuários com permissão para visualizar ou comentar.

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 da apresentação usando o layout predefinido PredefinedLayout.BLANK com base no modelo mestre atual. O mestre atual é um dos seguintes:

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

Parâmetros

NomeTipoDescrição
insertionIndexIntegerO índice com base 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 da apresentação usando o layout especificado com base no mestre atual. O master atual é um dos seguintes:

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

Parâmetros

NomeTipoDescrição
insertionIndexIntegerO índice com base em zero que indica onde inserir o slide.
layoutLayoutO layout a ser usado no 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 da apresentação usando o layout predefinido especificado com base no mestre atual. O master atual é um dos seguintes:

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

Parâmetros

NomeTipoDescrição
insertionIndexIntegerO índice com base em zero que indica onde inserir o slide.
predefinedLayoutPredefinedLayoutO layout predefinido a ser usado no 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 da apresentação.

Se o slide copiado for de outra apresentação, os layouts e a página principal também serão copiados se ainda não existirem na apresentação atual. 

// 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 com base 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 da apresentação atual e define o link do slide conforme especificado pelo SlideLinkingMode.

Se o slide copiado for de outra apresentação, as páginas de layout e modelo principal 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 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.
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 com base 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 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 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 leitores.

Parâmetros

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

Retornar

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 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 leitores.

Parâmetros

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

Retornar

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 espectadores e comentaristas do Presentation. Esse método não tem 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 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 especificado da lista de espectadores e comentaristas do Presentation. Esse método não tem efeito se o usuário for um editor, não um leitor. 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 possa 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 do texto correspondente ao texto de pesquisa 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 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

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

saveAndClose()

Salva o Presentation atual. Faz com que as atualizações pendentes sejam transferidas 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 terminado 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 específica 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 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