Class Master

Master

Masque dans une présentation.

Les maîtres contiennent tous les éléments de page courants et les propriétés communes d'un ensemble de mises en page. Ils servent à trois fins:

• Les formes d'espace réservé d'un modèle contiennent les styles de texte et les propriétés de forme par défaut de toutes les formes d'espace réservé des pages qui utilisent ce modèle.
• Les propriétés d'une page maître définissent les propriétés de page communes héritées par ses mises en page.
• Toutes les autres formes de la diapositive maître apparaissent sur toutes les diapositives qui utilisent cette diapositive maître, quelle que soit leur mise en page.

Méthodes

Méthode	Type renvoyé	Brève description
getBackground()	PageBackground	Récupère l'arrière-plan de la page.
getColorScheme()	ColorScheme	Récupère le ColorScheme associé à la page.
getGroups()	Group[]	Affiche la liste des objets Group sur la page.
getImages()	Image[]	Affiche la liste des objets Image sur la page.
getLayouts()	Layout[]	Récupère les mises en page de ce masque.
getLines()	Line[]	Affiche la liste des objets Line sur la page.
getObjectId()	String	Récupère l'ID unique de la page.
getPageElementById(id)	PageElement	Renvoie la PageElement de la page dont l'ID est indiqué, ou null si aucune n'existe.
getPageElements()	PageElement[]	Renvoie la liste des objets PageElement affichés sur la page.
getPageType()	PageType	Récupère le type de la page.
getPlaceholder(placeholderType)	PageElement	Renvoie l'objet PageElement d'espace réservé pour un PlaceholderType ou null spécifié si aucun espace réservé correspondant n'est présent.
getPlaceholder(placeholderType, placeholderIndex)	PageElement	Renvoie l'objet PageElement d'espace réservé pour un PlaceholderType spécifié et un indice d'espace réservé, ou null si l'espace réservé n'est pas présent.
getPlaceholders()	PageElement[]	Renvoie la liste des objets PageElement d'espace réservé de 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)	Group	Regroupe tous les éléments de page spécifiés.
insertGroup(group)	Group	Insère une copie du Group fourni sur la page.
insertImage(blobSource)	Image	Insère une image en haut à gauche de la page avec une taille par défaut à partir du blob d'image spécifié.
insertImage(blobSource, left, top, width, height)	Image	Insère une image sur la page avec la position et la taille fournies à partir du blob d'image spécifié.
insertImage(image)	Image	Insère une copie du Image fourni sur la page.
insertImage(imageUrl)	Image	Insère une image en haut à gauche de la page, à partir de l'URL fournie, avec une taille par défaut.
insertImage(imageUrl, left, top, width, height)	Image	Insère une image sur la page à la position et à la taille indiquées à partir de l'URL fournie.
insertLine(line)	Line	Insère une copie du Line fourni sur la page.
insertLine(lineCategory, startConnectionSite, endConnectionSite)	Line	Insère une ligne sur la page reliant deux connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)	Line	Insère une ligne sur la page.
insertPageElement(pageElement)	PageElement	Insère une copie du PageElement fourni sur la page.
insertShape(shape)	Shape	Insère une copie du Shape fourni sur la page.
insertShape(shapeType)	Shape	Insère une forme sur la page.
insertShape(shapeType, left, top, width, height)	Shape	Insère une forme sur la page.
insertSheetsChart(sourceChart)	SheetsChart	Insère un graphique Google Sheets sur la page.
insertSheetsChart(sourceChart, left, top, width, height)	SheetsChart	Insère un graphique Google Sheets sur la page avec la position et la taille fournies.
insertSheetsChart(sheetsChart)	SheetsChart	Insère une copie du SheetsChart fourni sur la page.
insertSheetsChartAsImage(sourceChart)	Image	Insère un graphique Google Sheets en tant que Image sur la page.
insertSheetsChartAsImage(sourceChart, left, top, width, height)	Image	Insère un graphique Google Sheets en tant que Image sur la page avec la position et la taille fournies.
insertTable(numRows, numColumns)	Table	Insère un tableau sur la page.
insertTable(numRows, numColumns, left, top, width, height)	Table	Insère un tableau sur la page avec la position et la taille fournies.
insertTable(table)	Table	Insère une copie du Table fourni sur la page.
insertTextBox(text)	Shape	Insère une zone de texte Shape contenant la chaîne fournie sur la page.
insertTextBox(text, left, top, width, height)	Shape	Insère une zone de texte Shape contenant la chaîne fournie sur la page.
insertVideo(videoUrl)	Video	Insè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)	Video	Insère une vidéo sur la page avec la position et la taille fournies.
insertVideo(video)	Video	Insère une copie du Video fourni sur la page.
insertWordArt(wordArt)	WordArt	Insère une copie du WordArt fourni sur la page.
remove()	void	Supprime la page.
replaceAllText(findText, replaceText)	Integer	Remplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement.
replaceAllText(findText, replaceText, matchCase)	Integer	Remplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement.
selectAsCurrentPage()	void	Sélectionne le Page de la présentation active comme current page selection et supprime toute sélection précédente.

Documentation détaillée

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 avec 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 le ColorScheme associé à la page.

Renvois

ColorScheme : jeu de couleurs de la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 avec 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 avec un ou plusieurs des champs d'application suivants:

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

---

getLayouts()

Récupère les mises en page de ce masque.

Renvois

Layout[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 avec 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'ID unique de la page. Les ID d'objet utilisés par les pages et les éléments de page partagent le même espace de noms.

Renvois

String

Autorisation

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

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

---

getPageElementById(id)

Renvoie la PageElement de la page dont l'ID est indiqué, ou null si aucune n'existe.

Paramètres

Nom	Type	Description
id	String	ID de l'élément de page récupéré.

Renvois

PageElement : élément de page dont l'ID est indiqué.

Autorisation

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

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

---

getPageElements()

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

Renvois

PageElement[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 la page.

Renvois

PageType : type de page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 PageElement d'espace réservé pour un PlaceholderType ou null spécifié si aucun espace réservé correspondant n'est présent.

Si plusieurs espaces réservés du même type existent, celui renvoyé est celui dont l'index est le plus faible. Si plusieurs espaces réservés correspondants ont le même indice, la fonction renvoie le premier espace réservé de la collection d'éléments de la page.

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

Paramètres

Nom	Type	Description
placeholderType	PlaceholderType

Renvois

PageElement

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 PageElement d'espace réservé pour un PlaceholderType spécifié et un indice d'espace réservé, ou null si l'espace réservé n'est pas présent.

Si plusieurs espaces réservés ont le même type et le même index, la fonction renvoie le premier espace réservé de la collection d'éléments de la page.

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

Paramètres

Nom	Type	Description
placeholderType	PlaceholderType
placeholderIndex	Integer

Renvois

PageElement

Autorisation

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

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

---

getPlaceholders()

Renvoie la liste des objets PageElement d'espace réservé de la page.

const 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 avec 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 avec 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 avec 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 avec 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 avec 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 avec 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.

La page doit comporter au moins deux éléments qui ne font pas déjà partie d'un autre groupe. Certains éléments de page, tels que Videos, Tables et placeholder Shapes, ne peuvent pas être regroupés.

Paramètres

Nom	Type	Description
pageElements	PageElement[]	Éléments à regrouper.

Renvois

Group : nouveau groupe.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 du Group fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source 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 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 de mise en page sont copiées sur l'élément à partir de la présentation source.

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

Paramètres

Nom	Type	Description
group	Group	Groupe à copier et à insérer.

Renvois

Group : groupe inséré.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 une image en haut à gauche de la page avec une taille par défaut à partir du blob d'image spécifié.

L'insertion de l'image la récupère une fois à partir de BlobSource, et une copie est stockée pour l'affichage dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et être au format 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);

Paramètres

Nom	Type	Description
blobSource	BlobSource	Données d'image.

Renvois

Image : image insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 à partir du blob d'image spécifié.

L'image est extraite de l'BlobSource fournie une seule fois au moment de l'insertion, et une copie est stockée pour être affichée dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.

Pour conserver le format de l'image, celle-ci est redimensionnée et centrée par rapport à la taille fournie.

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

Paramètres

Nom	Type	Description
blobSource	BlobSource	Données d'image.
left	Number	Position horizontale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page.
top	Number	Position verticale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page.
width	Number	Largeur de l'image en points.
height	Number	Hauteur de l'image en points.

Renvois

Image : image insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 du Image fourni 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 sa 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 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 de mise en page sont copiées sur l'image à partir de la présentation source. Si l'image d'espace réservé copiée est vide, rien n'est inséré dans la présentation de destination.

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

Paramètres

Nom	Type	Description
image	Image	Image à copier et à insérer.

Renvois

Image : image insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 une image en haut à gauche de la page, à partir de l'URL fournie, avec une taille par défaut.

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

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

Paramètres

Nom	Type	Description
imageUrl	String	URL de l'image.

Renvois

Image : image insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 à la position et à la taille indiquées à partir de l'URL fournie.

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

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

Pour conserver le format de l'image, celle-ci est redimensionnée et centrée par rapport à la taille fournie.

Paramètres

Nom	Type	Description
imageUrl	String	URL de l'image.
left	Number	Position horizontale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page.
top	Number	Position verticale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page.
width	Number	Largeur de l'image en points.
height	Number	Hauteur de l'image en points.

Renvois

Image : image insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 du Line fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source 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 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 de mise en page sont copiées sur l'élément à partir de la présentation source.

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

Paramètres

Nom	Type	Description
line	Line	Ligne à copier et à insérer.

Renvois

Line : ligne insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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.
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],
);

Paramètres

Nom	Type	Description
lineCategory	LineCategory	Catégorie de la ligne à insérer.
startConnectionSite	ConnectionSite	Site de connexion où le début de la ligne doit être connecté.
endConnectionSite	ConnectionSite	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 avec 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.
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,
);

Paramètres

Nom	Type	Description
lineCategory	LineCategory	Catégorie de la ligne à insérer.
startLeft	Number	Position horizontale du point de départ de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.
startTop	Number	Position verticale du point de départ de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.
endLeft	Number	Position horizontale du point final de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.
endTop	Number	Position verticale du point d'arrivée de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.

Renvois

Line : ligne insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 du PageElement fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source 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 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 de mise en page sont copiées sur l'élément à partir de la présentation source.

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

Paramètres

Nom	Type	Description
pageElement	PageElement	É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 avec 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 du Shape fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source 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 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 de mise en page sont copiées sur l'élément à partir de la présentation source.

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

Paramètres

Nom	Type	Description
shape	Shape	Forme à copier et à insérer.

Renvois

Shape : forme insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 en haut à gauche de la page.

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

Paramètres

Nom	Type	Description
shapeType	ShapeType	Type de forme à insérer.

Renvois

Shape : forme insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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

Nom	Type	Description
shapeType	ShapeType	Type de forme à insérer.
left	Number	Position horizontale de la forme, mesurée à partir de l'angle supérieur gauche de la page.
top	Number	Position verticale de la forme, mesurée à partir de l'angle supérieur gauche de la page.
width	Number	Largeur de la forme.
height	Number	Hauteur de la forme.

Renvois

Shape : forme insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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é dans la taille par défaut en haut à gauche de la page.

Le graphique inséré est associé au graphique Google Sheets source, ce qui permet de le mettre à jour. Les autres collaborateurs voient le lien vers la feuille de calcul source.

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

Paramètres

Nom	Type	Description
sourceChart	EmbeddedChart	Graphique d'une feuille de calcul à insérer dans la page.

Renvois

SheetsChart : graphique inséré sur la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 un graphique Google Sheets sur la page avec la position et la taille fournies.

Pour conserver le format du graphique, celui-ci est mis à l'échelle et centré par rapport à la taille fournie.

Le graphique inséré est associé au graphique Google Sheets source, ce qui permet de le mettre à jour. Les autres collaborateurs voient le lien vers la feuille de calcul source.

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

Paramètres

Nom	Type	Description
sourceChart	EmbeddedChart	Graphique d'une feuille de calcul à insérer dans la page.
left	Number	Position horizontale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page.
top	Number	Position verticale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page.
width	Number	Largeur du graphique en points.
height	Number	Hauteur du graphique en points.

Renvois

SheetsChart : graphique inséré sur la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 du SheetsChart fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source 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 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 de mise en page sont copiées sur l'élément à partir de la présentation source.

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

Paramètres

Nom	Type	Description
sheetsChart	SheetsChart	Graphique Sheets à copier et à insérer.

Renvois

SheetsChart : graphique Sheets inséré.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 en tant que Image sur la page.

L'image du graphique est insérée dans une taille par défaut en haut à gauche de la page.

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

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.

Paramètres

Nom	Type	Description
sourceChart	EmbeddedChart	Graphique d'une feuille de calcul à insérer dans la page.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 en tant que Image sur la page avec la position et la taille fournies.

Pour conserver le format de l'image du graphique, l'image est redimensionnée et centrée par rapport à la taille fournie.

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

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

Paramètres

Nom	Type	Description
sourceChart	EmbeddedChart	Graphique d'une feuille de calcul à insérer dans la page.
left	Number	Position horizontale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page.
top	Number	Position verticale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page.
width	Number	Largeur du graphique en points.
height	Number	Hauteur du graphique en points.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 une taille par défaut et des lignes et colonnes réparties de manière uniforme.

Paramètres

Nom	Type	Description
numRows	Integer	Nombre de lignes dans la table.
numColumns	Integer	Nombre de colonnes dans la table.

Renvois

Table : tableau inséré.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 un tableau sur la page avec la position et la taille fournies.

Les lignes et les colonnes sont réparties de manière uniforme dans le tableau créé.

Paramètres

Nom	Type	Description
numRows	Integer	Nombre de lignes dans la table.
numColumns	Integer	Nombre de colonnes dans la table.
left	Number	Position horizontale du tableau, mesurée à partir de l'angle supérieur gauche de la page.
top	Number	Position verticale du tableau, mesurée à partir de l'angle supérieur gauche de la page.
width	Number	Largeur de la table.
height	Number	Hauteur minimale de la table. La hauteur réelle du tableau affiché dépend de facteurs tels que la taille de la police de texte.

Renvois

Table : tableau inséré.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 du Table fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source 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 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 de mise en page sont copiées sur l'élément à partir de la présentation source.

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

Paramètres

Nom	Type	Description
table	Table	Tableau à copier et à insérer.

Renvois

Table : tableau inséré.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 forme de la zone de texte est insérée avec une taille par défaut en haut à gauche de la page.

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

Paramètres

Nom	Type	Description
text	String	Chaîne que la forme de la zone de texte doit contenir.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox(
    'Hello', 0, 0, 10, 10);  // Also available for Layout, Master, and Page.

Paramètres

Nom	Type	Description
text	String	Chaîne que la forme de la zone de texte doit contenir.
left	Number	Position horizontale de la forme de la zone de texte, mesurée à partir de l'angle supérieur gauche de la page.
top	Number	Position verticale de la forme de la zone de texte, mesurée à partir de l'angle supérieur gauche de la page.
width	Number	Largeur de la forme de la zone de texte.
height	Number	Hauteur 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 avec 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 compatibles.

Paramètres

Nom	Type	Description
videoUrl	String	URL 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 avec 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 compatibles.

Paramètres

Nom	Type	Description
videoUrl	String	URL de la vidéo à insérer.
left	Number	Position horizontale de la vidéo en points, mesurée à partir de l'angle supérieur gauche de la page.
top	Number	Position verticale de la vidéo en points, mesurée à partir de l'angle supérieur gauche de la page.
width	Number	Largeur de la vidéo en points.
height	Number	Hauteur 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 avec 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 du Video fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source 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 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 de mise en page sont copiées sur l'élément à partir de la présentation source.

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

Paramètres

Nom	Type	Description
video	Video	Vidéo à copier et à insérer.

Renvois

Video : vidéo insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 du WordArt fourni sur la page.

La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source 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 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 de mise en page sont copiées sur l'élément à partir de la présentation source.

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

Paramètres

Nom	Type	Description
wordArt	WordArt	Groupe à copier et à insérer.

Renvois

WordArt : texte Word Art inséré.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 avec 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 du texte correspondant au texte à rechercher par le texte de remplacement. La recherche n'est pas sensible à la casse.

Paramètres

Nom	Type	Description
findText	String	Texte à rechercher.
replaceText	String	Texte à remplacer par le texte correspondant.

Renvois

Integer : nombre d'occurrences modifiées

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 du texte correspondant au texte à rechercher par le texte de remplacement.

Paramètres

Nom	Type	Description
findText	String	Texte à rechercher.
replaceText	String	Texte à remplacer par le texte correspondant.
matchCase	Boolean	Si la valeur est true, la recherche est sensible à la casse. Si la valeur est false, la recherche n'est pas sensible à la casse.

Renvois

Integer : nombre d'occurrences modifiées

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 de la présentation active comme 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 uniquement si le script est lié à la présentation.

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

Autorisation

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

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