Une 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 | Affiche la page sous forme de diapositive. |
getBackground() | PageBackground | Récupère l'arrière-plan de la page. |
getColorScheme() | ColorScheme | Récupère les ColorScheme associés à la page. |
getGroups() | Group[] | Affiche la liste des objets Group sur la page. |
getImages() | Image[] | Affiche la liste des objets Image sur la page. |
getLines() | Line[] | Affiche la liste des objets Line sur la page. |
getObjectId() | String | Récupère l'identifiant unique de la page. |
getPageElementById(id) | PageElement | Affiche le PageElement sur la page avec l'ID donné ou null s'il n'en existe aucun. |
getPageElements() | PageElement[] | Affiche la liste des objets PageElement affichés sur la page. |
getPageType() | PageType | Récupère le type de page. |
getPlaceholder(placeholderType) | PageElement | Renvoie l'objet d'espace réservé PageElement pour une valeur PlaceholderType spécifiée ou
null si aucun espace réservé correspondant n'est présent. |
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[] | Affiche la liste des objets PageElement réservés sur la page. |
getShapes() | Shape[] | Affiche la liste des objets Shape sur la page. |
getSheetsCharts() | SheetsChart[] | Affiche la liste des objets SheetsChart sur la page. |
getTables() | Table[] | Affiche la liste des objets Table sur la page. |
getVideos() | Video[] | Affiche la liste des objets Video sur la page. |
getWordArts() | WordArt[] | Affiche la liste des objets WordArt sur la page. |
group(pageElements) | Group | Regroupe tous les éléments de page spécifiés. |
insertGroup(group) | Group | Insère une copie de la propriété Group fournie sur la page. |
insertImage(blobSource) | Image | Insère dans l'angle supérieur gauche de la page une image dont la taille par défaut correspond à celle blob d'image. |
insertImage(blobSource, left, top, width, height) | 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 de la propriété Image fournie sur la page. |
insertImage(imageUrl) | Image | Insère dans l'angle supérieur gauche de la page une image dont la taille correspond par défaut à celle de l'URL fournie. |
insertImage(imageUrl, left, top, width, height) | Image | Insère une image sur la page avec la position et la taille fournies à partir de l'URL fournie. |
insertLine(line) | Line | Insère une copie de la propriété Line fournie 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 de la propriété PageElement fournie sur la page. |
insertShape(shape) | Shape | Insère une copie de la propriété Shape fournie 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 sur la page un graphique Google Sheets avec la position et la taille fournies. |
insertSheetsChart(sheetsChart) | SheetsChart | Insère une copie de la propriété SheetsChart fournie sur la page. |
insertSheetsChartAsImage(sourceChart) | Image | Insère un graphique Google Sheets sur la page en tant que Image . |
insertSheetsChartAsImage(sourceChart, left, top, width, height) | Image | Insère un graphique Google Sheets sous forme de Image sur la page, avec la position indiquée et
la taille de l'image. |
insertTable(numRows, numColumns) | Table | Insère un tableau sur la page. |
insertTable(numRows, numColumns, left, top, width, height) | Table | Insère sur la page un tableau avec la position et la taille fournies. |
insertTable(table) | Table | Insère une copie de la propriété Table fournie 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 de la propriété Video fournie sur la page. |
insertWordArt(wordArt) | WordArt | Insère une copie de la propriété WordArt fournie sur la page. |
remove() | void | Supprime la page. |
replaceAllText(findText, replaceText) | Integer | Remplace toutes les occurrences de texte correspondant au texte à rechercher par le texte de remplacement. |
replaceAllText(findText, replaceText, matchCase) | Integer | Remplace toutes les occurrences de texte correspondant au texte à rechercher par le texte de remplacement. |
selectAsCurrentPage() | void | Sélectionne le Page dans la présentation active en tant que current page selection et supprime toute sélection précédente. |
Documentation détaillée
asLayout()
Renvoie la page sous forme de mise en page.
Renvois
Layout
: page en tant que mise en page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
asMaster()
Renvoie la page en tant que page maître.
Renvois
Master
: page en tant que maître.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
asSlide()
Affiche la page sous forme de diapositive.
Renvois
Slide
: page sous forme de diapositive.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getBackground()
Récupère l'arrière-plan de la page.
Renvois
PageBackground
: arrière-plan de la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getColorScheme()
Récupère les ColorScheme
associés à la page.
Renvois
ColorScheme
: jeu de couleurs de la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getGroups()
Affiche la liste des objets Group
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getImages()
Affiche la liste des objets Image
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLines()
Affiche la liste des objets Line
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getObjectId()
Récupère l'identifiant unique de la page. Les ID d'objet utilisés par les pages et les éléments de page partagent les mêmes espace de noms.
Renvois
String
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementById(id)
Affiche le PageElement
sur la page avec l'ID donné ou null
s'il n'en existe aucun.
Paramètres
Nom | Type | Description |
---|---|---|
id | String | ID de l'élément de page en cours de récupération. |
Renvois
PageElement
: élément de page ayant l'ID donné.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElements()
Affiche la liste des objets PageElement
affichés sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageType()
Récupère le type de page.
Renvois
PageType
: type de page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType)
Renvoie l'objet d'espace réservé PageElement
pour une valeur PlaceholderType
spécifiée ou
null
si aucun espace réservé correspondant n'est présent.
S'il existe plusieurs espaces réservés du même type, il renvoie celui avec le minimum index d'espace réservé. S'il existe plusieurs espaces réservés correspondants avec le même index, la méthode renvoie le premier espace réservé de la collection d'éléments de page de la page.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
Paramètres
Nom | Type | Description |
---|---|---|
placeholderType | PlaceholderType |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType, placeholderIndex)
Renvoie l'objet d'espace réservé PageElement
pour un PlaceholderType
spécifié et
un index d'espace réservé, ou null
si l'espace réservé n'est pas présent.
S'il existe plusieurs espaces réservés avec le même type et le même index, la première valeur dans la collection d'éléments de page de la page.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);
Paramètres
Nom | Type | Description |
---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholders()
Affiche la liste des objets PageElement
réservés sur la page.
var master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log('Number of placeholders in the master: ' master.getPlaceholders().length);
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getShapes()
Affiche la liste des objets Shape
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSheetsCharts()
Affiche la liste des objets SheetsChart
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTables()
Affiche la liste des objets Table
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getVideos()
Affiche la liste des objets Video
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWordArts()
Affiche la liste des objets WordArt
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
group(pageElements)
Regroupe tous les éléments de page spécifiés.
Il doit y avoir au moins deux éléments de page sur une même page qui ne se trouvent pas déjà dans une autre
groupe. Certains éléments de page, tels que Videos
, Tables
et placeholder Shapes
, ne peuvent pas être regroupés.
Paramètres
Nom | Type | Description |
---|---|---|
pageElements | PageElement[] | Éléments à regrouper. |
Renvois
Group
: nouveau groupe.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertGroup(group)
Insère une copie de la propriété Group
fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a group between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var group = otherPresentationSlide.getGroups()[0]; currentPresentationSlide.insertGroup(group); // Also available for Layout, Master, and Page.
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource)
Insère dans l'angle supérieur gauche de la page une image dont la taille par défaut correspond à celle blob d'image.
Lorsque vous insérez l'image, elle est récupérée à partir de BlobSource
une seule fois, et une copie est stockée pour
à afficher dans la présentation. La taille des images doit être inférieure à 50 Mo et ne doit pas dépasser 25
et doivent être au format PNG, JPEG ou GIF.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); slide.insertImage(image);
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource, left, top, width, height)
Insère une image sur la page avec la position et la taille fournies par l'objet blob d'image spécifié.
L'image est extraite de l'élément BlobSource
fourni une fois au moment de l'insertion et une copie
est stockée pour être affichée dans la présentation. La taille des images ne doit pas dépasser 50 Mo
dépasse 25 mégapixels et doit être au format PNG, JPEG ou GIF.
Afin de conserver ses proportions, l'image est mise à l'échelle et centrée par rapport au à la taille indiquée.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); var position = {left: 0, top: 0}; var size = {width: 300, height: 100}; slide.insertImage(image, position.left, position.top, size.width, size.height);
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(image)
Insère une copie de la propriété Image
fournie sur la page.
La position des images insérées sur cette page est déterminée à partir de la position de l'image source. sur leur page respective.
Si l'image fournie est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'image insérée.
Si l'image fournie est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées sur l'image à partir de la source. présentation. Si l'image de remplacement copiée est vide, rien n'est inséré dans la destination présentation.
// Copy an image between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var image = otherPresentationSlide.getImages[0]; currentPresentationSlide.insertImage(image);
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl)
Insère dans l'angle supérieur gauche de la page une image dont la taille correspond par défaut à celle de l'URL fournie.
Lorsque l'image est insérée, elle est récupérée à partir de l'URL une fois. Une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo, ne doivent pas dépasser 25 mégapixels et doivent au format PNG, JPEG ou GIF.
L'URL fournie doit être accessible publiquement et ne doit pas dépasser 2 Ko. L'URL elle-même est enregistrée
avec l'image et exposée via Image.getSourceUrl()
.
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl, left, top, width, height)
Insère une image sur la page avec la position et la taille fournies à partir de l'URL fournie.
Lorsque l'image est insérée, elle est récupérée à partir de l'URL une fois. Une copie est stockée pour être affichée dans la présentation. Les images ne doivent pas dépasser 50 Mo, ne doivent pas dépasser 25 mégapixels et doivent au format PNG, JPEG ou GIF.
L'URL fournie doit être accessible publiquement et ne doit pas dépasser 2 Ko. L'URL elle-même est enregistrée
avec l'image et exposée via Image.getSourceUrl()
.
Afin de conserver ses proportions, l'image est mise à l'échelle et centrée par rapport au à la taille indiquée.
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(line)
Insère une copie de la propriété Line
fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a line between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var line = otherPresentationSlide.getLines[0]; currentPresentationSlide.insertLine(line);
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startConnectionSite, endConnectionSite)
Insère une ligne sur la page reliant deux connection sites
. Les deux
sites de connexion doivent figurer sur cette page.
// Insert a line in the first slide of the presentation connecting two shapes. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1]);
Paramètres
Nom | Type | Description |
---|---|---|
lineCategory | LineCategory | Catégorie de la ligne à insérer. |
startConnectionSite | ConnectionSite | Le site de connexion où le début de la ligne doit être connecté. |
endConnectionSite | ConnectionSite | Le site de connexion où l'extrémité de la ligne doit être connectée. |
Renvois
Line
: ligne insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)
Insère une ligne sur la page.
// Insert a line in the first slide of the presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var startPoint = {left: 10, top: 10}; var endPoint = {left: 40, top: 40}; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top);
Paramètres
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 en haut à gauche de la page. |
startTop | Number | Position verticale du point de départ de la ligne, mesurée en points depuis dans le coin supérieur gauche de la page. |
endLeft | Number | La position horizontale du point d'arrivée de la ligne, mesurée en points depuis dans le coin supérieur gauche de la page. |
endTop | Number | Position verticale du point d'arrivée de la ligne, mesurée en points à partir du dans le coin supérieur gauche de la page. |
Renvois
Line
: ligne insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertPageElement(pageElement)
Insère une copie de la propriété PageElement
fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a page element between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shape)
Insère une copie de la propriété Shape
fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a shape between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var shape = otherPresentationSlide.getShapes[0]; currentPresentationSlide.insertShape(shape); // Also available for Layout, Master, and Page.
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType)
Insère une forme sur la page.
La forme est insérée avec une taille par défaut dans l'angle supérieur gauche de la page.
// Insert a shape in the first slide of the presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType, left, top, width, height)
Insère une forme sur la page.
Paramètres
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 du . |
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart)
Insère un graphique Google Sheets sur la page.
Le graphique est inséré avec une taille par défaut dans l'angle supérieur gauche de la page.
Le graphique inséré est lié au graphique Google Sheets source, ce qui lui permet d'être mis à jour. Les autres collaborateurs peuvent voir le lien vers la feuille de calcul source.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
Paramètres
Nom | Type | Description |
---|---|---|
sourceChart | EmbeddedChart | Graphique d'une feuille de calcul à insérer dans la page. |
Renvois
SheetsChart
: graphique inséré dans la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart, left, top, width, height)
Insère sur la page un graphique Google Sheets avec la position et la taille fournies.
Afin de conserver le format, le graphique est mis à l'échelle et centré par rapport à à la taille indiquée.
Le graphique inséré est lié au graphique Google Sheets source, ce qui lui permet d'être mis à jour. Les autres collaborateurs peuvent voir le lien vers la feuille de calcul source.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var position = {left: 0, top: 0}; var size = {width: 200, height: 200}; // Also available for Layout, Master, and Page. slide.insertSheetsChart( chart, position.left, position.top, size.width, size.height);
Paramètres
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 du graphique la page. |
width | Number | Largeur du graphique en points. |
height | Number | Hauteur du graphique en points. |
Renvois
SheetsChart
: graphique inséré dans la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sheetsChart)
Insère une copie de la propriété SheetsChart
fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a sheets chart between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
Paramètres
Nom | Type | Description |
---|---|---|
sheetsChart | SheetsChart | Graphique Sheets à copier et insérer. |
Renvois
SheetsChart
: graphique des feuilles inséré.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart)
Insère un graphique Google Sheets sur la page en tant que Image
.
L'image du graphique est insérée avec une taille par défaut dans l'angle supérieur gauche de la page.
L'image insérée du graphique n'est pas associée au graphique Google Sheets source.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.
Paramètres
Nom | Type | Description |
---|---|---|
sourceChart | EmbeddedChart | Graphique d'une feuille de calcul à insérer dans la page. |
Renvois
Image
: image insérée du graphique dans la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart, left, top, width, height)
Insère un graphique Google Sheets sous forme de Image
sur la page, avec la position indiquée et
la taille de l'image.
Afin de conserver le format de l'image du graphique, l'image est mise à l'échelle et centrée avec par rapport à la taille fournie.
L'image insérée du graphique n'est pas liée au graphique Google Sheets source.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var position = {left: 0, top: 0}; var size = {width: 200, height: 200}; // Also available for Layout, Master, and Page. slide.insertSheetsChartAsImage( chart, position.left, position.right, size.width, size.height);
Paramètres
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 du graphique la page. |
width | Number | Largeur du graphique en points. |
height | Number | Hauteur du graphique en points. |
Renvois
Image
: image insérée du graphique dans la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns)
Insère un tableau sur la page.
Le tableau est centré sur la page avec sa taille par défaut et ses lignes et ses colonnes réparties uniformément.
Paramètres
Nom | Type | Description |
---|---|---|
numRows | Integer | Nombre de lignes dans la table. |
numColumns | Integer | Nombre de colonnes du tableau. |
Renvois
Table
: table insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns, left, top, width, height)
Insère sur la page un tableau avec la position et la taille fournies.
Les lignes et les colonnes sont réparties uniformément dans la table créée.
Paramètres
Nom | Type | Description |
---|---|---|
numRows | Integer | Nombre de lignes dans la table. |
numColumns | Integer | Nombre de colonnes du tableau. |
left | Number | Position horizontale du tableau, mesurée à partir de l'angle supérieur gauche du . |
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 sur des facteurs tels que la taille de la police du texte. |
Renvois
Table
: table insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(table)
Insère une copie de la propriété Table
fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a table between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var table = otherPresentationSlide.getTables[0]; currentPresentationSlide.insertTable(table); // Also available for Layout, Master, and Page.
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTextBox(text)
Insère une zone de texte Shape
contenant la chaîne fournie sur la page.
La zone de texte est insérée avec une taille par défaut dans l'angle supérieur gauche de la page.
// Insert text box with "Hello" on the first slide of presentation. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Chaîne que doit contenir la zone de texte. |
Renvois
Shape
: forme de la zone de texte insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTextBox(text, left, top, width, height)
Insère une zone de texte Shape
contenant la chaîne fournie sur la page.
// Insert text box with "Hello" on the first slide of presentation. This text box is a square // with a length of 10 points on each side. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Chaîne que doit contenir la zone de texte. |
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl)
Insère une vidéo dans l'angle supérieur gauche de la page, avec une taille par défaut.
Seules les vidéos YouTube sont actuellement prises en charge.
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl, left, top, width, height)
Insère une vidéo sur la page avec la position et la taille fournies.
Seules les vidéos YouTube sont actuellement prises en charge.
Paramètres
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, exprimée en points, mesurée à partir de l'angle supérieur gauche 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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(video)
Insère une copie de la propriété Video
fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a video between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var video = otherPresentationSlide.getVideos[0]; currentPresentationSlide.insertVideo(video); // Also available for Layout, Master, and Page.
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertWordArt(wordArt)
Insère une copie de la propriété WordArt
fournie sur la page.
La position de l'élément inséré sur cette page est déterminée par la balise sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, Les propriétés qui héritent des pages maîtres ou des pages de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, Les propriétés qui héritent des pages maîtres ou des pages de mise en page sont copiées dans l'élément à partir de la source. présentation.
// Copy a word art between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
Paramètres
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Supprime la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText)
Remplace toutes les occurrences de texte correspondant au texte à rechercher par le texte de remplacement. La recherche est un cas insensible.
Paramètres
Nom | Type | Description |
---|---|---|
findText | String | Texte à rechercher. |
replaceText | String | Texte de remplacement du texte correspondant. |
Renvois
Integer
: le nombre d'occurrences a changé.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
Remplace toutes les occurrences de texte correspondant au texte à rechercher par le texte de remplacement.
Paramètres
Nom | Type | Description |
---|---|---|
findText | String | Texte à rechercher. |
replaceText | String | Texte de remplacement du texte correspondant. |
matchCase | Boolean | Si la valeur est true , la recherche est sensible à la casse. Si la valeur est false , la recherche est
non sensible à la casse. |
Renvois
Integer
: le nombre d'occurrences a changé.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
selectAsCurrentPage()
Sélectionne le Page
dans la présentation active en tant que current page selection
et supprime toute sélection précédente.
Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et seulement si le script est lié à la présentation.
// Select the first slide as the current page selection and replace any previous selection. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations