Um slide em uma apresentação.
Essas páginas contêm o conteúdo que você está apresentando ao público. A maioria dos slides é baseada em um modelo e um layout. É possível especificar qual layout usar para cada slide quando ele é criado.
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
duplicate() | Slide | Duplica o slide. |
get | Page | Recebe o plano de fundo da página. |
get | Color | Recebe o Color associado à página. |
get | Group[] | Retorna a lista de objetos Group na página. |
get | Image[] | Retorna a lista de objetos Image na página. |
get | Layout|null | Recebe o layout em que o slide se baseia ou null se o slide não se baseia em um
layout. |
get | Line[] | Retorna a lista de objetos Line na página. |
get | Notes | Retorna a página de observações associada ao slide. |
get | String | Recebe o ID exclusivo da página. |
get | Page | Retorna o Page na página com o ID especificado ou null se não houver nenhum. |
get | Page | Retorna a lista de objetos Page renderizados na página. |
get | Page | Recebe o tipo da página. |
get | Page | Retorna o objeto marcador de posição Page para um Placeholder especificado ou null se não houver um marcador de posição correspondente. |
get | Page | Retorna o objeto marcador de posição Page para um Placeholder especificado e um índice de marcador de posição ou null se o marcador de posição não estiver presente. |
get | Page | Retorna a lista de objetos Page de marcador de posição na página. |
get | Shape[] | Retorna a lista de objetos Shape na página. |
get | Sheets | Retorna a lista de objetos Sheets na página. |
get | Slide | Retorna um Slide indicando se o slide está vinculado a outro. |
get | String | Retorna o ID Presentation da origem ou null se o slide não estiver vinculado. |
get | String | Retorna o ID do slide de origem ou null se o slide não estiver vinculado. |
get | Table[] | Retorna a lista de objetos Table na página. |
get | Video[] | Retorna a lista de objetos Video na página. |
get | Word | Retorna a lista de objetos Word na página. |
group(pageElements) | Group | Agrupa todos os elementos de página especificados. |
insert | Group | Insere uma cópia do Group fornecido na página. |
insert | Image | Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do blob de imagem especificado. |
insert | Image | Insere uma imagem na página com a posição e o tamanho fornecidos do blob de imagem especificado. |
insert | Image | Insere uma cópia do Image fornecido na página. |
insert | Image | Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do URL fornecido. |
insert | Image | Insere uma imagem na página com a posição e o tamanho fornecidos pelo URL. |
insert | Line | Insere uma cópia do Line fornecido na página. |
insert | Line | Insere uma linha na página conectando dois connection sites. |
insert | Line | Insere uma linha na página. |
insert | Page | Insere uma cópia do Page fornecido na página. |
insert | Shape | Insere uma cópia do Shape fornecido na página. |
insert | Shape | Insere uma forma na página. |
insert | Shape | Insere uma forma na página. |
insert | Sheets | Insere um gráfico das Planilhas Google na página. |
insert | Sheets | Insere um gráfico das Planilhas Google na página com a posição e o tamanho fornecidos. |
insert | Sheets | Insere uma cópia do Sheets fornecido na página. |
insert | Image | Insere um gráfico das Planilhas Google como um Image na página. |
insert | Image | Insere um gráfico do Google Planilhas como um Image na página com a posição e o tamanho fornecidos. |
insert | Table | Insere uma tabela na página. |
insert | Table | Insere uma tabela na página com a posição e o tamanho fornecidos. |
insert | Table | Insere uma cópia do Table fornecido na página. |
insert | Shape | Insere uma caixa de texto Shape contendo a string fornecida na página. |
insert | Shape | Insere uma caixa de texto Shape contendo a string fornecida na página. |
insert | Video | Insere um vídeo no canto superior esquerdo da página com um tamanho padrão. |
insert | Video | Insere um vídeo na página com a posição e o tamanho fornecidos. |
insert | Video | Insere uma cópia do Video fornecido na página. |
insert | Word | Insere uma cópia do Word fornecido na página. |
is | Boolean | Retorna se o slide é pulado no modo de apresentação. |
move(index) | void | Mova o slide para o índice especificado. |
refresh | void | Atualiza o slide para refletir as mudanças feitas no slide de origem vinculado. |
remove() | void | Remove a página. |
replace | Integer | Substitui todas as instâncias do texto correspondente ao texto de pesquisa pelo texto de substituição. |
replace | Integer | Substitui todas as instâncias do texto correspondente ao texto de pesquisa pelo texto de substituição. |
select | void | Seleciona o Page na apresentação ativa como o current page selection e remove qualquer seleção anterior. |
set | void | Define se o slide é pulado no modo de apresentação. |
unlink() | void | Desvincula o Slide atual do slide de origem. |
Documentação detalhada
duplicate()
Duplica o slide.
O slide duplicado é criado imediatamente após o original.
Retornar
Slide: o slide duplicado.
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
get Background()
Recebe o plano de fundo da página.
Retornar
Page: o plano de fundo da página.
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
get Color Scheme()
Recebe o Color associado à página.
Retornar
Color: o esquema de cores da página.
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
get Groups()
get Images()
get Layout()
Recebe o layout em que o slide se baseia ou null se o slide não se baseia em um
layout.
Retornar
Layout|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
get Lines()
get Notes Page()
get Object Id()
Recebe o ID exclusivo da página. Os IDs de objetos usados por páginas e elementos de página compartilham o mesmo namespace.
Retornar
String
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
get Page Element By Id(id)
Retorna o Page na página com o ID especificado ou null se não houver nenhum.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
id | String | O ID do elemento da página que está sendo recuperado. |
Retornar
Page: 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
get Page Elements()
Retorna a lista de objetos Page renderizados na página.
Retornar
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
get Page Type()
get Placeholder(placeholderType)
Retorna o objeto marcador de posição Page para um Placeholder especificado ou null se não houver um marcador de posição correspondente.
Se houver vários marcadores de posição do mesmo tipo, ele vai retornar aquele com o menor índice. Se houver vários marcadores de posição correspondentes com o mesmo índice, ele vai retornar o primeiro marcador de posição da coleção de elementos da página.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, );
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
placeholder | Placeholder |
Retornar
Page
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
get Placeholder(placeholderType, placeholderIndex)
Retorna o objeto marcador de posição Page para um Placeholder especificado e um índice de marcador de posição ou null se o marcador de posição não estiver presente.
Se houver vários marcadores de posição com o mesmo tipo e índice, ele vai retornar o primeiro marcador de posição da coleção de elementos da página.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, 0, );
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
placeholder | Placeholder | |
placeholder | Integer |
Retornar
Page
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
get Placeholders()
Retorna a lista de objetos Page de marcador de posição na página.
const master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log( `Number of placeholders in the master: ${master.getPlaceholders().length}`, );
Retornar
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
get Shapes()
get Sheets Charts()
Retorna a lista de objetos Sheets na página.
Retornar
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
get Slide Linking Mode()
Retorna um Slide indicando se o slide está vinculado a outro.
Retornar
Slide: o modo de vinculação de slides.
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
get Source Presentation Id()
Retorna o ID Presentation da origem ou null se o slide não estiver vinculado.
Um slide só tem um ID de origem Presentation quando está vinculado a um slide em outra apresentação.
Retornar
String: o ID da apresentação de origem ou 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
get Source Slide Object Id()
Retorna o ID do slide de origem ou null se o slide não estiver vinculado.
Um slide só tem um ID de slide de origem quando está vinculado a um slide em outra apresentação.
Retornar
String: o ID do slide de origem ou 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
get Tables()
get Videos()
get Word Arts()
group(pageElements)
Agrupa todos os elementos de página especificados.
É preciso haver pelo menos dois elementos na mesma página que ainda não estejam em outro grupo. Alguns elementos da página, como Videos, Tables e placeholder Shapes, não podem ser agrupados.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
page | Page | Os elementos a serem agrupados. |
Retornar
Group: o novo grupo.
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
insert Group(group)
Insere uma cópia do Group fornecido na página.
A posição do elemento inserido nesta página é determinada pela posição do elemento de origem na página respectiva.
Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades herdadas das páginas de modelo ou de layout também serão herdadas no elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas das páginas master ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a group between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const group = otherPresentationSlide.getGroups()[0]; currentPresentationSlide.insertGroup( group); // Also available for Layout, Master, and Page.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
group | Group | O grupo a ser copiado e inserido. |
Retornar
Group: o grupo 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
insert Image(blobSource)
Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do blob de imagem especificado.
A inserção busca a imagem do Blob uma vez, e uma cópia é armazenada para exibição na apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar nos formatos PNG, JPEG ou GIF.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); slide.insertImage(image);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
blob | Blob | Dados da imagem. |
Retornar
Image: a imagem inserida.
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
insert Image(blobSource, left, top, width, height)
Insere uma imagem na página com a posição e o tamanho fornecidos do blob de imagem especificado.
A imagem é buscada do Blob fornecido uma vez no momento da inserção, e uma cópia
é armazenada para exibição na apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar nos formatos PNG, JPEG ou GIF.
Para manter a proporção da imagem, ela é dimensionada e centralizada em relação ao tamanho fornecido.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); const position = { left: 0, top: 0 }; const size = { width: 300, height: 100 }; slide.insertImage(image, position.left, position.top, size.width, size.height);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
blob | Blob | Dados da imagem. |
left | Number | A posição horizontal da imagem em pontos, medida do canto superior esquerdo da página. |
top | Number | A posição vertical da imagem em pontos, medida do canto superior esquerdo da página. |
width | Number | A largura da imagem, em pontos. |
height | Number | A altura da imagem em pontos. |
Retornar
Image: a imagem inserida.
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
insert Image(image)
Insere uma cópia do Image fornecido na página.
A posição das imagens inseridas nesta página é determinada pela posição da imagem de origem na página respectiva.
Se a imagem fornecida for um marcador de posição copiado da apresentação atual, as propriedades herdadas das páginas de modelo ou de layout também serão herdadas na imagem inserida.
Se a imagem fornecida for um marcador de posição copiado de outra apresentação, as propriedades herdadas das páginas master ou de layout serão copiadas para a imagem da apresentação de origem. Se a imagem do marcador de posição copiada estiver vazia, nada será inserido na apresentação de destino.
// Copy an image between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const image = otherPresentationSlide.getImages[0]; currentPresentationSlide.insertImage(image);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
image | Image | A imagem a ser copiada e inserida. |
Retornar
Image: a imagem inserida.
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
insert Image(imageUrl)
Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do URL fornecido.
Ao inserir a imagem, ela é buscada no URL uma vez, e uma cópia é armazenada para exibição na apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar no formato PNG, JPEG ou GIF.
O URL fornecido precisa ser acessível publicamente e ter no máximo 2 kB. O URL é salvo com a imagem e exposto via Image.getSourceUrl().
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
image | String | O URL da imagem. |
Retornar
Image: a imagem inserida.
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
insert Image(imageUrl, left, top, width, height)
Insere uma imagem na página com a posição e o tamanho fornecidos pelo URL.
Ao inserir a imagem, ela é buscada no URL uma vez, e uma cópia é armazenada para exibição na apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar no formato PNG, JPEG ou GIF.
O URL fornecido precisa ser acessível publicamente e ter no máximo 2 kB. O URL é salvo com a imagem e exposto via Image.getSourceUrl().
Para manter a proporção da imagem, ela é dimensionada e centralizada em relação ao tamanho fornecido.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
image | String | O URL da imagem. |
left | Number | A posição horizontal da imagem em pontos, medida do canto superior esquerdo da página. |
top | Number | A posição vertical da imagem em pontos, medida do canto superior esquerdo da página. |
width | Number | A largura da imagem, em pontos. |
height | Number | A altura da imagem em pontos. |
Retornar
Image: a imagem inserida.
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
insert Line(line)
Insere uma cópia do Line fornecido na página.
A posição do elemento inserido nesta página é determinada pela posição do elemento de origem na página respectiva.
Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades herdadas das páginas de modelo ou de layout também serão herdadas no elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas das páginas master ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a line between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const line = otherPresentationSlide.getLines[0]; currentPresentationSlide.insertLine(line);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
line | Line | A linha a ser copiada e inserida. |
Retornar
Line: a linha inserida.
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
insert Line(lineCategory, startConnectionSite, endConnectionSite)
Insere uma linha na página conectando dois connection sites. Os dois sites de conexão precisam estar nesta página.
// Insert a line in the first slide of the presentation connecting two shapes. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1], );
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
line | Line | A categoria da linha a ser inserida. |
start | Connection | O local de conexão em que o início da linha será conectado. |
end | Connection | O local de conexão em que a extremidade da linha será conectada. |
Retornar
Line: a linha inserida.
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
insert Line(lineCategory, startLeft, startTop, endLeft, endTop)
Insere uma linha na página.
// Insert a line in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const startPoint = { left: 10, top: 10 }; const endPoint = { left: 40, top: 40 }; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top, );
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
line | Line | A categoria da linha a ser inserida. |
start | Number | A posição horizontal do ponto inicial da linha, medida em pontos do canto superior esquerdo da página. |
start | Number | A posição vertical do ponto inicial da linha, medida em pontos do canto superior esquerdo da página. |
end | Number | A posição horizontal do ponto final da linha, medida em pontos a partir do canto superior esquerdo da página. |
end | Number | A posição vertical do ponto final da linha, medida em pontos do canto superior esquerdo da página. |
Retornar
Line: a linha inserida.
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
insert Page Element(pageElement)
Insere uma cópia do Page fornecido na página.
A posição do elemento inserido nesta página é determinada pela posição do elemento de origem na página respectiva.
Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades herdadas das páginas de modelo ou de layout também serão herdadas no elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas das páginas master ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a page element between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
page | Page | O elemento da página a ser copiado e inserido. |
Retornar
Page: o elemento de página 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
insert Shape(shape)
Insere uma cópia do Shape fornecido na página.
A posição do elemento inserido nesta página é determinada pela posição do elemento de origem na página respectiva.
Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades herdadas das páginas de modelo ou de layout também serão herdadas no elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas das páginas master ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a shape between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const shape = otherPresentationSlide.getShapes[0]; currentPresentationSlide.insertShape( shape); // Also available for Layout, Master, and Page.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
shape | Shape | A forma a ser copiada e inserida. |
Retornar
Shape: a forma inserida.
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
insert Shape(shapeType)
Insere uma forma na página.
A forma é inserida com um tamanho padrão no canto superior esquerdo da página.
// Insert a shape in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
shape | Shape | O tipo de forma a ser inserida. |
Retornar
Shape: a forma inserida.
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
insert Shape(shapeType, left, top, width, height)
Insere uma forma na página.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
shape | Shape | O tipo de forma a ser inserida. |
left | Number | A posição horizontal da forma, medida do canto superior esquerdo da página. |
top | Number | A posição vertical da forma, medida do canto superior esquerdo da página. |
width | Number | É a largura da forma. |
height | Number | É a altura da forma. |
Retornar
Shape: a forma inserida.
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
insert Sheets Chart(sourceChart)
Insere um gráfico das Planilhas Google na página.
O gráfico é inserido com um tamanho padrão no canto superior esquerdo da página.
O gráfico inserido é vinculado ao gráfico de origem das Planilhas Google, o que permite que ele seja atualizado. Outros colaboradores podem ver o link para a planilha de origem.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
source | Embedded | O gráfico em uma planilha a ser inserido na página. |
Retornar
Sheets: o gráfico inserido na página.
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
insert Sheets Chart(sourceChart, left, top, width, height)
Insere um gráfico das Planilhas Google na página com a posição e o tamanho fornecidos.
Para manter a proporção do gráfico, ele é dimensionado e centralizado em relação ao tamanho fornecido.
O gráfico inserido é vinculado ao gráfico de origem das Planilhas Google, o que permite que ele seja atualizado. Outros colaboradores podem ver o link para a planilha de origem.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const size = { width: 200, height: 200 }; // Also available for Layout, Master, and Page. slide.insertSheetsChart( chart, position.left, position.top, size.width, size.height, );
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
source | Embedded | O gráfico em uma planilha a ser inserido na página. |
left | Number | A posição horizontal do gráfico em pontos, medida do canto superior esquerdo da página. |
top | Number | A posição vertical do gráfico em pontos, medida do canto superior esquerdo da página. |
width | Number | A largura do gráfico em pontos. |
height | Number | A altura do gráfico em pontos. |
Retornar
Sheets: o gráfico inserido na página.
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
insert Sheets Chart(sheetsChart)
Insere uma cópia do Sheets fornecido na página.
A posição do elemento inserido nesta página é determinada pela posição do elemento de origem na página respectiva.
Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades herdadas das páginas de modelo ou de layout também serão herdadas no elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas das páginas master ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a sheets chart between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sheets | Sheets | O gráfico das planilhas a ser copiado e inserido. |
Retornar
Sheets: o gráfico de planilhas 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
insert Sheets Chart As Image(sourceChart)
Insere um gráfico das Planilhas Google como um Image na página.
A imagem do gráfico é inserida com um tamanho padrão no canto superior esquerdo da página.
A imagem inserida do gráfico não está vinculada ao gráfico de origem das Planilhas Google.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage( chart); // Also available for Layout, Master, and Page.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
source | Embedded | O gráfico em uma planilha a ser inserido na página. |
Retornar
Image: a imagem inserida do gráfico na página.
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
insert Sheets Chart As Image(sourceChart, left, top, width, height)
Insere um gráfico do Google Planilhas como um Image na página com a posição e o tamanho fornecidos.
Para manter a proporção da imagem do gráfico, ela é dimensionada e centralizada de acordo com o tamanho fornecido.
A imagem inserida do gráfico não está vinculada ao gráfico de origem do Google Planilhas.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const size = { width: 200, height: 200 }; // Also available for Layout, Master, and Page. slide.insertSheetsChartAsImage( chart, position.left, position.right, size.width, size.height, );
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
source | Embedded | O gráfico em uma planilha a ser inserido na página. |
left | Number | A posição horizontal do gráfico em pontos, medida do canto superior esquerdo da página. |
top | Number | A posição vertical do gráfico em pontos, medida do canto superior esquerdo da página. |
width | Number | A largura do gráfico em pontos. |
height | Number | A altura do gráfico em pontos. |
Retornar
Image: a imagem inserida do gráfico na página.
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
insert Table(numRows, numColumns)
Insere uma tabela na página.
A tabela é centralizada na página com tamanho padrão e linhas e colunas distribuídas uniformemente.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
num | Integer | O número de linhas na tabela. |
num | Integer | O número de colunas na tabela. |
Retornar
Table: a tabela inserida.
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
insert Table(numRows, numColumns, left, top, width, height)
Insere uma tabela na página com a posição e o tamanho fornecidos.
As linhas e colunas são distribuídas de maneira uniforme na tabela criada.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
num | Integer | O número de linhas na tabela. |
num | Integer | O número de colunas na tabela. |
left | Number | A posição horizontal da tabela, medida do canto superior esquerdo da página. |
top | Number | A posição vertical da tabela, medida do canto superior esquerdo da página. |
width | Number | A largura da tabela. |
height | Number | A altura mínima da tabela. A altura real da tabela renderizada depende de fatores como o tamanho da fonte do texto. |
Retornar
Table: a tabela inserida.
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
insert Table(table)
Insere uma cópia do Table fornecido na página.
A posição do elemento inserido nesta página é determinada pela posição do elemento de origem na página respectiva.
Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades herdadas das páginas de modelo ou de layout também serão herdadas no elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas das páginas master ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a table between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const table = otherPresentationSlide.getTables[0]; currentPresentationSlide.insertTable( table); // Also available for Layout, Master, and Page.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
table | Table | A tabela a ser copiada e inserida. |
Retornar
Table: a tabela inserida.
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
insert Text Box(text)
Insere uma caixa de texto Shape contendo a string fornecida na página.
A forma da caixa de texto é inserida com um tamanho padrão no canto superior esquerdo da página.
// Insert text box with "Hello" on the first slide of presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
text | String | A string que a forma da caixa de texto precisa conter. |
Retornar
Shape: a forma da caixa de texto inserida.
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
insert Text Box(text, left, top, width, height)
Insere uma caixa de texto Shape contendo a string fornecida na página.
// Insert text box with "Hello" on the first slide of presentation. This text // box is a square with a length of 10 points on each side. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox( 'Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
text | String | A string que a forma da caixa de texto precisa conter. |
left | Number | A posição horizontal da forma da caixa de texto, medida do canto superior esquerdo da página. |
top | Number | A posição vertical da forma da caixa de texto, medida do canto superior esquerdo da página. |
width | Number | A largura da forma da caixa de texto. |
height | Number | A altura da forma da caixa de texto. |
Retornar
Shape: a forma da caixa de texto inserida.
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
insert Video(videoUrl)
Insere um vídeo no canto superior esquerdo da página com um tamanho padrão.
No momento, apenas vídeos do YouTube são aceitos.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
video | String | O URL do vídeo a ser inserido. |
Retornar
Video: o vídeo 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
insert Video(videoUrl, left, top, width, height)
Insere um vídeo na página com a posição e o tamanho fornecidos.
No momento, apenas vídeos do YouTube são aceitos.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
video | String | O URL do vídeo a ser inserido. |
left | Number | A posição horizontal do vídeo em pontos, medida do canto superior esquerdo da página. |
top | Number | A posição vertical do vídeo em pontos, medida do canto superior esquerdo da página. |
width | Number | A largura do vídeo em pontos. |
height | Number | A altura do vídeo em pontos. |
Retornar
Video: o vídeo 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
insert Video(video)
Insere uma cópia do Video fornecido na página.
A posição do elemento inserido nesta página é determinada pela posição do elemento de origem na página respectiva.
Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades herdadas das páginas de modelo ou de layout também serão herdadas no elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas das páginas master ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a video between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const video = otherPresentationSlide.getVideos[0]; currentPresentationSlide.insertVideo( video); // Also available for Layout, Master, and Page.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
video | Video | O vídeo a ser copiado e inserido. |
Retornar
Video: o vídeo 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
insert Word Art(wordArt)
Insere uma cópia do Word fornecido na página.
A posição do elemento inserido nesta página é determinada pela posição do elemento de origem na página respectiva.
Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades herdadas das páginas de modelo ou de layout também serão herdadas no elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas das páginas master ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a word art between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
word | Word | O grupo a ser copiado e inserido. |
Retornar
Word: o Word Art 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
is Skipped()
Retorna se o slide é pulado no modo de apresentação.
Retornar
Boolean — True se o slide for pulado no modo de 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
move(index)
Mova o slide para o índice especificado.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
index | Integer | O índice para onde o slide deve ser movido, com base na organização dos slides antes da movimentação. O índice precisa estar entre zero e o número de slides na apresentação, incluindo esses dois valores. |
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
refresh Slide()
Atualiza o slide para refletir as mudanças feitas no slide de origem vinculado. Se o slide não estiver vinculado, a função vai retornar sem fazer mudanças.
O método refresh copia os modelos e layouts correspondentes do slide de origem vinculado para a apresentação do slide, se eles ainda não existirem. Se eles já existirem, também serão atualizados para refletir as mudanças feitas na origem.
const currentPresentation = SlidesApp.getActivePresentation(); const sourcePresentation = SlidesApp.openById('sourcePresentationId'); const sourceSlide = sourcePresentation.getSlides()[0]; const linkedSlide = currentPresentation.append( sourceSlide, SlidesApp.SlideLinkingMode.LINKED, ); sourceSlide.insertText( 'hello world'); // Only the source slide has the text box. linkedSlide.refreshSlide(); // The linked slide now has the text box.
Gera
Error: se o acesso de leitura à apresentação de origem não estiver mais disponível.
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
remove()
Remove a página.
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
replace All Text(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
| Nome | Tipo | Descrição |
|---|---|---|
find | String | O texto a ser encontrado. |
replace | String | O 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
replace All Text(findText, replaceText, matchCase)
Substitui todas as instâncias do texto correspondente ao texto de pesquisa pelo texto de substituição.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
find | String | O texto a ser encontrado. |
replace | String | O texto que vai substituir o texto correspondente. |
match | Boolean | Se 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
select As Current Page()
Seleciona o Page na apresentação ativa como o current page selection e remove qualquer seleção anterior.
Um script só pode acessar a seleção do usuário que o está executando e apenas se ele estiver vinculado à apresentação.
// Select the first slide as the current page selection and replace any previous // selection. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.
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
set Skipped(isSkipped)
Define se o slide é pulado no modo de apresentação.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
is | Boolean | True para pular o slide no modo de 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
unlink()
Desvincula o Slide atual do slide de origem. Se o slide não estiver vinculado, retorna sem fazer alterações.
const currentPresentation = SlidesApp.getActivePresentation(); const sourcePresentation = SlidesApp.openById('sourcePresentationId'); const sourceSlide = sourcePresentation.getSlides()[0]; const linkedSlide = currentPresentation.append( sourceSlide, SlidesApp.SlideLinkingMode.LINKED, ); linkedSlide.unlink(); linkedSlide.getSourcePresentationId(); // returns null linkedSlide.getSourceSlideObjectId(); // returns null linkedSlide .getSlideLinkingMode(); // returns SlidesApp.SlideLinkingMode.NOT_LINKED
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