Class SlidesApp

App Apresentações

Cria e abre Presentations que pode ser editado. 

// Open a presentation by ID.
let preso = SlidesApp.openById('PRESENTATION_ID_GOES_HERE');

// Create and open a presentation.
preso = SlidesApp.create('Presentation Name');

Propriedades

PropriedadeTipoDescrição
AlignmentPositionAlignmentPositionUma enumeração dos tipos de posições de alinhamento.
ArrowStyleArrowStyleUma enumeração dos diferentes estilos de seta que um Line pode ter.
AutoTextTypeAutoTextTypeUma enumeração dos tipos de texto automático.
AutofitTypeAutofitTypeUma enumeração de tipos de ajuste automático.
CellMergeStateCellMergeStateUma enumeração dos diferentes estados de mesclagem de uma célula de tabela.
ColorTypeColorTypeUma enumeração de tipos de cores.
ContentAlignmentContentAlignmentUma enumeração de valores usados para especificar o alinhamento do conteúdo.
DashStyleDashStyleUma enumeração dos diferentes estilos de traço que um Line pode ter.
FillTypeFillTypeUma enumeração de tipos de preenchimento.
LineCategoryLineCategoryUma enumeração das categorias de Line.
LineFillTypeLineFillTypeUma enumeração dos tipos de LineFill.
LineTypeLineTypeUma enumeração dos tipos de Line.
LinkTypeLinkTypeUma enumeração dos tipos de links.
ListPresetListPresetUma enumeração dos tipos de predefinições de lista.
PageBackgroundTypePageBackgroundTypeUma enumeração dos tipos de planos de fundo de página.
PageElementTypePageElementTypeUma enumeração dos tipos de elementos da página.
PageTypePageTypeUma enumeração dos tipos de páginas.
ParagraphAlignmentParagraphAlignmentUma enumeração dos tipos de alinhamento de parágrafo.
PlaceholderTypePlaceholderTypeUma enumeração dos tipos de marcadores de posição.
PredefinedLayoutPredefinedLayoutUma enumeração dos layouts predefinidos.
SelectionTypeSelectionTypeUma enumeração dos tipos de seleções.
ShapeTypeShapeTypeUma enumeração dos tipos de formas.
SheetsChartEmbedTypeSheetsChartEmbedTypeUma enumeração dos tipos de incorporação de gráficos das Planilhas.
SlideLinkingModeSlideLinkingModeUma enumeração das maneiras como as Apresentações Google podem ser vinculadas.
SlidePositionSlidePositionUma enumeração dos tipos de posições de slides.
SpacingModeSpacingModeUma enumeração dos tipos de modos de espaçamento.
TextBaselineOffsetTextBaselineOffsetUma enumeração dos tipos de ajuste de linha de base do texto.
TextDirectionTextDirectionUma enumeração dos tipos de rotas em texto.
ThemeColorTypeThemeColorTypeUma enumeração de cores de tema.
VideoSourceTypeVideoSourceTypeUma enumeração dos tipos de fonte de vídeo.

Métodos

MétodoTipo de retornoBreve descrição
create(name)PresentationCria e abre um novo Presentation.
getActivePresentation()Presentation|nullRetorna a apresentação ativa no momento a que o script está vinculado ao contêiner ou null se não houver uma apresentação ativa.
getUi()UiRetorna uma instância do ambiente de interface do usuário da apresentação que permite ao script adicionar recursos como menus, caixas de diálogo e barras laterais.
newAffineTransformBuilder()AffineTransformBuilderRetorna um novo AffineTransformBuilder para criar um AffineTransform.
openById(id)PresentationAbre o Presentation com o ID especificado.
openByUrl(url)PresentationAbre o Presentation com o URL especificado.

Documentação detalhada

create(name)

Cria e abre um novo Presentation.

Parâmetros

NomeTipoDescrição
nameStringO nome da apresentação criada.

Retornar

Presentation: a apresentação com o nome 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

getActivePresentation()

Retorna a apresentação ativa no momento a que o script está vinculado ao contêiner ou null se não houver uma apresentação ativa. Para interagir com uma apresentação a que o script não está vinculado ao contêiner, use openById(id). 

// Get the current presentation to which this script is bound.
const presentation = SlidesApp.getActivePresentation();
 Se a apresentação já estiver aberta, a mesma instância será retornada.

Retornar

Presentation|null

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

getUi()

Retorna uma instância do ambiente de interface do usuário da apresentação que permite ao script adicionar recursos como menus, caixas de diálogo e barras laterais. Um script só pode interagir com a interface da instância atual de uma apresentação aberta e apenas se estiver vinculado a ela. Para mais informações, consulte os guias de menus e caixas de diálogo e barras laterais. 

// Add a custom menu to the active presentation, including a separator and a
// sub-menu.
function onOpen(e) {
  SlidesApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(
          SlidesApp.getUi()
              .createMenu('My sub-menu')
              .addItem('One sub-menu item', 'mySecondFunction')
              .addItem('Another sub-menu item', 'myThirdFunction'),
          )
      .addToUi();
}

Retornar

Ui

newAffineTransformBuilder()

Retorna um novo AffineTransformBuilder para criar um AffineTransform. O builder vem predefinido com a transformação afim de identidade.

Retornar

AffineTransformBuilder

openById(id)

Abre o Presentation com o ID especificado. 

// Open a presentation by ID.
const presentation = SlidesApp.openById('docId');
 Se a apresentação já estiver aberta, a mesma instância será retornada.

Parâmetros

NomeTipoDescrição
idString

Retornar

Presentation: a apresentação 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

openByUrl(url)

Abre o Presentation com o URL especificado. 

// Open a presentation by URL.
const presentation = SlidesApp.openByUrl(
    'https://docs.google.com/presentation/d/docId/edit',
);
 Se a apresentação já estiver aberta, a mesma instância será retornada.

Parâmetros

NomeTipoDescrição
urlString

Retornar

Presentation: a apresentação com o URL 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