Class Page

Page

Une page d'une présentation.

Méthodes

MéthodeType renvoyéBrève description
asLayout()LayoutRenvoie la page sous forme de mise en page.
asMaster()MasterRenvoie la page en tant que page maître.
asSlide()SlideAffiche la page sous forme de diapositive.
getBackground()PageBackgroundRécupère l'arrière-plan de la page.
getColorScheme()ColorSchemeRécupère les ColorScheme associés à la page.
getGroups()Group[]Affiche la liste des objets Group sur la page.
getImages()Image[]Affiche la liste des objets Image sur la page.
getLines()Line[]Affiche la liste des objets Line sur la page.
getObjectId()StringRécupère l'identifiant unique de la page.
getPageElementById(id)PageElementAffiche le PageElement sur la page avec l'ID donné ou null s'il n'en existe aucun.
getPageElements()PageElement[]Affiche la liste des objets PageElement affichés sur la page.
getPageType()PageTypeRécupère le type de page.
getPlaceholder(placeholderType)PageElementRenvoie l'objet d'espace réservé PageElement pour une valeur PlaceholderType spécifiée ou null si aucun espace réservé correspondant n'est présent.
getPlaceholder(placeholderType, placeholderIndex)PageElementRenvoie l'objet d'espace réservé PageElement pour un PlaceholderType spécifié et un index d'espace réservé, ou null si l'espace réservé n'est pas présent.
getPlaceholders()PageElement[]Affiche la liste des objets PageElement réservés sur la page.
getShapes()Shape[]Affiche la liste des objets Shape sur la page.
getSheetsCharts()SheetsChart[]Affiche la liste des objets SheetsChart sur la page.
getTables()Table[]Affiche la liste des objets Table sur la page.
getVideos()Video[]Affiche la liste des objets Video sur la page.
getWordArts()WordArt[]Affiche la liste des objets WordArt sur la page.
group(pageElements)GroupRegroupe tous les éléments de page spécifiés.
insertGroup(group)GroupInsère une copie de la propriété Group fournie sur la page.
insertImage(blobSource)ImageInsère dans l'angle supérieur gauche de la page une image dont la taille par défaut correspond à celle blob d'image.
insertImage(blobSource, left, top, width, height)ImageInsère une image sur la page avec la position et la taille fournies par l'objet blob d'image spécifié.
insertImage(image)ImageInsère une copie de la propriété Image fournie sur la page.
insertImage(imageUrl)ImageInsère dans l'angle supérieur gauche de la page une image dont la taille correspond par défaut à celle de l'URL fournie.
insertImage(imageUrl, left, top, width, height)ImageInsère une image sur la page avec la position et la taille fournies à partir de l'URL fournie.
insertLine(line)LineInsère une copie de la propriété Line fournie sur la page.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineInsère une ligne sur la page reliant deux connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)LineInsère une ligne sur la page.
insertPageElement(pageElement)PageElementInsère une copie de la propriété PageElement fournie sur la page.
insertShape(shape)ShapeInsère une copie de la propriété Shape fournie sur la page.
insertShape(shapeType)ShapeInsère une forme sur la page.
insertShape(shapeType, left, top, width, height)ShapeInsère une forme sur la page.
insertSheetsChart(sourceChart)SheetsChartInsère un graphique Google Sheets sur la page.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartInsère sur la page un graphique Google Sheets avec la position et la taille fournies.
insertSheetsChart(sheetsChart)SheetsChartInsère une copie de la propriété SheetsChart fournie sur la page.
insertSheetsChartAsImage(sourceChart)ImageInsère un graphique Google Sheets sur la page en tant que Image.
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageInsère un graphique Google Sheets sous forme de Image sur la page, avec la position indiquée et la taille de l'image.
insertTable(numRows, numColumns)TableInsère un tableau sur la page.
insertTable(numRows, numColumns, left, top, width, height)TableInsère sur la page un tableau avec la position et la taille fournies.
insertTable(table)TableInsère une copie de la propriété Table fournie sur la page.
insertTextBox(text)ShapeInsère une zone de texte Shape contenant la chaîne fournie sur la page.
insertTextBox(text, left, top, width, height)ShapeInsère une zone de texte Shape contenant la chaîne fournie sur la page.
insertVideo(videoUrl)VideoInsère une vidéo dans l'angle supérieur gauche de la page, avec une taille par défaut.
insertVideo(videoUrl, left, top, width, height)VideoInsère une vidéo sur la page avec la position et la taille fournies.
insertVideo(video)VideoInsère une copie de la propriété Video fournie sur la page.
insertWordArt(wordArt)WordArtInsère une copie de la propriété WordArt fournie sur la page.
remove()voidSupprime la page.
replaceAllText(findText, replaceText)IntegerRemplace toutes les occurrences de texte correspondant au texte à rechercher par le texte de remplacement.
replaceAllText(findText, replaceText, matchCase)IntegerRemplace toutes les occurrences de texte correspondant au texte à rechercher par le texte de remplacement.
selectAsCurrentPage()voidSélectionne le Page dans la présentation active en tant que current page selection et supprime toute sélection précédente.

Documentation détaillée

asLayout()

Renvoie la page sous forme de mise en page.

Renvois

Layout : page en tant que mise en page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

asMaster()

Renvoie la page en tant que page maître.

Renvois

Master : page en tant que maître.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

asSlide()

Affiche la page sous forme de diapositive.

Renvois

Slide : page sous forme de diapositive.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getBackground()

Récupère l'arrière-plan de la page.

Renvois

PageBackground : arrière-plan de la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getColorScheme()

Récupère les ColorScheme associés à la page.

Renvois

ColorScheme : jeu de couleurs de la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getGroups()

Affiche la liste des objets Group sur la page.

Renvois

Group[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getImages()

Affiche la liste des objets Image sur la page.

Renvois

Image[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLines()

Affiche la liste des objets Line sur la page.

Renvois

Line[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getObjectId()

Récupère l'identifiant unique de la page. Les ID d'objet utilisés par les pages et les éléments de page partagent les mêmes espace de noms.

Renvois

String

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageElementById(id)

Affiche le PageElement sur la page avec l'ID donné ou null s'il n'en existe aucun.

Paramètres

NomTypeDescription
idStringID de l'élément de page en cours de récupération.

Renvois

PageElement : élément de page ayant l'ID donné.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageElements()

Affiche la liste des objets PageElement affichés sur la page.

Renvois

PageElement[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageType()

Récupère le type de page.

Renvois

PageType : type de page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholder(placeholderType)

Renvoie l'objet d'espace réservé PageElement pour une valeur PlaceholderType spécifiée ou null si aucun espace réservé correspondant n'est présent.

S'il existe plusieurs espaces réservés du même type, il renvoie celui avec le minimum index d'espace réservé. S'il existe plusieurs espaces réservés correspondants avec le même index, la méthode renvoie le premier espace réservé de la collection d'éléments de page de la page.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);

Paramètres

NomTypeDescription
placeholderTypePlaceholderType

Renvois

PageElement

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholder(placeholderType, placeholderIndex)

Renvoie l'objet d'espace réservé PageElement pour un PlaceholderType spécifié et un index d'espace réservé, ou null si l'espace réservé n'est pas présent.

S'il existe plusieurs espaces réservés avec le même type et le même index, la première valeur dans la collection d'éléments de page de la page.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);

Paramètres

NomTypeDescription
placeholderTypePlaceholderType
placeholderIndexInteger

Renvois

PageElement

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholders()

Affiche la liste des objets PageElement réservés sur la page.

var master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log('Number of placeholders in the master: '   master.getPlaceholders().length);

Renvois

PageElement[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getShapes()

Affiche la liste des objets Shape sur la page.

Renvois

Shape[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSheetsCharts()

Affiche la liste des objets SheetsChart sur la page.

Renvois

SheetsChart[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTables()

Affiche la liste des objets Table sur la page.

Renvois

Table[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getVideos()

Affiche la liste des objets Video sur la page.

Renvois

Video[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getWordArts()

Affiche la liste des objets WordArt sur la page.

Renvois

WordArt[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

group(pageElements)

Regroupe tous les éléments de page spécifiés.

Il doit y avoir au moins deux éléments de page sur une même page qui ne se trouvent pas déjà dans une autre groupe. Certains éléments de page, tels que Videos, Tables et placeholder Shapes, ne peuvent pas être regroupés.

Paramètres

NomTypeDescription
pageElementsPageElement[]Éléments à regrouper.

Renvois

Group : nouveau groupe.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertGroup(group)

Insère une copie de la propriété Group fournie sur la page.

La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.

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

Paramètres

NomTypeDescription
groupGroupGroupe à copier et à insérer.

Renvois

Group : groupe inséré.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(blobSource)

Insère dans l'angle supérieur gauche de la page une image dont la taille par défaut correspond à celle blob d'image.

Lorsque vous insérez l'image, elle est récupérée à partir de BlobSource une seule fois, et une copie est stockée pour à afficher dans la présentation. La taille des images doit être inférieure à 50 Mo et ne doit pas dépasser 25 et doivent être au format 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);

Paramètres

NomTypeDescription
blobSourceBlobSourceDonnées de l'image.

Renvois

Image : image insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(blobSource, left, top, width, height)

Insère une image sur la page avec la position et la taille fournies par l'objet blob d'image spécifié.

L'image est extraite de l'élément BlobSource fourni une fois au moment de l'insertion et une copie est stockée pour être affichée dans la présentation. La taille des images ne doit pas dépasser 50 Mo dépasse 25 mégapixels et doit être au format PNG, JPEG ou GIF.

Afin de conserver ses proportions, l'image est mise à l'échelle et centrée par rapport au à la taille indiquée.

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);

Paramètres

NomTypeDescription
blobSourceBlobSourceDonnées de l'image.
leftNumberPosition horizontale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur de l'image en points.
heightNumberHauteur de l'image en points.

Renvois

Image : image insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(image)

Insère une copie de la propriété Image fournie sur la page.

La position des images insérées sur cette page est déterminée à partir de la position de l'image source. sur leur page respective.

Si l'image fournie est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'image insérée.

Si l'image fournie est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées sur l'image à partir de la source. présentation. Si l'image de remplacement copiée est vide, rien n'est inséré dans la destination présentation.

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

Paramètres

NomTypeDescription
imageImageImage à copier et à insérer.

Renvois

Image : image insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(imageUrl)

Insère dans l'angle supérieur gauche de la page une image dont la taille correspond par défaut à celle de l'URL fournie.

Lorsque l'image est insérée, elle est récupérée à partir de l'URL une fois. Une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo, ne doivent pas dépasser 25 mégapixels et doivent au format PNG, JPEG ou GIF.

L'URL fournie doit être accessible publiquement et ne doit pas dépasser 2 Ko. L'URL elle-même est enregistrée avec l'image et exposée via Image.getSourceUrl().

Paramètres

NomTypeDescription
imageUrlStringURL de l'image.

Renvois

Image : image insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(imageUrl, left, top, width, height)

Insère une image sur la page avec la position et la taille fournies à partir de l'URL fournie.

Lorsque l'image est insérée, elle est récupérée à partir de l'URL une fois. Une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo, ne doivent pas dépasser 25 mégapixels et doivent au format PNG, JPEG ou GIF.

L'URL fournie doit être accessible publiquement et ne doit pas dépasser 2 Ko. L'URL elle-même est enregistrée avec l'image et exposée via Image.getSourceUrl().

Afin de conserver ses proportions, l'image est mise à l'échelle et centrée par rapport au à la taille indiquée.

Paramètres

NomTypeDescription
imageUrlStringURL de l'image.
leftNumberPosition horizontale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur de l'image en points.
heightNumberHauteur de l'image en points.

Renvois

Image : image insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertLine(line)

Insère une copie de la propriété Line fournie sur la page.

La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.

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

Paramètres

NomTypeDescription
lineLineLigne à copier et à insérer.

Renvois

Line : ligne insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertLine(lineCategory, startConnectionSite, endConnectionSite)

Insère une ligne sur la page reliant deux connection sites. Les deux sites de connexion doivent figurer sur cette page.

// 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]);

Paramètres

NomTypeDescription
lineCategoryLineCategoryCatégorie de la ligne à insérer.
startConnectionSiteConnectionSiteLe site de connexion où le début de la ligne doit être connecté.
endConnectionSiteConnectionSiteLe site de connexion où l'extrémité de la ligne doit être connectée.

Renvois

Line : ligne insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertLine(lineCategory, startLeft, startTop, endLeft, endTop)

Insère une ligne sur la page.

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

Paramètres

NomTypeDescription
lineCategoryLineCategoryCatégorie de la ligne à insérer.
startLeftNumberPosition horizontale du point de départ de la ligne, mesurée en points en haut à gauche de la page.
startTopNumberPosition verticale du point de départ de la ligne, mesurée en points depuis dans le coin supérieur gauche de la page.
endLeftNumberLa position horizontale du point d'arrivée de la ligne, mesurée en points depuis dans le coin supérieur gauche de la page.
endTopNumberPosition verticale du point d'arrivée de la ligne, mesurée en points à partir du dans le coin supérieur gauche de la page.

Renvois

Line : ligne insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertPageElement(pageElement)

Insère une copie de la propriété PageElement fournie sur la page.

La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.

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

Paramètres

NomTypeDescription
pageElementPageElementÉlément de page à copier et à insérer.

Renvois

PageElement : élément de page inséré.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertShape(shape)

Insère une copie de la propriété Shape fournie sur la page.

La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.

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

Paramètres

NomTypeDescription
shapeShapeForme à copier et à insérer.

Renvois

Shape : forme insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertShape(shapeType)

Insère une forme sur la page.

La forme est insérée avec une taille par défaut dans l'angle supérieur gauche de la page.

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

Paramètres

NomTypeDescription
shapeTypeShapeTypeType de forme à insérer.

Renvois

Shape : forme insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertShape(shapeType, left, top, width, height)

Insère une forme sur la page.

Paramètres

NomTypeDescription
shapeTypeShapeTypeType de forme à insérer.
leftNumberPosition horizontale de la forme, mesurée à partir de l'angle supérieur gauche du .
topNumberPosition verticale de la forme, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur de la forme.
heightNumberHauteur de la forme.

Renvois

Shape : forme insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChart(sourceChart)

Insère un graphique Google Sheets sur la page.

Le graphique est inséré avec une taille par défaut dans l'angle supérieur gauche de la page.

Le graphique inséré est lié au graphique Google Sheets source, ce qui lui permet d'être mis à jour. Les autres collaborateurs peuvent voir le lien vers la feuille de calcul source.

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);

Paramètres

NomTypeDescription
sourceChartEmbeddedChartGraphique d'une feuille de calcul à insérer dans la page.

Renvois

SheetsChart : graphique inséré dans la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChart(sourceChart, left, top, width, height)

Insère sur la page un graphique Google Sheets avec la position et la taille fournies.

Afin de conserver le format, le graphique est mis à l'échelle et centré par rapport à à la taille indiquée.

Le graphique inséré est lié au graphique Google Sheets source, ce qui lui permet d'être mis à jour. Les autres collaborateurs peuvent voir le lien vers la feuille de calcul source.

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);

Paramètres

NomTypeDescription
sourceChartEmbeddedChartGraphique d'une feuille de calcul à insérer dans la page.
leftNumberPosition horizontale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale du graphique en points, mesurée à partir de l'angle supérieur gauche du graphique la page.
widthNumberLargeur du graphique en points.
heightNumberHauteur du graphique en points.

Renvois

SheetsChart : graphique inséré dans la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChart(sheetsChart)

Insère une copie de la propriété SheetsChart fournie sur la page.

La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.

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

Paramètres

NomTypeDescription
sheetsChartSheetsChartGraphique Sheets à copier et insérer.

Renvois

SheetsChart : graphique des feuilles inséré.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChartAsImage(sourceChart)

Insère un graphique Google Sheets sur la page en tant que Image.

L'image du graphique est insérée avec une taille par défaut dans l'angle supérieur gauche de la page.

L'image insérée du graphique n'est pas associée au graphique Google Sheets source.

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.

Paramètres

NomTypeDescription
sourceChartEmbeddedChartGraphique d'une feuille de calcul à insérer dans la page.

Renvois

Image : image insérée du graphique dans la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChartAsImage(sourceChart, left, top, width, height)

Insère un graphique Google Sheets sous forme de Image sur la page, avec la position indiquée et la taille de l'image.

Afin de conserver le format de l'image du graphique, l'image est mise à l'échelle et centrée avec par rapport à la taille fournie.

L'image insérée du graphique n'est pas liée au graphique Google Sheets source.

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);

Paramètres

NomTypeDescription
sourceChartEmbeddedChartGraphique d'une feuille de calcul à insérer dans la page.
leftNumberPosition horizontale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale du graphique en points, mesurée à partir de l'angle supérieur gauche du graphique la page.
widthNumberLargeur du graphique en points.
heightNumberHauteur du graphique en points.

Renvois

Image : image insérée du graphique dans la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTable(numRows, numColumns)

Insère un tableau sur la page.

Le tableau est centré sur la page avec sa taille par défaut et ses lignes et ses colonnes réparties uniformément.

Paramètres

NomTypeDescription
numRowsIntegerNombre de lignes dans la table.
numColumnsIntegerNombre de colonnes du tableau.

Renvois

Table : table insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTable(numRows, numColumns, left, top, width, height)

Insère sur la page un tableau avec la position et la taille fournies.

Les lignes et les colonnes sont réparties uniformément dans la table créée.

Paramètres

NomTypeDescription
numRowsIntegerNombre de lignes dans la table.
numColumnsIntegerNombre de colonnes du tableau.
leftNumberPosition horizontale du tableau, mesurée à partir de l'angle supérieur gauche du .
topNumberPosition verticale du tableau, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur du tableau.
heightNumberHauteur minimale du tableau. La hauteur réelle du tableau affiché dépend sur des facteurs tels que la taille de la police du texte.

Renvois

Table : table insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTable(table)

Insère une copie de la propriété Table fournie sur la page.

La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.

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

Paramètres

NomTypeDescription
tableTableTableau à copier et à insérer.

Renvois

Table : table insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTextBox(text)

Insère une zone de texte Shape contenant la chaîne fournie sur la page.

La zone de texte est insérée avec une taille par défaut dans l'angle supérieur gauche de la page.

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

Paramètres

NomTypeDescription
textStringChaîne que doit contenir la zone de texte.

Renvois

Shape : forme de la zone de texte insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTextBox(text, left, top, width, height)

Insère une zone de texte Shape contenant la chaîne fournie sur la page.

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

Paramètres

NomTypeDescription
textStringChaîne que doit contenir la zone de texte.
leftNumberPosition horizontale de la forme de la zone de texte, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale de la forme de la zone de texte, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur de la forme de la zone de texte.
heightNumberHauteur de la forme de la zone de texte.

Renvois

Shape : forme de la zone de texte insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertVideo(videoUrl)

Insère une vidéo dans l'angle supérieur gauche de la page, avec une taille par défaut.

Seules les vidéos YouTube sont actuellement prises en charge.

Paramètres

NomTypeDescription
videoUrlStringURL de la vidéo à insérer.

Renvois

Video : vidéo insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertVideo(videoUrl, left, top, width, height)

Insère une vidéo sur la page avec la position et la taille fournies.

Seules les vidéos YouTube sont actuellement prises en charge.

Paramètres

NomTypeDescription
videoUrlStringURL de la vidéo à insérer.
leftNumberPosition horizontale de la vidéo en points, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale de la vidéo, exprimée en points, mesurée à partir de l'angle supérieur gauche la page.
widthNumberLargeur de la vidéo en points.
heightNumberHauteur de la vidéo en points.

Renvois

Video : vidéo insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertVideo(video)

Insère une copie de la propriété Video fournie sur la page.

La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.

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

Paramètres

NomTypeDescription
videoVideoVidéo à copier et à insérer.

Renvois

Video : vidéo insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertWordArt(wordArt)

Insère une copie de la propriété WordArt fournie sur la page.

La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.

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

Paramètres

NomTypeDescription
wordArtWordArtGroupe à copier et à insérer.

Renvois

WordArt : texte Word Art inséré.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

remove()

Supprime la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText)

Remplace toutes les occurrences de texte correspondant au texte à rechercher par le texte de remplacement. La recherche est un cas insensible.

Paramètres

NomTypeDescription
findTextStringTexte à rechercher.
replaceTextStringTexte de remplacement du texte correspondant.

Renvois

Integer : le nombre d'occurrences a changé.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText, matchCase)

Remplace toutes les occurrences de texte correspondant au texte à rechercher par le texte de remplacement.

Paramètres

NomTypeDescription
findTextStringTexte à rechercher.
replaceTextStringTexte de remplacement du texte correspondant.
matchCaseBooleanSi la valeur est true, la recherche est sensible à la casse. Si la valeur est false, la recherche est non sensible à la casse.

Renvois

Integer : le nombre d'occurrences a changé.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

selectAsCurrentPage()

Sélectionne le Page dans la présentation active en tant que current page selection et supprime toute sélection précédente.

Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et seulement si le script est lié à la présentation.

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations