Class Page

Page

Page d'une présentation.

Méthodes

MéthodeType renvoyéBrève description
asLayout()LayoutRenvoie la page sous forme de mise en page.
asMaster()MasterRenvoie la page en tant que maître.
asSlide()SlideRenvoie la page sous forme de diapositive.
getBackground()PageBackgroundRécupère l'arrière-plan de la page.
getColorScheme()ColorSchemeRécupère le ColorScheme associé à la page.
getGroups()Group[]Affiche la liste des objets Group sur la page.
getImages()Image[]Affiche la liste des objets Image sur la page.
getLines()Line[]Affiche la liste des objets Line sur la page.
getObjectId()StringRécupère l'ID unique de la page.
getPageElementById(id)PageElementRenvoie la PageElement de la page dont l'ID est indiqué, ou null si aucune n'existe.
getPageElements()PageElement[]Renvoie la liste des objets PageElement affichés sur la page.
getPageType()PageTypeRécupère le type de la page.
getPlaceholder(placeholderType)PageElementRenvoie l'objet PageElement d'espace réservé pour un PlaceholderType ou null spécifié si aucun espace réservé correspondant n'est présent.
getPlaceholder(placeholderType, placeholderIndex)PageElementRenvoie l'objet PageElement d'espace réservé pour un PlaceholderType spécifié et un indice d'espace réservé, ou null si l'espace réservé n'est pas présent.
getPlaceholders()PageElement[]Renvoie la liste des objets PageElement d'espace réservé de la page.
getShapes()Shape[]Affiche la liste des objets Shape sur la page.
getSheetsCharts()SheetsChart[]Affiche la liste des objets SheetsChart sur la page.
getTables()Table[]Affiche la liste des objets Table sur la page.
getVideos()Video[]Affiche la liste des objets Video sur la page.
getWordArts()WordArt[]Affiche la liste des objets WordArt sur la page.
group(pageElements)GroupRegroupe tous les éléments de page spécifiés.
insertGroup(group)GroupInsère une copie du Group fourni sur la page.
insertImage(blobSource)ImageInsè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)ImageInsère une image sur la page avec la position et la taille fournies à partir du blob d'image spécifié.
insertImage(image)ImageInsère une copie du Image fourni sur la page.
insertImage(imageUrl)ImageInsère une image en haut à gauche de la page, à partir de l'URL fournie, avec une taille par défaut.
insertImage(imageUrl, left, top, width, height)ImageInsère une image sur la page à la position et à la taille indiquées à partir de l'URL fournie.
insertLine(line)LineInsère une copie du Line fourni sur la page.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineInsère une ligne sur la page reliant deux connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)LineInsère une ligne sur la page.
insertPageElement(pageElement)PageElementInsère une copie du PageElement fourni sur la page.
insertShape(shape)ShapeInsère une copie du Shape fourni sur la page.
insertShape(shapeType)ShapeInsère une forme sur la page.
insertShape(shapeType, left, top, width, height)ShapeInsère une forme sur la page.
insertSheetsChart(sourceChart)SheetsChartInsère un graphique Google Sheets sur la page.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartInsère un graphique Google Sheets sur la page avec la position et la taille fournies.
insertSheetsChart(sheetsChart)SheetsChartInsère une copie du SheetsChart fourni sur la page.
insertSheetsChartAsImage(sourceChart)ImageInsère un graphique Google Sheets en tant que Image sur la page.
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageInsère un graphique Google Sheets en tant que Image sur la page avec la position et la taille fournies.
insertTable(numRows, numColumns)TableInsère un tableau sur la page.
insertTable(numRows, numColumns, left, top, width, height)TableInsère un tableau sur la page avec la position et la taille fournies.
insertTable(table)TableInsère une copie du Table fourni sur la page.
insertTextBox(text)ShapeInsère une zone de texte Shape contenant la chaîne fournie sur la page.
insertTextBox(text, left, top, width, height)ShapeInsère une zone de texte Shape contenant la chaîne fournie sur la page.
insertVideo(videoUrl)VideoInsère une vidéo dans l'angle supérieur gauche de la page, avec une taille par défaut.
insertVideo(videoUrl, left, top, width, height)VideoInsère une vidéo sur la page avec la position et la taille fournies.
insertVideo(video)VideoInsère une copie du Video fourni sur la page.
insertWordArt(wordArt)WordArtInsère une copie du WordArt fourni sur la page.
remove()voidSupprime la page.
replaceAllText(findText, replaceText)IntegerRemplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement.
replaceAllText(findText, replaceText, matchCase)IntegerRemplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement.
selectAsCurrentPage()voidSélectionne le Page de la présentation active comme current page selection et supprime toute sélection précédente.

Documentation détaillée

asLayout()

Renvoie la page sous forme de mise en page.

Renvois

Layout : page sous forme de mise en page.

Autorisation

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

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

asMaster()

Renvoie la page en tant que maître.

Renvois

Master : page en tant que maître.

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

asSlide()

Renvoie la page sous forme de diapositive.

Renvois

Slide : page sous forme de diapositive.

Autorisation

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

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

getBackground()

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

Renvois

PageBackground : arrière-plan de la page.

Autorisation

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

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

getColorScheme()

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

Renvois

ColorScheme : jeu de couleurs de la page.

Autorisation

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

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

getGroups()

Affiche la liste des objets Group sur la page.

Renvois

Group[]

Autorisation

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

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

getImages()

Affiche la liste des objets Image sur la page.

Renvois

Image[]

Autorisation

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

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

getLines()

Affiche la liste des objets Line sur la page.

Renvois

Line[]

Autorisation

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

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

getObjectId()

Récupère l'ID unique de la page. Les ID d'objet utilisés par les pages et les éléments de page partagent le même espace de noms.

Renvois

String

Autorisation

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

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

getPageElementById(id)

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

Paramètres

NomTypeDescription
idStringID de l'élément de page récupéré.

Renvois

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

Autorisation

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

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

getPageElements()

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

Renvois

PageElement[]

Autorisation

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

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

getPageType()

Récupère le type de la page.

Renvois

PageType : type de page.

Autorisation

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

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

getPlaceholder(placeholderType)

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

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

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

Paramètres

NomTypeDescription
placeholderTypePlaceholderType

Renvois

PageElement

Autorisation

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

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

getPlaceholder(placeholderType, placeholderIndex)

Renvoie l'objet PageElement d'espace réservé pour un PlaceholderType spécifié et un indice d'espace réservé, ou null si l'espace réservé n'est pas présent.

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

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

Paramètres

NomTypeDescription
placeholderTypePlaceholderType
placeholderIndexInteger

Renvois

PageElement

Autorisation

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

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

getPlaceholders()

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

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

Renvois

PageElement[]

Autorisation

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

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

getShapes()

Affiche la liste des objets Shape sur la page.

Renvois

Shape[]

Autorisation

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

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

getSheetsCharts()

Affiche la liste des objets SheetsChart sur la page.

Renvois

SheetsChart[]

Autorisation

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

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

getTables()

Affiche la liste des objets Table sur la page.

Renvois

Table[]

Autorisation

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

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

getVideos()

Affiche la liste des objets Video sur la page.

Renvois

Video[]

Autorisation

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

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

getWordArts()

Affiche la liste des objets WordArt sur la page.

Renvois

WordArt[]

Autorisation

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

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

group(pageElements)

Regroupe tous les éléments de page spécifiés.

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

Paramètres

NomTypeDescription
pageElementsPageElement[]Éléments à regrouper.

Renvois

Group : nouveau groupe.

Autorisation

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

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

insertGroup(group)

Insère une copie du Group fourni sur la page.

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

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.

// Copy a group between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(
    group);  // Also available for Layout, Master, and Page.

Paramètres

NomTypeDescription
groupGroupGroupe à copier et à insérer.

Renvois

Group : groupe inséré.

Autorisation

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

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

insertImage(blobSource)

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

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

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

Paramètres

NomTypeDescription
blobSourceBlobSourceDonnées d'image.

Renvois

Image : image insérée.

Autorisation

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

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

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

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

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

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

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

Paramètres

NomTypeDescription
blobSourceBlobSourceDonnées d'image.
leftNumberPosition horizontale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur de l'image en points.
heightNumberHauteur de l'image en points.

Renvois

Image : image insérée.

Autorisation

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

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

insertImage(image)

Insère une copie du Image fourni sur la page.

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

Si l'image fournie est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'image insérée.

Si l'image fournie est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'image à partir de la présentation source. Si l'image d'espace réservé copiée est vide, rien n'est inséré dans la présentation de destination.

// Copy an image between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

Paramètres

NomTypeDescription
imageImageImage à copier et à insérer.

Renvois

Image : image insérée.

Autorisation

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

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

insertImage(imageUrl)

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

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

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

Paramètres

NomTypeDescription
imageUrlStringURL de l'image.

Renvois

Image : image insérée.

Autorisation

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

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

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

Insère une image sur la page à la position et à la taille indiquées à partir de l'URL fournie.

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

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

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

Paramètres

NomTypeDescription
imageUrlStringURL de l'image.
leftNumberPosition horizontale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale de l'image en points, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur de l'image en points.
heightNumberHauteur de l'image en points.

Renvois

Image : image insérée.

Autorisation

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

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

insertLine(line)

Insère une copie du Line fourni sur la page.

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

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.

// Copy a line between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

Paramètres

NomTypeDescription
lineLineLigne à copier et à insérer.

Renvois

Line : ligne insérée.

Autorisation

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

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

insertLine(lineCategory, startConnectionSite, endConnectionSite)

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

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

Paramètres

NomTypeDescription
lineCategoryLineCategoryCatégorie de la ligne à insérer.
startConnectionSiteConnectionSiteSite de connexion où le début de la ligne doit être connecté.
endConnectionSiteConnectionSiteSite de connexion où l'extrémité de la ligne doit être connectée.

Renvois

Line : ligne insérée.

Autorisation

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

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

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

Insère une ligne sur la page.

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

Paramètres

NomTypeDescription
lineCategoryLineCategoryCatégorie de la ligne à insérer.
startLeftNumberPosition horizontale du point de départ de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.
startTopNumberPosition verticale du point de départ de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.
endLeftNumberPosition horizontale du point final de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.
endTopNumberPosition verticale du point d'arrivée de la ligne, mesurée en points à partir de l'angle supérieur gauche de la page.

Renvois

Line : ligne insérée.

Autorisation

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

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

insertPageElement(pageElement)

Insère une copie du PageElement fourni sur la page.

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

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.

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

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

Paramètres

NomTypeDescription
pageElementPageElementÉlément de page à copier et à insérer.

Renvois

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

Autorisation

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

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

insertShape(shape)

Insère une copie du Shape fourni sur la page.

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

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.

// Copy a shape between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(
    shape);  // Also available for Layout, Master, and Page.

Paramètres

NomTypeDescription
shapeShapeForme à copier et à insérer.

Renvois

Shape : forme insérée.

Autorisation

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

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

insertShape(shapeType)

Insère une forme sur la page.

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

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

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

Paramètres

NomTypeDescription
shapeTypeShapeTypeType de forme à insérer.

Renvois

Shape : forme insérée.

Autorisation

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

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

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

Insère une forme sur la page.

Paramètres

NomTypeDescription
shapeTypeShapeTypeType de forme à insérer.
leftNumberPosition horizontale de la forme, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale de la forme, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur de la forme.
heightNumberHauteur de la forme.

Renvois

Shape : forme insérée.

Autorisation

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

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

insertSheetsChart(sourceChart)

Insère un graphique Google Sheets sur la page.

Le graphique est inséré dans la taille par défaut en haut à gauche de la page.

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

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

Paramètres

NomTypeDescription
sourceChartEmbeddedChartGraphique d'une feuille de calcul à insérer dans la page.

Renvois

SheetsChart : graphique inséré sur la page.

Autorisation

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

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

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

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

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

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

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

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

Paramètres

NomTypeDescription
sourceChartEmbeddedChartGraphique d'une feuille de calcul à insérer dans la page.
leftNumberPosition horizontale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur du graphique en points.
heightNumberHauteur du graphique en points.

Renvois

SheetsChart : graphique inséré sur la page.

Autorisation

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

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

insertSheetsChart(sheetsChart)

Insère une copie du SheetsChart fourni sur la page.

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

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.

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

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

Paramètres

NomTypeDescription
sheetsChartSheetsChartGraphique Sheets à copier et à insérer.

Renvois

SheetsChart : graphique Sheets inséré.

Autorisation

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

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

insertSheetsChartAsImage(sourceChart)

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

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

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

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

Paramètres

NomTypeDescription
sourceChartEmbeddedChartGraphique d'une feuille de calcul à insérer dans la page.

Renvois

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

Autorisation

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

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

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

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

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

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

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

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

Paramètres

NomTypeDescription
sourceChartEmbeddedChartGraphique d'une feuille de calcul à insérer dans la page.
leftNumberPosition horizontale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale du graphique en points, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur du graphique en points.
heightNumberHauteur du graphique en points.

Renvois

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

Autorisation

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

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

insertTable(numRows, numColumns)

Insère un tableau sur la page.

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

Paramètres

NomTypeDescription
numRowsIntegerNombre de lignes dans la table.
numColumnsIntegerNombre de colonnes dans la table.

Renvois

Table : tableau inséré.

Autorisation

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

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

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

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

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

Paramètres

NomTypeDescription
numRowsIntegerNombre de lignes dans la table.
numColumnsIntegerNombre de colonnes dans la table.
leftNumberPosition horizontale du tableau, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale du tableau, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur de la table.
heightNumberHauteur minimale de la table. La hauteur réelle du tableau affiché dépend de facteurs tels que la taille de la police de texte.

Renvois

Table : tableau inséré.

Autorisation

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

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

insertTable(table)

Insère une copie du Table fourni sur la page.

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

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.

// Copy a table between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(
    table);  // Also available for Layout, Master, and Page.

Paramètres

NomTypeDescription
tableTableTableau à copier et à insérer.

Renvois

Table : tableau inséré.

Autorisation

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

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

insertTextBox(text)

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

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

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

Paramètres

NomTypeDescription
textStringChaîne que la forme de la zone de texte doit contenir.

Renvois

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

Autorisation

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

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

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

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

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

Paramètres

NomTypeDescription
textStringChaîne que la forme de la zone de texte doit contenir.
leftNumberPosition horizontale de la forme de la zone de texte, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale de la forme de la zone de texte, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur de la forme de la zone de texte.
heightNumberHauteur de la forme de la zone de texte.

Renvois

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

Autorisation

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

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

insertVideo(videoUrl)

Insère une vidéo dans l'angle supérieur gauche de la page, avec une taille par défaut.

Seules les vidéos YouTube sont actuellement compatibles.

Paramètres

NomTypeDescription
videoUrlStringURL de la vidéo à insérer.

Renvois

Video : vidéo insérée.

Autorisation

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

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

insertVideo(videoUrl, left, top, width, height)

Insère une vidéo sur la page avec la position et la taille fournies.

Seules les vidéos YouTube sont actuellement compatibles.

Paramètres

NomTypeDescription
videoUrlStringURL de la vidéo à insérer.
leftNumberPosition horizontale de la vidéo en points, mesurée à partir de l'angle supérieur gauche de la page.
topNumberPosition verticale de la vidéo en points, mesurée à partir de l'angle supérieur gauche de la page.
widthNumberLargeur de la vidéo en points.
heightNumberHauteur de la vidéo en points.

Renvois

Video : vidéo insérée.

Autorisation

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

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

insertVideo(video)

Insère une copie du Video fourni sur la page.

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

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.

// Copy a video between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(
    video);  // Also available for Layout, Master, and Page.

Paramètres

NomTypeDescription
videoVideoVidéo à copier et à insérer.

Renvois

Video : vidéo insérée.

Autorisation

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

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

insertWordArt(wordArt)

Insère une copie du WordArt fourni sur la page.

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

Si l'élément fourni est un espace réservé copié à partir de la présentation actuelle, les propriétés qui héritent des pages maîtres ou de mise en page héritent également de l'élément inséré.

Si l'élément fourni est un espace réservé copié à partir d'une autre présentation, les propriétés qui héritent des pages maîtres ou de mise en page sont copiées sur l'élément à partir de la présentation source.

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

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

Paramètres

NomTypeDescription
wordArtWordArtGroupe à copier et à insérer.

Renvois

WordArt : texte Word Art inséré.

Autorisation

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

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

remove()

Supprime la page.

Autorisation

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

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

replaceAllText(findText, replaceText)

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

Paramètres

NomTypeDescription
findTextStringTexte à rechercher.
replaceTextStringTexte à remplacer par le texte correspondant.

Renvois

Integer : nombre d'occurrences modifiées

Autorisation

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

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

replaceAllText(findText, replaceText, matchCase)

Remplace toutes les occurrences du texte correspondant au texte à rechercher par le texte de remplacement.

Paramètres

NomTypeDescription
findTextStringTexte à rechercher.
replaceTextStringTexte à remplacer par le texte correspondant.
matchCaseBooleanSi la valeur est true, la recherche est sensible à la casse. Si la valeur est false, la recherche n'est pas sensible à la casse.

Renvois

Integer : nombre d'occurrences modifiées

Autorisation

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

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

selectAsCurrentPage()

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

Un script ne peut accéder qu'à la sélection de l'utilisateur qui l'exécute, et uniquement si le script est lié à la présentation.

// Select the first slide as the current page selection and replace any previous
// selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage();  // Also available for Layout, Master, and Page.

Autorisation

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

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