Page d'une présentation.
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
asLayout() | Layout | Renvoie la page sous forme de mise en page. |
asMaster() | Master | Renvoie la page en tant que page maître. |
asSlide() | Slide | Renvoie la page sous forme de diapositive. |
getBackground() | PageBackground | Récupère l'arrière-plan de la page. |
getColorScheme() | ColorScheme | Récupère l'ColorScheme associé à la page. |
getGroups() | Group[] | Renvoie la liste des objets Group sur la page. |
getImages() | Image[] | Renvoie la liste des objets Image sur la page. |
getLines() | Line[] | Renvoie la liste des objets Line sur la page. |
getObjectId() | String | Récupère l'identifiant unique de la page. |
getPageElementById(id) | PageElement | Renvoie le PageElement sur la page correspondant à l'ID donné ou null s'il n'en existe aucun. |
getPageElements() | PageElement[] | Renvoie la liste des objets PageElement affichés sur la page. |
getPageType() | PageType | Récupère le type de page. |
getPlaceholder(placeholderType) | PageElement | Renvoie l'objet d'espace réservé PageElement pour un PlaceholderType ou un null spécifié si aucun espace réservé correspondant n'est présent. |
getPlaceholder(placeholderType, placeholderIndex) | PageElement | 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. |
getPlaceholders() | PageElement[] | Renvoie la liste des objets PageElement réservés sur la page. |
getShapes() | Shape[] | Renvoie la liste des objets Shape sur la page. |
getSheetsCharts() | SheetsChart[] | Renvoie la liste des objets SheetsChart sur la page. |
getTables() | Table[] | Renvoie la liste des objets Table sur la page. |
getVideos() | Video[] | Renvoie la liste des objets Video sur la page. |
getWordArts() | WordArt[] | Renvoie 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 issue 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 par l'objet 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, avec une taille par défaut issue de l'URL fournie. |
insertImage(imageUrl, left, top, width, height) | Image | Insère sur la page une image avec la position et la taille fournies à 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 reliant deux connection sites sur la page. |
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 avec une taille par défaut en haut à gauche de la page. |
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 de texte correspondant au texte recherché par le texte de remplacement. |
replaceAllText(findText, replaceText, matchCase) | Integer | Remplace toutes les occurrences de texte correspondant au texte recherché par le texte de remplacement. |
selectAsCurrentPage() | void | Sélectionne l'élément Page de 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 sous forme de mise en page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 page maître.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
asSlide()
Renvoie 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 associée à 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 associée à 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 l'ColorScheme
associé à la page.
Renvois
ColorScheme
: jeu de couleurs de la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getGroups()
Renvoie la liste des objets Group
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getImages()
Renvoie la liste des objets Image
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLines()
Renvoie la liste des objets Line
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 le même espace de noms.
Renvois
String
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementById(id)
Renvoie le PageElement
sur la page correspondant à l'ID donné ou null
s'il n'en existe aucun.
Paramètres
Nom | Type | Description |
---|---|---|
id | String | ID de l'élément de page en cours de récupération. |
Renvois
PageElement
: élément de page avec l'ID donné.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 associée à 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 un PlaceholderType
ou un null
spécifié si aucun espace réservé correspondant n'est présent.
S'il existe plusieurs espaces réservés du même type, celui-ci est renvoyé avec l'indice d'espace réservé minimal. S'il existe plusieurs espaces réservés correspondants avec le même index, le premier espace réservé de la collection d'éléments de page de la page est renvoyé.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
Paramètres
Nom | Type | Description |
---|---|---|
placeholderType | PlaceholderType |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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, le premier espace réservé de la collection d'éléments de page de la page est renvoyé.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);
Paramètres
Nom | Type | Description |
---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
réservés sur la page.
var master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getShapes()
Renvoie la liste des objets Shape
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSheetsCharts()
Renvoie la liste des objets SheetsChart
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTables()
Renvoie la liste des objets Table
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getVideos()
Renvoie la liste des objets Video
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWordArts()
Renvoie la liste des objets WordArt
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 même page doit contenir 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 associée à 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é depuis 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 depuis la présentation source.
// 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
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 associée à 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 issue du blob d'image spécifié.
L'insertion de l'image l'extrait une fois à partir de BlobSource
et une copie est stockée pour être affichée dans la présentation. Les images doivent être inférieures à 50 Mo, ne doivent pas dépasser 25 mégapixels et ê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
Nom | Type | Description |
---|---|---|
blobSource | BlobSource | Données de l'image. |
Renvois
Image
: image insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 du BlobSource
fourni une seule fois au moment de l'insertion, et une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo, ne peuvent pas dépasser 25 mégapixels et doivent être au format PNG, JPEG ou GIF.
Afin de conserver ses proportions, l'image est mise à l'échelle et centrée par rapport à la taille fournie.
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
Nom | Type | Description |
---|---|---|
blobSource | BlobSource | Données 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 associée à 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 la page correspondante.
Si l'image fournie est un espace réservé copié depuis 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 la destination.
// 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
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 associée à 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, avec une taille par défaut issue de l'URL fournie.
Lorsque vous insérez l'image, elle est récupérée une fois à partir de l'URL et 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 être au format PNG, JPEG ou GIF.
L'URL fournie doit être accessible au public 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
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 associée à 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 sur la page une image avec la position et la taille fournies à partir de l'URL fournie.
Lorsque vous insérez l'image, elle est récupérée une fois à partir de l'URL et 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 être au format PNG, JPEG ou GIF.
L'URL fournie doit être accessible au public 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 à 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 associée à 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é depuis 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 depuis la présentation source.
// 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
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 associée à 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 reliant deux connection sites
sur la page. Les deux sites de connexion doivent se trouver 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
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 associée à 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
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 d'arrivée 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 associée à 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é depuis 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 depuis la présentation source.
// 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
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 associée à 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é depuis 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 depuis la présentation source.
// 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
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 associée à 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
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 associée à 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 associée à 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 associé au graphique Google Sheets source, ce qui permet de le mettre à 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
Nom | Type | Description |
---|---|---|
sourceChart | EmbeddedChart | Graphique d'une feuille de calcul à insérer sur la page. |
Renvois
SheetsChart
: graphique inséré sur la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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.
Afin de conserver ses proportions, le graphique 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 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
Nom | Type | Description |
---|---|---|
sourceChart | EmbeddedChart | Graphique d'une feuille de calcul à insérer sur 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 associée à 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é depuis 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 depuis la présentation source.
// 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
Nom | Type | Description |
---|---|---|
sheetsChart | SheetsChart | Copier et insérer le graphique en feuilles. |
Renvois
SheetsChart
: graphique des feuilles inséré.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 avec une taille par défaut dans l'angle supérieur gauche de la page.
L'image du graphique insérée n'est pas liée au graphique source Google Sheets.
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
Nom | Type | Description |
---|---|---|
sourceChart | EmbeddedChart | Graphique d'une feuille de calcul à insérer sur 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 associée à 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.
Afin de conserver ses proportions, l'image est mise à l'échelle et centrée par rapport à la taille fournie.
L'image du graphique insérée n'est pas liée au graphique source Google Sheets.
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
Nom | Type | Description |
---|---|---|
sourceChart | EmbeddedChart | Graphique d'une feuille de calcul à insérer sur 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 associée à 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 la taille par défaut et des lignes et colonnes réparties uniformément.
Paramètres
Nom | Type | Description |
---|---|---|
numRows | Integer | Nombre de lignes dans la table. |
numColumns | Integer | Nombre de colonnes dans le tableau. |
Renvois
Table
: table insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 uniformément dans la table créée.
Paramètres
Nom | Type | Description |
---|---|---|
numRows | Integer | Nombre de lignes dans la table. |
numColumns | Integer | Nombre de colonnes dans le tableau. |
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 du tableau. |
height | Number | Hauteur minimale du tableau. La hauteur réelle du tableau affiché dépend de 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 associée à 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é depuis 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 depuis la présentation source.
// 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
Nom | Type | Description |
---|---|---|
table | Table | Tableau à copier et à insérer. |
Renvois
Table
: table insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 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
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 associée à 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
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 associée à 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 avec une taille par défaut en haut à gauche de la page.
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 associée à 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 associée à 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é depuis 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 depuis la présentation source.
// 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
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 associée à 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é depuis 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 depuis la présentation source.
// 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
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 associée à 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 associée à 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 recherché 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 pour remplacer le texte correspondant. |
Renvois
Integer
: le nombre d'occurrences a changé.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 recherché par le texte de remplacement.
Paramètres
Nom | Type | Description |
---|---|---|
findText | String | Texte à rechercher. |
replaceText | String | Texte pour remplacer 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
: le nombre d'occurrences a changé.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
selectAsCurrentPage()
Sélectionne l'élément Page
de 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 uniquement s'il 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 associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations