Esta página foi traduzida pela API Cloud Translation.

Class SlidesApp

Cria e abre Presentations que podem ser editados.

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

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

Propriedades

Propriedade	Tipo	Descrição
`AlignmentPosition`	`AlignmentPosition`	Uma enumeração dos tipos de posições de alinhamento.
`ArrowStyle`	`ArrowStyle`	Uma enumeração dos diferentes estilos de seta que uma `Line` pode ter.
`AutoTextType`	`AutoTextType`	Uma enumeração dos tipos de texto automático.
`AutofitType`	`AutofitType`	Uma enumeração de tipos de ajuste automático.
`CellMergeState`	`CellMergeState`	Uma enumeração dos diferentes estados de mesclagem de uma célula de tabela.
`ColorType`	`ColorType`	Uma enumeração de tipos de cor.
`ContentAlignment`	`ContentAlignment`	Uma enumeração de valores usados para especificar o alinhamento do conteúdo.
`DashStyle`	`DashStyle`	Uma enumeração dos diferentes estilos de traço que um `Line` pode ter.
`FillType`	`FillType`	Uma enumeração de tipos de preenchimento.
`LineCategory`	`LineCategory`	Uma enumeração das categorias de `Line`.
`LineFillType`	`LineFillType`	Uma enumeração dos tipos de `LineFill`.
`LineType`	`LineType`	Uma enumeração dos tipos de `Line`.
`LinkType`	`LinkType`	Uma enumeração dos tipos de links.
`ListPreset`	`ListPreset`	Uma enumeração dos tipos de predefinições de lista.
`PageBackgroundType`	`PageBackgroundType`	Uma enumeração dos tipos de planos de fundo da página.
`PageElementType`	`PageElementType`	Uma enumeração dos tipos de elementos de página.
`PageType`	`PageType`	Uma enumeração dos tipos de páginas.
`ParagraphAlignment`	`ParagraphAlignment`	Uma enumeração dos tipos de alinhamento de parágrafo.
`PlaceholderType`	`PlaceholderType`	Uma enumeração dos tipos de marcadores de posição.
`PredefinedLayout`	`PredefinedLayout`	Uma enumeração dos layouts predefinidos.
`SelectionType`	`SelectionType`	Uma enumeração dos tipos de seleção.
`ShapeType`	`ShapeType`	Uma enumeração dos tipos de formas.
`SheetsChartEmbedType`	`SheetsChartEmbedType`	Uma enumeração dos tipos de incorporação de gráficos das Planilhas Google.
`SlideLinkingMode`	`SlideLinkingMode`	Uma enumeração das formas de vincular as Apresentações Google.
`SlidePosition`	`SlidePosition`	Uma enumeração dos tipos de posições no slide.
`SpacingMode`	`SpacingMode`	Uma enumeração dos tipos de modos de espaçamento.
`TextBaselineOffset`	`TextBaselineOffset`	Uma enumeração dos tipos de deslocamento de valor de referência do texto.
`TextDirection`	`TextDirection`	Uma enumeração dos tipos de rotas de texto.
`ThemeColorType`	`ThemeColorType`	Uma enumeração de cores do tema.
`VideoSourceType`	`VideoSourceType`	Uma enumeração dos tipos de origem do vídeo.

Métodos

Método	Tipo de retorno	Breve descrição
`create(name)`	`Presentation`	Cria e abre um novo `Presentation`.
`getActivePresentation()`	`Presentation`	Retorna a apresentação ativa no momento à qual o script está vinculado ao contêiner ou `null` se não houver uma apresentação ativa.
`getUi()`	`Ui`	Retorna uma instância do ambiente da interface do usuário da apresentação que permite ao script adicionar recursos como menus, caixas de diálogo e barras laterais.
`newAffineTransformBuilder()`	`AffineTransformBuilder`	Retorna um novo `AffineTransformBuilder` para criar um `AffineTransform`.
`openById(id)`	`Presentation`	Abre a `Presentation` com o ID fornecido.
`openByUrl(url)`	`Presentation`	Abre a `Presentation` com o URL fornecido.

Documentação detalhada

`create(name)`

Cria e abre um novo Presentation.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome a ser dado à apresentação criada.

Retorno

Presentation: a apresentação com o nome indicado.

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 à qual o script está vinculado ao contêiner ou null se não houver uma apresentação ativa. Para interagir com uma apresentação em que o script não está vinculado a um contêiner, use openById(id).

// Get the current presentation to which this script is bound.
var presentation = SlidesApp.getActivePresentation();

Se a apresentação já estiver aberta, a mesma instância de apresentação será retornada.

Retorno

Presentation

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 da 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 IU na instância atual de uma apresentação aberta e apenas se ele estiver vinculado à apresentação. Para mais informações, consulte os guias sobre 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();
}

Retorno

Ui

`newAffineTransformBuilder()`

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

Retorno

AffineTransformBuilder

`openById(id)`

Abre a Presentation com o ID fornecido.

// Open a presentation by ID.
var presentation = SlidesApp.openById('docId');

Se a apresentação já estiver aberta, a mesma instância de apresentação será retornada.

Parâmetros

Nome	Tipo	Descrição
`id`	`String`

Retorno

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

`openByUrl(url)`

Abre a Presentation com o URL fornecido.

// Open a presentation by URL.
var presentation = SlidesApp.openByUrl('https://docs.google.com/presentation/d/docId/edit');

Se a apresentação já estiver aberta, a mesma instância de apresentação será retornada.

Parâmetros

Nome	Tipo	Descrição
`url`	`String`

Retorno

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