Class Presentation

Présentation

Une présentation.

Méthodes

MéthodeType renvoyéBrève description
addEditor(emailAddress)PresentationAjoute l'utilisateur donné à la liste des éditeurs de l'Presentation.
addEditor(user)PresentationAjoute l'utilisateur donné à la liste des éditeurs de l'Presentation.
addEditors(emailAddresses)PresentationAjoute le tableau d'utilisateurs donné à la liste des éditeurs de l'Presentation.
addViewer(emailAddress)PresentationAjoute l'utilisateur donné à la liste des spectateurs de l'Presentation.
addViewer(user)PresentationAjoute l'utilisateur donné à la liste des spectateurs de l'Presentation.
addViewers(emailAddresses)PresentationAjoute le tableau d'utilisateurs donné à la liste des spectateurs de l'Presentation.
appendSlide()SlideAjoute une diapositive à la fin de la présentation à l'aide de la mise en page prédéfinie PredefinedLayout.BLANK basée sur le maître actuel.
appendSlide(layout)SlideAjoute une diapositive à la fin de la présentation à l'aide de la mise en page spécifiée en fonction du maître actuel.
appendSlide(predefinedLayout)SlideAjoute une diapositive à la fin de la présentation à l'aide de la mise en page prédéfinie spécifiée en fonction du maître actuel.
appendSlide(slide)SlideAjoute une copie de l'Slide fourni à la fin de la présentation.
appendSlide(slide, linkingMode)SlideAjoute une copie de l'Slide fourni à partir de la présentation source à la fin de la présentation actuelle, et définit le lien vers la diapositive comme spécifié par SlideLinkingMode.
getEditors()User[]Récupère la liste des éditeurs de cet objet Presentation.
getId()StringRécupère l'identifiant unique de la présentation.
getLayouts()Layout[]Récupère les mises en page de la présentation.
getMasters()Master[]Récupère les masques de la présentation.
getName()StringRécupère le nom ou le titre de la présentation.
getNotesMaster()NotesMasterRécupère le maître des notes de la présentation.
getNotesPageHeight()NumberRécupère la hauteur de page du maître des notes et des pages de notes de la présentation en points.
getNotesPageWidth()NumberRécupère la largeur de la page du maître des notes et des pages de notes de la présentation en points.
getPageElementById(id)PageElementRenvoie l'PageElement avec l'ID donné, ou null si aucun n'existe.
getPageHeight()NumberRécupère la hauteur de page des diapositives, des mises en page et des modèles de la présentation en points.
getPageWidth()NumberRécupère la largeur de page des diapositives, des mises en page et des modèles de la présentation en points.
getSelection()SelectionRécupère la sélection de l'utilisateur dans la présentation active.
getSlideById(id)SlideRenvoie l'Slide avec l'ID donné, ou null si aucun n'existe.
getSlides()Slide[]Récupère les diapositives de la présentation.
getUrl()StringRécupère l'URL permettant d'accéder à cette présentation.
getViewers()User[]Récupère la liste des lecteurs et des commentateurs de cet Presentation.
insertSlide(insertionIndex)SlideInsère une diapositive à l'index spécifié dans la présentation à l'aide de la mise en page prédéfinie PredefinedLayout.BLANK basée sur le modèle actuel.
insertSlide(insertionIndex, layout)SlideInsère une diapositive à l'index spécifié dans la présentation à l'aide de la mise en page spécifiée en fonction du masque actuel.
insertSlide(insertionIndex, predefinedLayout)SlideInsère une diapositive à l'index spécifié dans la présentation à l'aide de la mise en page prédéfinie spécifiée en fonction du masque actuel.
insertSlide(insertionIndex, slide)SlideInsère une copie de l'Slide fournie à l'index spécifié dans la présentation.
insertSlide(insertionIndex, slide, linkingMode)SlideInsère une copie de l'Slide fourni à partir de la présentation source dans l'index spécifié de la présentation actuelle, puis définit le lien de la diapositive comme spécifié par le SlideLinkingMode.
removeEditor(emailAddress)PresentationSupprime l'utilisateur donné de la liste des éditeurs de l'Presentation.
removeEditor(user)PresentationSupprime l'utilisateur donné de la liste des éditeurs de l'Presentation.
removeViewer(emailAddress)PresentationSupprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'Presentation.
removeViewer(user)PresentationSupprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'Presentation.
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.
saveAndClose()voidEnregistre la Presentation actuelle.
setName(name)voidDéfinit le nom ou le titre de la présentation.

Documentation détaillée

addEditor(emailAddress)

Ajoute l'utilisateur donné à la liste des éditeurs de l'Presentation. Si l'utilisateur figurait déjà dans la liste des spectateurs, cette méthode le supprime de la liste.

Paramètres

NomTypeDescription
emailAddressStringAdresse e-mail de l'utilisateur à ajouter.

Renvois

Presentation : Presentation pour le chaînage.

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

addEditor(user)

Ajoute l'utilisateur donné à la liste des éditeurs de l'Presentation. Si l'utilisateur figurait déjà dans la liste des spectateurs, cette méthode le supprime de la liste.

Paramètres

NomTypeDescription
userUserReprésentation de l'utilisateur à ajouter.

Renvois

Presentation : Presentation pour le chaînage.

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

addEditors(emailAddresses)

Ajoute le tableau d'utilisateurs donné à la liste des éditeurs de l'Presentation. Si l'un des utilisateurs figurait déjà dans la liste des spectateurs, cette méthode le fait sortir de la liste.

Paramètres

NomTypeDescription
emailAddressesString[]Tableau d'adresses e-mail des utilisateurs à ajouter.

Renvois

Presentation : Presentation pour le chaînage.

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

addViewer(emailAddress)

Ajoute l'utilisateur donné à la liste des spectateurs de l'Presentation. Si l'utilisateur figurait déjà dans la liste des éditeurs, cette méthode n'a aucun effet.

Paramètres

NomTypeDescription
emailAddressStringAdresse e-mail de l'utilisateur à ajouter.

Renvois

Presentation : Presentation pour le chaînage.

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

addViewer(user)

Ajoute l'utilisateur donné à la liste des spectateurs de l'Presentation. Si l'utilisateur figurait déjà dans la liste des éditeurs, cette méthode n'a aucun effet.

Paramètres

NomTypeDescription
userUserReprésentation de l'utilisateur à ajouter.

Renvois

Presentation : Presentation pour le chaînage.

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

addViewers(emailAddresses)

Ajoute le tableau d'utilisateurs donné à la liste des spectateurs de l'Presentation. Si l'un des utilisateurs figurait déjà dans la liste des éditeurs, cette méthode n'a aucun effet pour lui.

Paramètres

NomTypeDescription
emailAddressesString[]Tableau d'adresses e-mail des utilisateurs à ajouter.

Renvois

Presentation : Presentation pour le chaînage.

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

appendSlide()

Ajoute une diapositive à la fin de la présentation à l'aide de la mise en page prédéfinie PredefinedLayout.BLANK basée sur le maître actuel. Le maître actuel est l'un des éléments suivants:

  • Maître de la dernière diapositive actuelle.
  • Premier masque de la présentation, s'il n'y a pas de diapositive.

Renvois

Slide : nouvelle diapositive ajouté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

appendSlide(layout)

Ajoute une diapositive à la fin de la présentation à l'aide de la mise en page spécifiée en fonction du maître actuel. Le maître actuel est l'un des éléments suivants:

  • Maître de la dernière diapositive actuelle.
  • Premier masque de la présentation, s'il n'y a pas de diapositive.

Paramètres

NomTypeDescription
layoutLayoutMise en page à utiliser pour la nouvelle diapositive. Elle doit être présente dans le modèle principal actuel.

Renvois

Slide : nouvelle diapositive ajouté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

appendSlide(predefinedLayout)

Ajoute une diapositive à la fin de la présentation à l'aide de la mise en page prédéfinie spécifiée en fonction du maître actuel. Le maître actuel est l'un des éléments suivants:

  • Maître de la dernière diapositive actuelle.
  • Premier masque de la présentation, s'il n'y a pas de diapositive.

Paramètres

NomTypeDescription
predefinedLayoutPredefinedLayoutMise en page prédéfinie à utiliser pour la nouvelle diapositive. Elle doit être présente dans le modèle maître actuel.

Renvois

Slide : nouvelle diapositive ajouté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

appendSlide(slide)

Ajoute une copie de l'Slide fourni à la fin de la présentation.

Si la diapositive copiée provient d'une autre présentation, le modèle parent et les pages de mise en page sont également copiés s'ils n'existent pas déjà dans cette présentation.

// Copy a slide from another presentation and appends it.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
currentPresentation.appendSlide(slide);

Paramètres

NomTypeDescription
slideSlideDiapositive à copier et à ajouter.

Renvois

Slide : nouvelle diapositive ajouté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

appendSlide(slide, linkingMode)

Ajoute une copie de l'Slide fourni à partir de la présentation source à la fin de la présentation actuelle, et définit le lien vers la diapositive comme spécifié par SlideLinkingMode.

Si la diapositive copiée provient d'une autre présentation, les pages de mise en page et le modèle parent sont également copiés s'ils n'existent pas déjà dans la présentation actuelle.

Si le mode de liaison est SlideLinkingMode.LINKED, la diapositive ajoutée peut être mise à jour pour correspondre à la diapositive source fournie lorsque Slide.refreshSlide() est appelé. Les autres collaborateurs voient le lien vers la diapositive source. SlideLinkingMode.LINKED ne peut pas être utilisé avec les diapositives sources de la présentation actuelle.

// Copy a slide from another presentation, then append and link it.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const appendedSlide = currentPresentation.appendSlide(
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

Paramètres

NomTypeDescription
slideSlideDiapositive à copier, ajouter et associer.
linkingModeSlideLinkingModeMode d'association à utiliser.

Renvois

Slide : nouvelle 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

getEditors()

Récupère la liste des éditeurs de cet objet Presentation.

Renvois

User[] : tableau d'utilisateurs disposant des droits de modification.

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

getId()

Récupère l'identifiant unique de la présentation. L'ID de présentation est utilisé avec SlidesApp.openById() pour ouvrir une instance de présentation spécifique.

Renvois

String : ID de cette présentation.

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

getLayouts()

Récupère les mises en page de la présentation.

Renvois

Layout[] : liste des mises en page de cette présentation.

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

getMasters()

Récupère les masques de la présentation.

Renvois

Master[] : liste des masques de cette présentation.

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

getName()

Récupère le nom ou le titre de la présentation.

Renvois

String : titre de la présentation.

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

getNotesMaster()

Récupère le maître des notes de la présentation.

Renvois

NotesMaster : masque des notes de la présentation.

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

getNotesPageHeight()

Récupère la hauteur de page du maître des notes et des pages de notes de la présentation en points. Elles ont toutes la même hauteur de page.

Renvois

Number : hauteur de la page de notes en points.

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

getNotesPageWidth()

Récupère la largeur de la page du maître des notes et des pages de notes de la présentation en points. Elles ont toutes la même largeur de page.

Renvois

Number : largeur de la page de notes en points.

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 l'PageElement avec l'ID donné, ou null si aucun 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

getPageHeight()

Récupère la hauteur de page des diapositives, des mises en page et des modèles de la présentation en points. Elles ont toutes la même hauteur de page.

Renvois

Number : hauteur de la page en points.

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

getPageWidth()

Récupère la largeur de page des diapositives, des mises en page et des modèles de la présentation en points. Elles ont toutes la même largeur de page.

Renvois

Number : largeur de la page en points.

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

getSelection()

Récupère la sélection de l'utilisateur dans la présentation active. 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.

Notez que la sélection renvoyée est la sélection effective actuelle. Lorsque le script effectue diverses modifications de la présentation, la sélection est transformée pour les prendre en compte. Par exemple, si deux formes A et B sont sélectionnées, puis que le script supprime la forme B, l'objet de sélection renvoyé est mis à jour implicitement de sorte que seule la forme A soit sélectionnée.

// Gets the current active page that is selected in the active presentation.
const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();

Renvois

Selection : représentation de la sélection de l'utilisateur, ou null si le script n'est pas lié à la présentation ou s'il n'y a pas de sélection utilisateur valide.

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

getSlideById(id)

Renvoie l'Slide avec l'ID donné, ou null si aucun n'existe.

Paramètres

NomTypeDescription
idStringID de la diapositive récupérée.

Renvois

Slide : diapositive associée à l'ID donné.

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

getSlides()

Récupère les diapositives de la présentation.

Renvois

Slide[] : liste des diapositives de cette présentation.

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

getUrl()

Récupère l'URL permettant d'accéder à cette présentation.

const presentation = SlidesApp.getActivePresentation();

// Send out the link to open the presentation.
MailApp.sendEmail(
    '<email-address>',
    presentation.getName(),
    presentation.getUrl(),
);

Renvois

String : URL permettant d'accéder à la présentation en cours.

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

getViewers()

Récupère la liste des lecteurs et des commentateurs de cet Presentation.

Renvois

User[] : tableau d'utilisateurs autorisés à afficher ou à commenter.

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

insertSlide(insertionIndex)

Insère une diapositive à l'index spécifié dans la présentation à l'aide de la mise en page prédéfinie PredefinedLayout.BLANK basée sur le modèle actuel. Le maître actuel est l'un des éléments suivants:

  • Maître de la diapositive précédente.
  • Maître de la première diapositive, si l'index d'insertion est nul.
  • Premier masque de la présentation, s'il n'y a pas de diapositive.

Paramètres

NomTypeDescription
insertionIndexIntegerIndex basé sur zéro indiquant l'emplacement où insérer la diapositive.

Renvois

Slide : nouvelle diapositive 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

insertSlide(insertionIndex, layout)

Insère une diapositive à l'index spécifié dans la présentation à l'aide de la mise en page spécifiée en fonction du masque actuel. Le maître actuel est l'un des éléments suivants:

  • Maître de la diapositive précédente.
  • Maître de la première diapositive, si l'index d'insertion est nul.
  • Premier masque de la présentation, s'il n'y a pas de diapositive.

Paramètres

NomTypeDescription
insertionIndexIntegerIndex basé sur zéro indiquant l'emplacement où insérer la diapositive.
layoutLayoutMise en page à utiliser pour la nouvelle diapositive. Elle doit être présente dans le modèle principal actuel.

Renvois

Slide : nouvelle diapositive 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

insertSlide(insertionIndex, predefinedLayout)

Insère une diapositive à l'index spécifié dans la présentation à l'aide de la mise en page prédéfinie spécifiée en fonction du masque actuel. Le maître actuel est l'un des éléments suivants:

  • Maître de la diapositive précédente.
  • Maître de la première diapositive, si l'index d'insertion est nul.
  • Premier masque de la présentation, s'il n'y a pas de diapositive.

Paramètres

NomTypeDescription
insertionIndexIntegerIndex basé sur zéro indiquant l'emplacement où insérer la diapositive.
predefinedLayoutPredefinedLayoutMise en page prédéfinie à utiliser pour la nouvelle diapositive. Elle doit être présente dans le modèle maître actuel.

Renvois

Slide : nouvelle diapositive 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

insertSlide(insertionIndex, slide)

Insère une copie de l'Slide fournie à l'index spécifié dans la présentation.

Si la diapositive copiée provient d'une autre présentation, le modèle parent et les pages de mise en page sont également copiés s'ils n'existent pas déjà dans cette présentation.

// Copy a slide from another presentation and inserts it.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
const insertionIndex = 1;
currentPresentation.insertSlide(insertionIndex, slide);

Paramètres

NomTypeDescription
insertionIndexIntegerIndex basé sur zéro indiquant l'emplacement où insérer la diapositive.
slideSlideDiapositive à copier et à insérer.

Renvois

Slide : nouvelle diapositive 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

insertSlide(insertionIndex, slide, linkingMode)

Insère une copie de l'Slide fourni à partir de la présentation source dans l'index spécifié de la présentation actuelle, puis définit le lien de la diapositive comme spécifié par le SlideLinkingMode.

Si la diapositive copiée provient d'une autre présentation, les pages de mise en page et le modèle parent sont également copiés s'ils n'existent pas déjà dans la présentation actuelle.

Si le mode de liaison est SlideLinkingMode.LINKED, la diapositive insérée peut être mise à jour pour correspondre à la diapositive source fournie lorsque Slide.refreshSlide() est appelé. Les autres collaborateurs voient le lien vers la diapositive source. SlideLinkingMode.LINKED ne peut pas être utilisé avec les diapositives sources de la présentation actuelle.

// Copy a slide from another presentation, then insert and link it.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const insertionIndex = 1;
const insertedSlide = currentPresentation.insertSlide(
    insertionIndex,
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

Paramètres

NomTypeDescription
insertionIndexIntegerIndex basé sur zéro indiquant l'emplacement où insérer la diapositive.
slideSlideDiapositive à copier et à insérer.
linkingModeSlideLinkingModeMode d'association à utiliser.

Renvois

Slide : nouvelle 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

removeEditor(emailAddress)

Supprime l'utilisateur donné de la liste des éditeurs de l'Presentation. Cette méthode n'empêche pas les utilisateurs d'accéder à l'Presentation s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général. Par exemple, si l'Presentation est partagé avec l'ensemble du domaine de l'utilisateur ou si l'Presentation se trouve dans un Drive partagé auquel l'utilisateur peut accéder.

Pour les fichiers Drive, l'utilisateur est également supprimé de la liste des lecteurs.

Paramètres

NomTypeDescription
emailAddressStringAdresse e-mail de l'utilisateur à supprimer.

Renvois

Presentation : Presentation pour le chaînage.

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

removeEditor(user)

Supprime l'utilisateur donné de la liste des éditeurs de l'Presentation. Cette méthode n'empêche pas les utilisateurs d'accéder à l'Presentation s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général. Par exemple, si l'Presentation est partagé avec l'ensemble du domaine de l'utilisateur ou si l'Presentation se trouve dans un Drive partagé auquel l'utilisateur peut accéder.

Pour les fichiers Drive, l'utilisateur est également supprimé de la liste des lecteurs.

Paramètres

NomTypeDescription
userUserReprésentation de l'utilisateur à supprimer.

Renvois

Presentation : Presentation pour le chaînage.

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

removeViewer(emailAddress)

Supprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'Presentation. Cette méthode n'a aucun effet si l'utilisateur est un éditeur, et non un lecteur ou un commentateur. Cette méthode n'empêche pas non plus les utilisateurs d'accéder à l'Presentation s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général. Par exemple, si l'Presentation est partagé avec l'ensemble du domaine de l'utilisateur ou si l'Presentation se trouve dans un Drive partagé auquel l'utilisateur peut accéder.

Pour les fichiers Drive, l'utilisateur est également supprimé de la liste des éditeurs.

Paramètres

NomTypeDescription
emailAddressStringAdresse e-mail de l'utilisateur à supprimer.

Renvois

Presentation : Presentation pour le chaînage.

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

removeViewer(user)

Supprime l'utilisateur donné de la liste des spectateurs et des commentateurs de l'Presentation. Cette méthode n'a aucun effet si l'utilisateur est un éditeur, et non un lecteur. Cette méthode n'empêche pas non plus les utilisateurs d'accéder à Presentation s'ils appartiennent à une classe d'utilisateurs disposant d'un accès général. Par exemple, si Presentation est partagé avec l'ensemble du domaine de l'utilisateur ou si Presentation se trouve dans un Drive partagé auquel l'utilisateur peut accéder.

Pour les fichiers Drive, l'utilisateur est également supprimé de la liste des éditeurs.

Paramètres

NomTypeDescription
userUserReprésentation de l'utilisateur à supprimer.

Renvois

Presentation : Presentation pour le chaînage.

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

saveAndClose()

Enregistre la Presentation actuelle. Entraîne le vidage et l'application des mises à jour en attente.

La méthode saveAndClose() est automatiquement appelée à la fin de l'exécution du script pour chaque Presentation ouverte, même si l'exécution du script s'est terminée par une erreur.

Vous ne pouvez pas modifier un Presentation fermé. Utilisez l'une des méthodes d'ouverture sur SlidesApp pour rouvrir une présentation donnée afin de la modifier.

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

setName(name)

Définit le nom ou le titre de la présentation.

Paramètres

NomTypeDescription
nameStringNom à définir pour cette présentation.

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