Esta página foi traduzida pela API Cloud Translation.

Class SlidesApp

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

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 um `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 cores.
`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 plano de fundo da página.
`PageElementType`	`PageElementType`	Uma enumeração dos tipos de elementos da 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ções.
`ShapeType`	`ShapeType`	Uma enumeração dos tipos de formas.
`SheetsChartEmbedType`	`SheetsChartEmbedType`	Uma enumeração de tipos de incorporação de gráficos das Planilhas
`SlideLinkingMode`	`SlideLinkingMode`	Uma enumeração das maneiras de vincular os slides.
`SlidePosition`	`SlidePosition`	Uma enumeração dos tipos de posições de slides.
`SpacingMode`	`SpacingMode`	Uma enumeração dos tipos de modos de espaçamento.
`TextBaselineOffset`	`TextBaselineOffset`	Uma enumeração dos tipos de deslocamento da linha de base do texto.
`TextDirection`	`TextDirection`	Uma enumeração dos tipos de direções em texto.
`ThemeColorType`	`ThemeColorType`	Uma enumeração de cores do tema.
`VideoSourceType`	`VideoSourceType`	Uma enumeração dos tipos de fonte de vídeo.

Métodos

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

Documentação detalhada

`create(name)`

Cria e abre uma nova Presentation.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome da apresentação criada.

Retornar

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

`getActivePresentation()`

Retorna a apresentação ativa atual a que o script está vinculado ao contêiner ou null se não houver apresentação ativa. Para interagir com uma apresentação em 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

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 que o script adicione 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 somente se o script estiver vinculado à apresentação. 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 é predefinido com a transformação afim de identidade.

Retornar

AffineTransformBuilder

`openById(id)`

Abre o Presentation com o ID fornecido.

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

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

Retornar

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 o Presentation com o URL fornecido.

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

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

Retornar

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