REST Resource: presentations

Ressource: Présentation

Une présentation Google Slides.

Représentation JSON
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
Champs
presentationId

string

ID de la présentation.

pageSize

object (Size)

Taille des pages de la présentation.

slides[]

object (Page)

Diapositives de la présentation Une diapositive hérite des propriétés d'une mise en page de diapositive.

title

string

Titre de la présentation.

masters[]

object (Page)

Masques de diapositives dans la présentation. Un masque de diapositive contient tous les éléments de page communs et les propriétés communes à un ensemble de mises en page. Elles ont trois objectifs:

  • Les formes d'espace réservé sur un masque contiennent les styles de texte et les propriétés de forme par défaut de toutes les formes d'espace réservé sur les pages qui utilisent ce masque.
  • Les propriétés de la page maître définissent les propriétés de page communes héritées par ses mises en page.
  • Toutes les autres formes du masque apparaissent sur toutes les diapositives utilisant ce masque, quelle que soit leur mise en page.
layouts[]

object (Page)

Mises en page de la présentation. Une mise en page est un modèle qui détermine l'organisation et le style du contenu sur les diapositives qui héritent de cette mise en page.

locale

string

Paramètres régionaux de la présentation, sous forme de tag de langue IETF BCP 47.

revisionId

string

Uniquement en sortie. ID de révision de la présentation. Peut être utilisée dans les requêtes de mise à jour pour confirmer que la révision de la présentation n'a pas changé depuis la dernière opération de lecture. Renseigné uniquement si l'utilisateur est autorisé à modifier la présentation.

L'ID de révision n'est pas un nombre séquentiel, mais une chaîne nébuleuse. Le format de l'ID de révision peut changer au fil du temps. Il doit donc être traité de manière opaque. Un ID de révision renvoyé n'est garanti que 24 heures après son retour et ne peut pas être partagé entre les utilisateurs. Si l'ID de révision reste le même entre les appels, cela signifie que la présentation n'a pas été modifiée. Inversement, un changement d'identifiant (pour la même présentation et la même personne) signifie généralement que la présentation a été mise à jour. Toutefois, la modification d'un identifiant peut également être due à des facteurs internes, tels que des modifications du format de l'identifiant.

notesMaster

object (Page)

Masque de notes dans la présentation. Elle remplit trois fonctions:

  • Les formes d'espace réservé sur un masque de notes contiennent les styles de texte et les propriétés de forme par défaut de toutes les formes d'espace réservé sur notes pages. Plus précisément, une forme d'espace réservé SLIDE_IMAGE contient la vignette de la diapositive et une forme d'espace réservé BODY contient les commentaires du présentateur.
  • Les propriétés de la page maître de notes définissent les propriétés de page communes héritées par tous les notes pages.
  • Toutes les autres formes du masque de notes s'affichent sur tous les notes pages.

Le masque de notes est en lecture seule.

Méthodes

batchUpdate

Applique une ou plusieurs mises à jour à la présentation.

create

Crée une présentation vierge à partir du titre donné dans la requête.

get

Récupère la dernière version de la présentation spécifiée.