Uma página em uma apresentação.
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
asLayout() | Layout | Retorna a página como um layout. |
asMaster() | Master | Retorna a página como mestre. |
asSlide() | Slide | Retorna a página como um slide. |
getBackground() | PageBackground | Recebe o plano de fundo da página. |
getColorScheme() | ColorScheme | Acessa o ColorScheme associado à página. |
getGroups() | Group[] | Retorna a lista de objetos Group na página. |
getImages() | Image[] | Retorna a lista de objetos Image na página. |
getLines() | Line[] | Retorna a lista de objetos Line na página. |
getObjectId() | String | Recebe o ID exclusivo da página. |
getPageElementById(id) | PageElement | Retornará PageElement na página com o ID fornecido ou null, se não existir nenhum. |
getPageElements() | PageElement[] | Retorna a lista de objetos PageElement renderizados na página. |
getPageType() | PageType | Recebe o tipo da página. |
getPlaceholder(placeholderType) | PageElement | Retorna o objeto PageElement do marcador de posição para um PlaceholderType ou
null especificado se um marcador correspondente não estiver presente. |
getPlaceholder(placeholderType, placeholderIndex) | PageElement | Retorna o objeto PageElement do marcador de posição para um PlaceholderType especificado e
um índice de marcador ou null se o marcador não estiver presente. |
getPlaceholders() | PageElement[] | Retorna a lista de objetos PageElement de marcador de posição na página. |
getShapes() | Shape[] | Retorna a lista de objetos Shape na página. |
getSheetsCharts() | SheetsChart[] | Retorna a lista de objetos SheetsChart na página. |
getTables() | Table[] | Retorna a lista de objetos Table na página. |
getVideos() | Video[] | Retorna a lista de objetos Video na página. |
getWordArts() | WordArt[] | Retorna a lista de objetos WordArt na página. |
group(pageElements) | Group | Agrupa todos os elementos de página especificados. |
insertGroup(group) | Group | Insere uma cópia do Group fornecido na página. |
insertImage(blobSource) | Image | Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do blob de imagem especificado. |
insertImage(blobSource, left, top, width, height) | Image | Insere uma imagem na página com a posição e o tamanho fornecidos do blob de imagem especificado. |
insertImage(image) | Image | Insere uma cópia do Image fornecido na página. |
insertImage(imageUrl) | Image | Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do URL fornecido. |
insertImage(imageUrl, left, top, width, height) | Image | Insere uma imagem na página com a posição e o tamanho informados no URL. |
insertLine(line) | Line | Insere uma cópia do Line fornecido na página. |
insertLine(lineCategory, startConnectionSite, endConnectionSite) | Line | Insere uma linha na página que conecta duas connection sites. |
insertLine(lineCategory, startLeft, startTop, endLeft, endTop) | Line | Insere uma linha na página. |
insertPageElement(pageElement) | PageElement | Insere uma cópia do PageElement fornecido na página. |
insertShape(shape) | Shape | Insere uma cópia do Shape fornecido na página. |
insertShape(shapeType) | Shape | Insere uma forma na página. |
insertShape(shapeType, left, top, width, height) | Shape | Insere uma forma na página. |
insertSheetsChart(sourceChart) | SheetsChart | Insere um gráfico do Planilhas Google na página. |
insertSheetsChart(sourceChart, left, top, width, height) | SheetsChart | Insere um gráfico do Planilhas Google na página com a posição e o tamanho fornecidos. |
insertSheetsChart(sheetsChart) | SheetsChart | Insere uma cópia do SheetsChart fornecido na página. |
insertSheetsChartAsImage(sourceChart) | Image | Insere um gráfico do Planilhas Google como Image na página. |
insertSheetsChartAsImage(sourceChart, left, top, width, height) | Image | Insere um gráfico do Planilhas Google como um Image na página com a posição e o tamanho fornecidos. |
insertTable(numRows, numColumns) | Table | Insere uma tabela na página. |
insertTable(numRows, numColumns, left, top, width, height) | Table | Insere uma tabela na página com a posição e o tamanho fornecidos. |
insertTable(table) | Table | Insere uma cópia do Table fornecido na página. |
insertTextBox(text) | Shape | Insere uma caixa de texto Shape contendo a string fornecida na página. |
insertTextBox(text, left, top, width, height) | Shape | Insere uma caixa de texto Shape contendo a string fornecida na página. |
insertVideo(videoUrl) | Video | Insere um vídeo no canto superior esquerdo da página com um tamanho padrão. |
insertVideo(videoUrl, left, top, width, height) | Video | Insere um vídeo na página com a posição e o tamanho fornecidos. |
insertVideo(video) | Video | Insere uma cópia do Video fornecido na página. |
insertWordArt(wordArt) | WordArt | Insere uma cópia do WordArt fornecido na página. |
remove() | void | Remove a página. |
replaceAllText(findText, replaceText) | Integer | Substitui todas as instâncias de texto que correspondem à pesquisa por texto. |
replaceAllText(findText, replaceText, matchCase) | Integer | Substitui todas as instâncias de texto que correspondem à pesquisa por texto. |
selectAsCurrentPage() | void | Seleciona a Page na apresentação ativa como current page selection e remove as seleções anteriores. |
Documentação detalhada
asLayout()
asMaster()
asSlide()
getBackground()
Recebe o plano de fundo da página.
Retornar
PageBackground: 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
getColorScheme()
Acessa o ColorScheme associado à página.
Retornar
ColorScheme: 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
getGroups()
getImages()
getLines()
getObjectId()
Recebe o ID exclusivo da página. Os IDs de objeto 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
getPageElementById(id)
Retornará PageElement na página com o ID fornecido ou null, se não existir nenhum.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
id | String | ID do elemento de página que está sendo recuperado. |
Retornar
PageElement: o elemento de página 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.currentonly -
https://www.googleapis.com/auth/presentations
getPageElements()
Retorna a lista de objetos PageElement 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
getPageType()
getPlaceholder(placeholderType)
Retorna o objeto PageElement do marcador de posição para um PlaceholderType ou
null especificado se um marcador correspondente não estiver presente.
Se houver vários marcadores com o mesmo tipo, ele retornará o que tiver o mínimo de índice de marcador. Se houver vários marcadores correspondentes com o mesmo índice, ele retornará o primeiro marcador do conjunto de elementos da página.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
placeholderType | PlaceholderType |
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
getPlaceholder(placeholderType, placeholderIndex)
Retorna o objeto PageElement do marcador de posição para um PlaceholderType especificado e
um índice de marcador ou null se o marcador não estiver presente.
Se houver vários marcadores com o mesmo tipo e índice, ele retornará o primeiro marcador da coleção de elementos da página.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
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
getPlaceholders()
Retorna a lista de objetos PageElement de marcador de posição na página.
var 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
getShapes()
getSheetsCharts()
Retorna a lista de objetos SheetsChart 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
getTables()
getVideos()
getWordArts()
group(pageElements)
Agrupa todos os elementos de página especificados.
É preciso haver pelo menos dois elementos de página na mesma página que ainda não estejam em outro
grupo. Não é possível agrupar alguns elementos da página, como Videos, Tables e placeholder Shapes.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
pageElements | PageElement[] | Os elementos para agrupar. |
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
insertGroup(group)
Insere uma cópia do Group fornecido na página.
A posição do elemento inserido nesta página é determinada a partir da posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador de posição copiado na apresentação atual, as propriedades herdadas de páginas mestre ou de layout também vão herdar o elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas de páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a group between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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
insertImage(blobSource)
Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do blob de imagem especificado.
Ao inserir a imagem, ela vai ser buscada no BlobSource uma vez, e uma cópia será armazenada para
exibição na apresentação. As imagens precisam ter menos de 50 MB, não podem ultrapassar 25
megapixels e estão no formato PNG, JPEG ou GIF.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); slide.insertImage(image);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
blobSource | BlobSource | 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
insertImage(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 no BlobSource 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 estar nos formatos PNG, JPEG ou GIF.
Para manter a proporção da imagem, ela é dimensionada e centralizada de acordo com o tamanho fornecido.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
var position = {left: 0, top: 0};
var size = {width: 300, height: 100};
slide.insertImage(image, position.left, position.top, size.width, size.height);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
blobSource | BlobSource | Dados da imagem. |
left | Number | Posição horizontal da imagem em pontos, medida a partir do canto superior esquerdo da página. |
top | Number | Posição vertical da imagem em pontos, medida a partir 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
insertImage(image)
Insere uma cópia do Image fornecido na página.
A posição das imagens inseridas nesta página é determinada com base na posição da imagem de origem na respectiva página.
Se a imagem fornecida for um marcador de posição copiado na apresentação atual, as propriedades herdadas de páginas mestre ou de layout também vão herdar a imagem inserida.
Se a imagem fornecida for um marcador sendo copiado de uma apresentação diferente, as propriedades herdadas de páginas mestre 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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
insertImage(imageUrl)
Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do URL fornecido.
Inserir a imagem busca no URL uma vez e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem ultrapassar 25 megapixels e precisam estar no formato PNG, JPEG ou GIF.
O URL fornecido precisa ser acessível publicamente e não pode ser maior que 2 KB. O URL é salvo
com a imagem e exposto por Image.getSourceUrl().
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
imageUrl | 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
insertImage(imageUrl, left, top, width, height)
Insere uma imagem na página com a posição e o tamanho informados no URL.
Inserir a imagem busca no URL uma vez e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem ultrapassar 25 megapixels e precisam estar no formato PNG, JPEG ou GIF.
O URL fornecido precisa ser acessível publicamente e não pode ser maior que 2 KB. O URL é salvo
com a imagem e exposto por Image.getSourceUrl().
Para manter a proporção da imagem, ela é dimensionada e centralizada de acordo com o tamanho fornecido.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
imageUrl | String | O URL da imagem. |
left | Number | Posição horizontal da imagem em pontos, medida a partir do canto superior esquerdo da página. |
top | Number | Posição vertical da imagem em pontos, medida a partir 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
insertLine(line)
Insere uma cópia do Line fornecido na página.
A posição do elemento inserido nesta página é determinada a partir da posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador de posição copiado na apresentação atual, as propriedades herdadas de páginas mestre ou de layout também vão herdar o elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas de páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a line between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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
insertLine(lineCategory, startConnectionSite, endConnectionSite)
Insere uma linha na página que conecta duas connection sites. Os dois
sites de conexão precisam estar nessa página.
// Insert a line in the first slide of the presentation connecting two shapes.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
SlidesApp.LineCategory.BENT,
shape1.getConnectionSites()[0],
shape2.getConnectionSites()[1]);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
lineCategory | LineCategory | A categoria da linha a ser inserida. |
startConnectionSite | ConnectionSite | O site de conexão em que o início da linha deve ser conectado. |
endConnectionSite | ConnectionSite | O site de conexão em que o final da linha deve ser conectado. |
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
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)
Insere uma linha na página.
// Insert a line in the first slide of the presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var startPoint = {left: 10, top: 10};
var endPoint = {left: 40, top: 40};
slide.insertLine(
SlidesApp.LineCategory.STRAIGHT,
startPoint.left,
startPoint.top,
endPoint.left,
endPoint.top);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
lineCategory | LineCategory | A categoria da linha a ser inserida. |
startLeft | Number | Posição horizontal do ponto inicial da linha, medida em pontos a partir do canto superior esquerdo da página. |
startTop | Number | Posição vertical do ponto inicial da linha, medida em pontos a partir do canto superior esquerdo da página. |
endLeft | Number | Posição horizontal do ponto final da linha, medida em pontos a partir do canto superior esquerdo da página. |
endTop | Number | Posição vertical do ponto final da linha, medida em pontos a partir 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
insertPageElement(pageElement)
Insere uma cópia do PageElement fornecido na página.
A posição do elemento inserido nesta página é determinada a partir da posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador de posição copiado na apresentação atual, as propriedades herdadas de páginas mestre ou de layout também vão herdar o elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas de páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a page element between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = otherPresentationSlide.getPageElements()[0];
// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
pageElement | PageElement | O elemento da página a ser copiado e inserido. |
Retornar
PageElement: 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
insertShape(shape)
Insere uma cópia do Shape fornecido na página.
A posição do elemento inserido nesta página é determinada a partir da posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador de posição copiado na apresentação atual, as propriedades herdadas de páginas mestre ou de layout também vão herdar o elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas de páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a shape between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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
insertShape(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. var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
shapeType | ShapeType | O tipo de forma a ser inserido. |
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
insertShape(shapeType, left, top, width, height)
Insere uma forma na página.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
shapeType | ShapeType | O tipo de forma a ser inserido. |
left | Number | A posição horizontal da forma, medida a partir do canto superior esquerdo da página. |
top | Number | A posição vertical da forma, medida a partir do canto superior esquerdo da página. |
width | Number | É a largura do formato. |
height | Number | É a altura do formato. |
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
insertSheetsChart(sourceChart)
Insere um gráfico do 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 do Planilhas Google de origem para ser atualizado. Outros colaboradores podem ver o link para a planilha de origem.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sourceChart | EmbeddedChart | O gráfico em uma planilha a ser inserido na página. |
Retornar
SheetsChart: 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
insertSheetsChart(sourceChart, left, top, width, height)
Insere um gráfico do 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 de acordo com o tamanho fornecido.
O gráfico inserido é vinculado ao gráfico do Planilhas Google de origem para ser atualizado. Outros colaboradores podem ver o link para a planilha de origem.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var 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 |
|---|---|---|
sourceChart | EmbeddedChart | O gráfico em uma planilha a ser inserido na página. |
left | Number | Posição horizontal do gráfico em pontos, medida a partir do canto superior esquerdo da página. |
top | Number | Posição vertical do gráfico em pontos, medida a partir 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
SheetsChart: 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
insertSheetsChart(sheetsChart)
Insere uma cópia do SheetsChart fornecido na página.
A posição do elemento inserido nesta página é determinada a partir da posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador de posição copiado na apresentação atual, as propriedades herdadas de páginas mestre ou de layout também vão herdar o elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas de páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a sheets chart between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var sheetsChart = otherPresentationSlide.getSheetsCharts[0];
// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sheetsChart | SheetsChart | O gráfico de planilhas a ser copiado e inserido. |
Retornar
SheetsChart: o gráfico de páginas 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
insertSheetsChartAsImage(sourceChart)
Insere um gráfico do Planilhas Google como 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 do Planilhas Google de origem.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
sourceChart | EmbeddedChart | 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
insertSheetsChartAsImage(sourceChart, left, top, width, height)
Insere um gráfico do Planilhas Google 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 é redimensionada e centralizada com o tamanho fornecido.
A imagem inserida não está vinculada ao gráfico do Planilhas Google de origem.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var 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 |
|---|---|---|
sourceChart | EmbeddedChart | O gráfico em uma planilha a ser inserido na página. |
left | Number | Posição horizontal do gráfico em pontos, medida a partir do canto superior esquerdo da página. |
top | Number | Posição vertical do gráfico em pontos, medida a partir 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
insertTable(numRows, numColumns)
Insere uma tabela na página.
A tabela é centralizada na página com o tamanho padrão e as linhas e colunas distribuídas de maneira uniforme.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
numRows | Integer | O número de linhas na tabela. |
numColumns | 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
insertTable(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 |
|---|---|---|
numRows | Integer | O número de linhas na tabela. |
numColumns | Integer | O número de colunas na tabela. |
left | Number | A posição horizontal da tabela, medida a partir do canto superior esquerdo da página. |
top | Number | A posição vertical da tabela, medida a partir 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
insertTable(table)
Insere uma cópia do Table fornecido na página.
A posição do elemento inserido nesta página é determinada a partir da posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador de posição copiado na apresentação atual, as propriedades herdadas de páginas mestre ou de layout também vão herdar o elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas de páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a table between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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
insertTextBox(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.
var 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 deve conter. |
Retornar
Shape: o formato da caixa de texto 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
insertTextBox(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.
var 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 deve conter. |
left | Number | A posição horizontal da forma da caixa de texto, medida a partir do canto superior esquerdo da página. |
top | Number | A posição vertical da forma da caixa de texto, medida a partir do canto superior esquerdo da página. |
width | Number | É a largura do formato da caixa de texto. |
height | Number | É a altura do formato da caixa de texto. |
Retornar
Shape: o formato da caixa de texto 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
insertVideo(videoUrl)
Insere um vídeo no canto superior esquerdo da página com um tamanho padrão.
No momento, somente vídeos do YouTube são suportados.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
videoUrl | 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
insertVideo(videoUrl, left, top, width, height)
Insere um vídeo na página com a posição e o tamanho fornecidos.
No momento, somente vídeos do YouTube são suportados.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
videoUrl | String | É o URL do vídeo a ser inserido. |
left | Number | É a posição horizontal do vídeo em pontos, medida a partir do canto superior esquerdo da página. |
top | Number | É a posição vertical do vídeo em pontos, medida a partir 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
insertVideo(video)
Insere uma cópia do Video fornecido na página.
A posição do elemento inserido nesta página é determinada a partir da posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador de posição copiado na apresentação atual, as propriedades herdadas de páginas mestre ou de layout também vão herdar o elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas de páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a video between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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 que 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
insertWordArt(wordArt)
Insere uma cópia do WordArt fornecido na página.
A posição do elemento inserido nesta página é determinada a partir da posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador de posição copiado na apresentação atual, as propriedades herdadas de páginas mestre ou de layout também vão herdar o elemento inserido.
Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas de páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.
// Copy a word art between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var wordArt = otherPresentationSlide.getWordArts[0];
// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
wordArt | WordArt | O grupo a ser copiado e inserido. |
Retornar
WordArt: 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
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
replaceAllText(findText, replaceText)
Substitui todas as instâncias de texto que correspondem à pesquisa por texto. A pesquisa não diferencia maiúsculas de minúsculas.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
findText | String | O texto a ser encontrado. |
replaceText | String | O texto que será substituído. |
Retornar
Integer: o número de ocorrências alteradas.
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 de texto que correspondem à pesquisa por texto.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
findText | String | O texto a ser encontrado. |
replaceText | String | O texto que será substituído. |
matchCase | Boolean | Se true, a pesquisa diferencia maiúsculas de minúsculas. Se for false, a pesquisa não diferencia maiúsculas de minúsculas. |
Retornar
Integer: o número de ocorrências alteradas.
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
selectAsCurrentPage()
Seleciona a Page na apresentação ativa como current page selection e remove as seleções anteriores.
Um script só pode acessar a seleção do usuário que o está executando e somente se ele estiver vinculado à apresentação.
// Select the first slide as the current page selection and replace any previous selection. var 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