Cette page a été traduite par l'API Cloud Translation.

Class Layout

Mise en page d'une présentation.

Chaque mise en page sert de modèle pour les diapositives qui en héritent, en déterminant la manière dont le contenu de ces diapositives est organisé et mis en forme.

Méthodes

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

Documentation détaillée

`getBackground()`

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

Renvois

PageBackground : arrière-plan de la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getColorScheme()`

Récupère le ColorScheme associé à la page.

Renvois

ColorScheme : jeu de couleurs de la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getGroups()`

Renvoie la liste des objets Group sur la page.

Renvois

Group[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getImages()`

Renvoie la liste des objets Image sur la page.

Renvois

Image[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getLayoutName()`

Récupère le nom de la mise en page.

Renvois

String

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getLines()`

Renvoie la liste des objets Line sur la page.

Renvois

Line[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getMaster()`

Récupère le maître sur lequel la mise en page est basée.

Renvois

Master

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getObjectId()`

Obtient 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 scopes suivants :

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

`getPageElementById(id)`

Renvoie le PageElement sur la page avec l'ID donné, ou null si aucun n'existe.

Paramètres

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

Renvois

PageElement|null : élément de page avec l'ID donné.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getPageElements()`

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

Renvois

PageElement[]

Autorisation

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

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

`getPlaceholder(placeholderType)`

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

S'il existe plusieurs espaces réservés du même type, celui dont l'index est le plus petit est renvoyé. S'il existe plusieurs espaces réservés correspondants avec le même index, le premier espace réservé de la collection d'éléments de la page est renvoyé.

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

Paramètres

Nom	Type	Description
`placeholderType`	`PlaceholderType`

Renvois

PageElement|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getPlaceholder(placeholderType, placeholderIndex)`

Renvoie l'objet PageElement d'espace réservé pour un PlaceholderType et un index d'espace réservé spécifiés, 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, il renvoie le premier espace réservé de la collection d'éléments de page.

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

Paramètres

Nom	Type	Description
`placeholderType`	`PlaceholderType`
`placeholderIndex`	`Integer`

Renvois

PageElement|null

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getPlaceholders()`

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

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

Renvois

PageElement[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getShapes()`

Renvoie la liste des objets Shape sur la page.

Renvois

Shape[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getSheetsCharts()`

Renvoie la liste des objets SheetsChart sur la page.

Renvois

SheetsChart[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getTables()`

Renvoie la liste des objets Table sur la page.

Renvois

Table[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getVideos()`

Renvoie la liste des objets Video sur la page.

Renvois

Video[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`getWordArts()`

Renvoie la liste des objets WordArt sur la page.

Renvois

WordArt[]

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 la même page qui ne figurent pas déjà dans un autre groupe. Certains éléments de page, tels que Videos, Tables et placeholder Shapes, ne peuvent pas être groupés.

Paramètres

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

Renvois

Group : le nouveau groupe.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`insertGroup(group)`

Insère une copie de l'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 héritées des pages maîtres ou de mise en page sont également héritées sur 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 héritées 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 scopes suivants :

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

`insertImage(blobSource)`

Insère une image en haut à gauche de la page, avec une taille par défaut, à partir du blob d'image spécifié.

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
slide.insertImage(image);

Paramètres

Nom	Type	Description
`blobSource`	`BlobSource`	Données 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 scopes suivants :

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

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

Insère une image sur la page avec la position et la taille fournies à partir du blob d'image spécifié.

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

Afin de conserver les proportions de l'image, celle-ci est mise à l'échelle et centrée par rapport à la taille fournie.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 300,
  height: 100
};
slide.insertImage(image, position.left, position.top, size.width, size.height);

Paramètres

Nom	Type	Description
`blobSource`	`BlobSource`	Données 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 scopes suivants :

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

`insertImage(image)`

Insère une copie de l'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 héritées des pages maîtres ou de mise en page sont copiées sur l'image à partir de la présentation source. Si l'image de l'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 scopes suivants :

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

`insertImage(imageUrl)`

Insère une image en haut à gauche de la page, avec une taille par défaut, à partir de l'URL fournie.

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

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

Paramètres

Nom	Type	Description
`imageUrl`	`String`	URL de l'image.

Renvois

Image : image insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 indiquée.

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().

Afin de conserver les proportions de l'image, celle-ci est mise à l'échelle et centrée par rapport à la taille fournie.

Paramètres

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

Renvois

Image : image insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`insertLine(line)`

Insère une copie de l'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.

// 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 scopes suivants :

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

`insertLine(lineCategory, startConnectionSite, endConnectionSite)`

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

// Insert a line in the first slide of the presentation connecting two shapes.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1],
);

Paramètres

Nom	Type	Description
`lineCategory`	`LineCategory`	Catégorie de la ligne à insérer.
`startConnectionSite`	`ConnectionSite`	Site de connexion auquel le début de la ligne doit être connecté.
`endConnectionSite`	`ConnectionSite`	Site de connexion où l'extrémité de la ligne doit être connectée.

Renvois

Line : ligne insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

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

Insère une ligne sur la page.

// Insert a line in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const endPoint = {
  left: 40,
  top: 40
};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top,
);

Paramètres

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

Renvois

Line : ligne insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`insertPageElement(pageElement)`

Insère une copie de l'PageElement fourni sur la page.

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

// Copy a page element between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

Paramètres

Nom	Type	Description
`pageElement`	`PageElement`	Élément de page à copier et à insérer.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`insertShape(shape)`

Insère une copie de l'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.

// 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 scopes suivants :

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

`insertShape(shapeType)`

Insère une forme sur la page.

La forme est insérée avec une taille par défaut en haut à gauche de la page.

// Insert a shape in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

Paramètres

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

Renvois

Shape : forme insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

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

Insère une forme sur la page.

Paramètres

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

Renvois

Shape : forme insérée.

Autorisation

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

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

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

Paramètres

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

Renvois

SheetsChart : graphique inséré dans la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

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

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

Afin de conserver les proportions du graphique, celui-ci est mis à l'échelle et centré par rapport à la taille fournie.

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

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height,
);

Paramètres

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

Renvois

SheetsChart : graphique inséré dans la page.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`insertSheetsChart(sheetsChart)`

Insère une copie de l'SheetsChart fourni sur la page.

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

// Copy a sheets chart between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

Paramètres

Nom	Type	Description
`sheetsChart`	`SheetsChart`	Graphique de feuille de calcul à copier et à insérer.

Renvois

SheetsChart : graphique inséré dans la feuille.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`insertSheetsChartAsImage(sourceChart)`

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

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

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

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(
    chart);  // Also available for Layout, Master, and Page.

Paramètres

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

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

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

Insère un graphique Google Sheets en tant qu'Image sur la page, avec la position et la taille fournies.

Afin de conserver les proportions de l'image du graphique, celle-ci est mise à l'échelle et centrée par rapport à la taille fournie.

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

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height,
);

Paramètres

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

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`insertTable(numRows, numColumns)`

Insère un tableau sur la page.

Le tableau est centré sur la page, avec une taille par défaut et des lignes et colonnes réparties de manière uniforme.

Paramètres

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

Renvois

Table : tableau inséré.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

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

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

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

Paramètres

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

Renvois

Table : tableau inséré.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`insertTable(table)`

Insère une copie de l'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.

// 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`	Table à 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 scopes suivants :

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

`insertTextBox(text)`

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

La forme de la zone de texte est insérée avec une taille par défaut en haut à gauche de la page.

// Insert text box with "Hello" on the first slide of presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello');  // Also available for Layout, Master, and Page.

Paramètres

Nom	Type	Description
`text`	`String`	Chaîne que doit contenir 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 scopes suivants :

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

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

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

// Insert text box with "Hello" on the first slide of presentation. This text
// box is a square with a length of 10 points on each side.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox(
    'Hello', 0, 0, 10, 10);  // Also available for Layout, Master, and Page.

Paramètres

Nom	Type	Description
`text`	`String`	Chaîne que doit contenir la forme de 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 avec un ou plusieurs des scopes suivants :

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

`insertVideo(videoUrl)`

Insère une vidéo en haut à gauche de la page avec une taille par défaut.

Seules les vidéos YouTube sont actuellement acceptées.

Paramètres

Nom	Type	Description
`videoUrl`	`String`	URL de la vidéo à insérer.

Renvois

Video : vidéo insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 acceptées.

Paramètres

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

Renvois

Video : vidéo insérée.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`insertVideo(video)`

Insère une copie de l'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.

// 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 scopes suivants :

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

`insertWordArt(wordArt)`

Insère une copie de l'WordArt fourni sur la page.

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

// Copy a word art between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

Paramètres

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

Renvois

WordArt : texte Word Art inséré.

Autorisation

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

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

`replaceAllText(findText, replaceText)`

Remplace toutes les instances du texte à rechercher par le texte de remplacement. La recherche n'est pas sensible à la casse.

Paramètres

Nom	Type	Description
`findText`	`String`	Texte à rechercher.
`replaceText`	`String`	Texte à utiliser pour remplacer le texte correspondant.

Renvois

Integer : le nombre d'occurrences a changé

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`replaceAllText(findText, replaceText, matchCase)`

Remplace toutes les instances du texte à rechercher par le texte de remplacement.

Paramètres

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

Renvois

Integer : le nombre d'occurrences a changé

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

`selectAsCurrentPage()`

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

Un script ne peut accéder à la sélection de l'utilisateur qui l'exécute que s'il est associé à 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 scopes suivants :

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

Class Layout Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Méthodes

Documentation détaillée

getBackground()

Renvois

Autorisation

getColorScheme()

Renvois

Autorisation

getGroups()

Renvois

Autorisation

getImages()

Renvois

Autorisation

getLayoutName()

Renvois

Autorisation

getLines()

Renvois

Autorisation

getMaster()

Renvois

Autorisation

getObjectId()

Renvois

Autorisation

getPageElementById(id)

Paramètres

Renvois

Autorisation

getPageElements()

Renvois

Autorisation

getPageType()

Renvois

Autorisation

getPlaceholder(placeholderType)

Paramètres

Renvois

Autorisation

getPlaceholder(placeholderType, placeholderIndex)

Paramètres

Renvois

Autorisation

getPlaceholders()

Renvois

Autorisation

getShapes()

Renvois

Autorisation

getSheetsCharts()

Renvois

Autorisation

getTables()

Renvois

Autorisation

getVideos()

Renvois

Autorisation

getWordArts()

Renvois

Autorisation

group(pageElements)

Paramètres

Renvois

Autorisation

insertGroup(group)

Paramètres

Renvois

Autorisation

insertImage(blobSource)

Paramètres

Renvois

Autorisation

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

Paramètres

Renvois

Autorisation

insertImage(image)

Class Layout

`getBackground()`

`getColorScheme()`

`getGroups()`

`getImages()`

`getLayoutName()`

`getLines()`

`getMaster()`

`getObjectId()`

`getPageElementById(id)`

`getPageElements()`

`getPageType()`

`getPlaceholder(placeholderType)`

`getPlaceholder(placeholderType, placeholderIndex)`

`getPlaceholders()`

`getShapes()`

`getSheetsCharts()`

`getTables()`

`getVideos()`

`getWordArts()`

`group(pageElements)`

`insertGroup(group)`

`insertImage(blobSource)`

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

`insertImage(image)`

`insertImage(imageUrl)`

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

`insertLine(line)`

`insertLine(lineCategory, startConnectionSite, endConnectionSite)`

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

`insertPageElement(pageElement)`

`insertShape(shape)`

`insertShape(shapeType)`

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

`insertSheetsChart(sourceChart)`

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

`insertSheetsChart(sheetsChart)`

`insertSheetsChartAsImage(sourceChart)`

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

`insertTable(numRows, numColumns)`

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

`insertTable(table)`