Masque dans une présentation.
Les maîtres contiennent tous les éléments de page courants et les propriétés communes d'un ensemble de mises en page. Ils servent à trois fins:
- Les formes d'espace réservé d'un modèle contiennent les styles de texte et les propriétés de forme par défaut de toutes les formes d'espace réservé des pages qui utilisent ce modèle.
- Les propriétés d'une page maître définissent les propriétés de page communes héritées par ses mises en page.
- Toutes les autres formes de la diapositive maître apparaissent sur toutes les diapositives qui utilisent cette diapositive maître, quelle que soit leur mise en page.
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
get | Page | Récupère l'arrière-plan de la page. |
get | Color | Récupère le Color associé à la page. |
get | Group[] | Affiche la liste des objets Group sur la page. |
get | Image[] | Affiche la liste des objets Image sur la page. |
get | Layout[] | Récupère les mises en page de ce masque. |
get | Line[] | Affiche la liste des objets Line sur la page. |
get | String | Récupère l'ID unique de la page. |
get | Page | Renvoie la Page de la page dont l'ID est indiqué, ou null si aucune n'existe. |
get | Page | Renvoie la liste des objets Page affichés sur la page. |
get | Page | Récupère le type de la page. |
get | Page | Renvoie l'objet Page d'espace réservé pour un Placeholder ou null spécifié si aucun espace réservé correspondant n'est présent. |
get | Page | Renvoie l'objet Page d'espace réservé pour un Placeholder spécifié et un indice d'espace réservé, ou null si l'espace réservé n'est pas présent. |
get | Page | Renvoie la liste des objets Page d'espace réservé de la page. |
get | Shape[] | Affiche la liste des objets Shape sur la page. |
get | Sheets | Affiche la liste des objets Sheets sur la page. |
get | Table[] | Affiche la liste des objets Table sur la page. |
get | Video[] | Affiche la liste des objets Video sur la page. |
get | Word | Affiche la liste des objets Word sur la page. |
group(pageElements) | Group | Regroupe tous les éléments de page spécifiés. |
insert | Group | Insère une copie du Group fourni sur la page. |
insert | Image | Insère une image en haut à gauche de la page avec une taille par défaut à partir du blob d'image spécifié. |
insert | Image | Insère une image sur la page avec la position et la taille fournies à partir du blob d'image spécifié. |
insert | Image | Insère une copie du Image fourni sur la page. |
insert | Image | Insère une image en haut à gauche de la page, à partir de l'URL fournie, avec une taille par défaut. |
insert | Image | Insère une image sur la page à la position et à la taille indiquées à partir de l'URL fournie. |
insert | Line | Insère une copie du Line fourni sur la page. |
insert | Line | Insère une ligne sur la page reliant deux connection sites . |
insert | Line | Insère une ligne sur la page. |
insert | Page | Insère une copie du Page fourni sur la page. |
insert | Shape | Insère une copie du Shape fourni sur la page. |
insert | Shape | Insère une forme sur la page. |
insert | Shape | Insère une forme sur la page. |
insert | Sheets | Insère un graphique Google Sheets sur la page. |
insert | Sheets | Insère un graphique Google Sheets sur la page avec la position et la taille fournies. |
insert | Sheets | Insère une copie du Sheets fourni sur la page. |
insert | Image | Insère un graphique Google Sheets en tant que Image sur la page. |
insert | Image | Insère un graphique Google Sheets en tant que Image sur la page avec la position et la taille fournies. |
insert | Table | Insère un tableau sur la page. |
insert | Table | Insère un tableau sur la page avec la position et la taille fournies. |
insert | Table | Insère une copie du Table fourni sur la page. |
insert | Shape | Insère une zone de texte Shape contenant la chaîne fournie sur la page. |
insert | Shape | Insère une zone de texte Shape contenant la chaîne fournie sur la page. |
insert | Video | Insère une vidéo dans l'angle supérieur gauche de la page, avec une taille par défaut. |
insert | Video | Insère une vidéo sur la page avec la position et la taille fournies. |
insert | Video | Insère une copie du Video fourni sur la page. |
insert | Word | Insère une copie du Word fourni sur la page. |
remove() | void | Supprime la page. |
replace | Integer | Remplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement. |
replace | Integer | Remplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement. |
select | void | Sélectionne le Page de la présentation active comme current page selection et supprime toute sélection précédente. |
Documentation détaillée
get Background()
Récupère l'arrière-plan de la page.
Renvois
Page
: arrière-plan de la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Color Scheme()
Récupère le Color
associé à la page.
Renvois
Color
: jeu de couleurs de la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Groups()
Affiche la liste des objets Group
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Images()
Affiche la liste des objets Image
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Layouts()
Récupère les mises en page de ce masque.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Lines()
Affiche la liste des objets Line
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Object Id()
Récupère l'ID unique de la page. Les ID d'objet utilisés par les pages et les éléments de page partagent le même espace de noms.
Renvois
String
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Element By Id(id)
Renvoie la Page
de la page dont l'ID est indiqué, ou null
si aucune n'existe.
Paramètres
Nom | Type | Description |
---|---|---|
id | String | ID de l'élément de page récupéré. |
Renvois
Page
: élément de page dont l'ID est indiqué.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Elements()
Renvoie la liste des objets Page
affichés sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Type()
Récupère le type de la page.
Renvois
Page
: type de page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder(placeholderType)
Renvoie l'objet Page
d'espace réservé pour un Placeholder
ou null
spécifié si aucun espace réservé correspondant n'est présent.
Si plusieurs espaces réservés du même type existent, celui renvoyé est celui dont l'index est le plus faible. Si plusieurs espaces réservés correspondants ont le même indice, la fonction renvoie le premier espace réservé de la collection d'éléments de la page.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, );
Paramètres
Nom | Type | Description |
---|---|---|
placeholder | Placeholder |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder(placeholderType, placeholderIndex)
Renvoie l'objet Page
d'espace réservé pour un Placeholder
spécifié et un indice d'espace réservé, ou null
si l'espace réservé n'est pas présent.
Si plusieurs espaces réservés ont le même type et le même index, la fonction renvoie le premier espace réservé de la collection d'éléments de la page.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, 0, );
Paramètres
Nom | Type | Description |
---|---|---|
placeholder | Placeholder | |
placeholder | Integer |
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholders()
Renvoie la liste des objets Page
d'espace réservé de la page.
const master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log( `Number of placeholders in the master: ${master.getPlaceholders().length}`, );
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Shapes()
Affiche la liste des objets Shape
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Sheets Charts()
Affiche la liste des objets Sheets
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Tables()
Affiche la liste des objets Table
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Videos()
Affiche la liste des objets Video
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Word Arts()
Affiche la liste des objets Word
sur la page.
Renvois
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
group(pageElements)
Regroupe tous les éléments de page spécifiés.
La page doit comporter au moins deux éléments qui ne font pas déjà partie d'un autre groupe. Certains éléments de page, tels que Videos
, Tables
et placeholder Shapes
, ne peuvent pas être regroupés.
Paramètres
Nom | Type | Description |
---|---|---|
page | Page | Éléments à regrouper. |
Renvois
Group
: nouveau groupe.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Group(group)
Insère une copie du Group
fourni sur la page.
La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.
// Copy a group between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const group = otherPresentationSlide.getGroups()[0]; currentPresentationSlide.insertGroup( group); // Also available for Layout, Master, and Page.
Paramètres
Nom | Type | Description |
---|---|---|
group | Group | Groupe à copier et à insérer. |
Renvois
Group
: groupe inséré.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(blobSource)
Insère une image en haut à gauche de la page avec une taille par défaut à partir du blob d'image spécifié.
L'insertion de l'image la récupère une fois à partir de Blob
, et une copie est stockée pour l'affichage dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); slide.insertImage(image);
Paramètres
Nom | Type | Description |
---|---|---|
blob | Blob | Données d'image. |
Renvois
Image
: image insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(blobSource, left, top, width, height)
Insère une image sur la page avec la position et la taille fournies à partir du blob d'image spécifié.
L'image est extraite de l'Blob
fournie une fois au moment de l'insertion, et une copie est stockée pour être affichée dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.
Pour conserver le format de l'image, celle-ci est redimensionnée et centrée par rapport à la taille fournie.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. const image = DriveApp.getFileById('123abc'); const position = { left: 0, top: 0 }; const size = { width: 300, height: 100 }; slide.insertImage(image, position.left, position.top, size.width, size.height);
Paramètres
Nom | Type | Description |
---|---|---|
blob | Blob | Données d'image. |
left | Number | Position horizontale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur de l'image en points. |
height | Number | Hauteur de l'image en points. |
Renvois
Image
: image insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(image)
Insère une copie du Image
fourni sur la page.
La position des images insérées sur cette page est déterminée à partir de la position de l'image source sur sa page respective.
Si l'image fournie est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'image insérée.
Si l'image fournie est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'image à partir de la présentation source. Si l'image d'espace réservé copiée est vide, rien n'est inséré dans la présentation de destination.
// Copy an image between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const image = otherPresentationSlide.getImages[0]; currentPresentationSlide.insertImage(image);
Paramètres
Nom | Type | Description |
---|---|---|
image | Image | Image à copier et à insérer. |
Renvois
Image
: image insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(imageUrl)
Insère une image en haut à gauche de la page, à partir de l'URL fournie, avec une taille par défaut.
Lorsque vous insérez l'image, elle est récupérée à partir de l'URL une seule fois, et une copie est stockée pour être affichée dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.
L'URL fournie doit être accessible au public et ne pas dépasser 2 ko. L'URL elle-même est enregistrée avec l'image et exposée via Image.getSourceUrl()
.
Paramètres
Nom | Type | Description |
---|---|---|
image | String | URL de l'image. |
Renvois
Image
: image insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(imageUrl, left, top, width, height)
Insère une image sur la page à la position et à la taille indiquées à partir de l'URL fournie.
Lorsque vous insérez l'image, elle est récupérée à partir de l'URL une seule fois, et une copie est stockée pour être affichée dans la présentation. Les images doivent être inférieures à 50 Mo, ne pas dépasser 25 mégapixels et être au format PNG, JPEG ou GIF.
L'URL fournie doit être accessible au public et ne pas dépasser 2 ko. L'URL elle-même est enregistrée avec l'image et exposée via Image.getSourceUrl()
.
Pour conserver le format de l'image, celle-ci est redimensionnée et centrée par rapport à la taille fournie.
Paramètres
Nom | Type | Description |
---|---|---|
image | String | URL de l'image. |
left | Number | Position horizontale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur de l'image en points. |
height | Number | Hauteur de l'image en points. |
Renvois
Image
: image insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(line)
Insère une copie du Line
fourni sur la page.
La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.
// Copy a line between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const line = otherPresentationSlide.getLines[0]; currentPresentationSlide.insertLine(line);
Paramètres
Nom | Type | Description |
---|---|---|
line | Line | Ligne à copier et à insérer. |
Renvois
Line
: ligne insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(lineCategory, startConnectionSite, endConnectionSite)
Insère une ligne sur la page reliant deux connection sites
. Les deux sites de connexion doivent figurer sur cette page.
// Insert a line in the first slide of the presentation connecting two shapes. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1], );
Paramètres
Nom | Type | Description |
---|---|---|
line | Line | Catégorie de la ligne à insérer. |
start | Connection | Site de connexion où le début de la ligne doit être connecté. |
end | Connection | Site de connexion où l'extrémité de la ligne doit être connectée. |
Renvois
Line
: ligne insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(lineCategory, startLeft, startTop, endLeft, endTop)
Insère une ligne sur la page.
// Insert a line in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const startPoint = { left: 10, top: 10 }; const endPoint = { left: 40, top: 40 }; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top, );
Paramètres
Nom | Type | Description |
---|---|---|
line | Line | Catégorie de la ligne à insérer. |
start | 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. |
start | 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. |
end | Number | Position horizontale du point final de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page. |
end | Number | Position verticale du point d'arrivée de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page. |
Renvois
Line
: ligne insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Page Element(pageElement)
Insère une copie du Page
fourni sur la page.
La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.
// Copy a page element between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
Paramètres
Nom | Type | Description |
---|---|---|
page | Page | Élément de page à copier et à insérer. |
Renvois
Page
: élément de page inséré.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shape)
Insère une copie du Shape
fourni sur la page.
La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.
// Copy a shape between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const shape = otherPresentationSlide.getShapes[0]; currentPresentationSlide.insertShape( shape); // Also available for Layout, Master, and Page.
Paramètres
Nom | Type | Description |
---|---|---|
shape | Shape | Forme à copier et à insérer. |
Renvois
Shape
: forme insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shapeType)
Insère une forme sur la page.
La forme est insérée avec une taille par défaut en haut à gauche de la page.
// Insert a shape in the first slide of the presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
Paramètres
Nom | Type | Description |
---|---|---|
shape | Shape | Type de forme à insérer. |
Renvois
Shape
: forme insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shapeType, left, top, width, height)
Insère une forme sur la page.
Paramètres
Nom | Type | Description |
---|---|---|
shape | Shape | Type de forme à insérer. |
left | Number | Position horizontale de la forme, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale de la forme, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur de la forme. |
height | Number | Hauteur de la forme. |
Renvois
Shape
: forme insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sourceChart)
Insère un graphique Google Sheets sur la page.
Le graphique est inséré dans la taille par défaut en haut à gauche de la page.
Le graphique inséré est associé au graphique Google Sheets source, ce qui permet de le mettre à jour. Les autres collaborateurs voient le lien vers la feuille de calcul source.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
Paramètres
Nom | Type | Description |
---|---|---|
source | Embedded | Graphique d'une feuille de calcul à insérer dans la page. |
Renvois
Sheets
: graphique inséré sur la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sourceChart, left, top, width, height)
Insère un graphique Google Sheets sur la page avec la position et la taille fournies.
Pour conserver le format du graphique, celui-ci est mis à l'échelle et centré par rapport à la taille fournie.
Le graphique inséré est associé au graphique Google Sheets source, ce qui permet de le mettre à jour. Les autres collaborateurs voient le lien vers la feuille de calcul source.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const size = { width: 200, height: 200 }; // Also available for Layout, Master, and Page. slide.insertSheetsChart( chart, position.left, position.top, size.width, size.height, );
Paramètres
Nom | Type | Description |
---|---|---|
source | Embedded | Graphique d'une feuille de calcul à insérer dans la page. |
left | Number | Position horizontale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur du graphique en points. |
height | Number | Hauteur du graphique en points. |
Renvois
Sheets
: graphique inséré sur la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sheetsChart)
Insère une copie du Sheets
fourni sur la page.
La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.
// Copy a sheets chart between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
Paramètres
Nom | Type | Description |
---|---|---|
sheets | Sheets | Graphique Sheets à copier et à insérer. |
Renvois
Sheets
: graphique Sheets inséré.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart As Image(sourceChart)
Insère un graphique Google Sheets en tant que Image
sur la page.
L'image du graphique est insérée dans une taille par défaut en haut à gauche de la page.
L'image du graphique insérée n'est pas associée au graphique Google Sheets source.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage( chart); // Also available for Layout, Master, and Page.
Paramètres
Nom | Type | Description |
---|---|---|
source | Embedded | Graphique d'une feuille de calcul à insérer dans la page. |
Renvois
Image
: image insérée du graphique sur la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart As Image(sourceChart, left, top, width, height)
Insère un graphique Google Sheets en tant que Image
sur la page avec la position et la taille fournies.
Pour conserver le format de l'image du graphique, l'image est redimensionnée et centrée par rapport à la taille fournie.
L'image du graphique insérée n'est pas associée au graphique Google Sheets source.
const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; const chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. const slide = SlidesApp.getActivePresentation().getSlides()[0]; const position = { left: 0, top: 0 }; const size = { width: 200, height: 200 }; // Also available for Layout, Master, and Page. slide.insertSheetsChartAsImage( chart, position.left, position.right, size.width, size.height, );
Paramètres
Nom | Type | Description |
---|---|---|
source | Embedded | Graphique d'une feuille de calcul à insérer dans la page. |
left | Number | Position horizontale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur du graphique en points. |
height | Number | Hauteur du graphique en points. |
Renvois
Image
: image insérée du graphique sur la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(numRows, numColumns)
Insère un tableau sur la page.
Le tableau est centré sur la page, avec une taille par défaut et des lignes et colonnes réparties de manière uniforme.
Paramètres
Nom | Type | Description |
---|---|---|
num | Integer | Nombre de lignes dans la table. |
num | Integer | Nombre de colonnes dans la table. |
Renvois
Table
: tableau inséré.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(numRows, numColumns, left, top, width, height)
Insère un tableau sur la page avec la position et la taille fournies.
Les lignes et les colonnes sont réparties de manière uniforme dans le tableau créé.
Paramètres
Nom | Type | Description |
---|---|---|
num | Integer | Nombre de lignes dans la table. |
num | Integer | Nombre de colonnes dans la table. |
left | Number | Position horizontale du tableau, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale du tableau, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur de la table. |
height | Number | Hauteur minimale de la table. La hauteur réelle du tableau affiché dépend de facteurs tels que la taille de la police de texte. |
Renvois
Table
: tableau inséré.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(table)
Insère une copie du Table
fourni sur la page.
La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.
// Copy a table between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const table = otherPresentationSlide.getTables[0]; currentPresentationSlide.insertTable( table); // Also available for Layout, Master, and Page.
Paramètres
Nom | Type | Description |
---|---|---|
table | Table | Tableau à copier et à insérer. |
Renvois
Table
: tableau inséré.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Text Box(text)
Insère une zone de texte Shape
contenant la chaîne fournie sur la page.
La forme de la zone de texte est insérée avec une taille par défaut en haut à gauche de la page.
// Insert text box with "Hello" on the first slide of presentation. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Chaîne que la forme de la zone de texte doit contenir. |
Renvois
Shape
: forme de la zone de texte insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Text Box(text, left, top, width, height)
Insère une zone de texte Shape
contenant la chaîne fournie sur la page.
// Insert text box with "Hello" on the first slide of presentation. This text // box is a square with a length of 10 points on each side. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox( 'Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Chaîne que la forme de la zone de texte doit contenir. |
left | Number | Position horizontale de la forme de la zone de texte, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale de la forme de la zone de texte, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur de la forme de la zone de texte. |
height | Number | Hauteur de la forme de la zone de texte. |
Renvois
Shape
: forme de la zone de texte insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Video(videoUrl)
Insère une vidéo dans l'angle supérieur gauche de la page, avec une taille par défaut.
Seules les vidéos YouTube sont actuellement compatibles.
Paramètres
Nom | Type | Description |
---|---|---|
video | String | URL de la vidéo à insérer. |
Renvois
Video
: vidéo insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Video(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 |
---|---|---|
video | String | URL de la vidéo à insérer. |
left | Number | Position horizontale de la vidéo en points, mesurée à partir de l'angle supérieur gauche de la page. |
top | Number | Position verticale de la vidéo en points, mesurée à partir de l'angle supérieur gauche de la page. |
width | Number | Largeur de la vidéo en points. |
height | Number | Hauteur de la vidéo en points. |
Renvois
Video
: vidéo insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Video(video)
Insère une copie du Video
fourni sur la page.
La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.
// Copy a video between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const video = otherPresentationSlide.getVideos[0]; currentPresentationSlide.insertVideo( video); // Also available for Layout, Master, and Page.
Paramètres
Nom | Type | Description |
---|---|---|
video | Video | Vidéo à copier et à insérer. |
Renvois
Video
: vidéo insérée.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Word Art(wordArt)
Insère une copie du Word
fourni sur la page.
La position de l'élément inséré sur cette page est déterminée à partir de la position de l'élément source sur sa page respective.
Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.
Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.
// Copy a word art between presentations. const otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; const currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; const wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
Paramètres
Nom | Type | Description |
---|---|---|
word | Word | Groupe à copier et à insérer. |
Renvois
Word
: texte Word Art inséré.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Supprime la page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText)
Remplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement. La recherche n'est pas sensible à la casse.
Paramètres
Nom | Type | Description |
---|---|---|
find | String | Texte à rechercher. |
replace | String | Texte à remplacer par le texte correspondant. |
Renvois
Integer
: nombre d'occurrences modifiées
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText, matchCase)
Remplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement.
Paramètres
Nom | Type | Description |
---|---|---|
find | String | Texte à rechercher. |
replace | String | Texte à remplacer par le texte correspondant. |
match | Boolean | Si la valeur est true , la recherche est sensible à la casse. Si la valeur est false , la recherche n'est pas sensible à la casse. |
Renvois
Integer
: nombre d'occurrences modifiées
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select As Current Page()
Sélectionne le Page
de la présentation active comme current page selection
et supprime toute sélection précédente.
Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et uniquement si le script est lié à la présentation.
// Select the first slide as the current page selection and replace any previous // selection. const slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations