Method: presentations.create

Crée une présentation vide à l'aide du titre indiqué dans la requête. Si un presentationId est fourni, il est utilisé comme ID de la nouvelle présentation. Sinon, un nouvel ID est généré. Les autres champs de la requête, y compris tout contenu fourni, sont ignorés. Renvoie la présentation créée.

Requête HTTP

POST https://slides.googleapis.com/v1/presentations

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

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)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
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.
title

string

Titre de la présentation.
masters[]

object (Page)

Masques de diapositives de la présentation. Un masque de diapositive contient tous les éléments de page communs et les propriétés communes d'un ensemble de mises en page. Il remplit trois fonctions :

  • Les formes d'espace réservé d'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é des 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 de la diapositive maître apparaissent sur toutes les diapositives qui utilisent 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 la manière dont le contenu est organisé et stylisé sur les diapositives qui en héritent.
locale

string

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

string

Uniquement en sortie. ID de révision de la présentation. Peut être utilisé dans les requêtes de mise à jour pour affirmer que la révision de la présentation n'a pas changé depuis la dernière opération de lecture. N'est renseigné que si l'utilisateur dispose d'un accès en modification à 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 valide que 24 heures après avoir été renvoyé et ne peut pas être partagé entre les utilisateurs. Si l'ID de révision est inchangé entre les appels, cela signifie que la présentation n'a pas changé. À l'inverse, un ID modifié (pour la même présentation et le même utilisateur) signifie généralement que la présentation a été mise à jour. Toutefois, un ID modifié peut également être dû à des facteurs internes tels que des modifications du format de l'ID.
notesMaster

object (Page)

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

  • Les formes d'espace réservé d'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é des 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 du masque de notes définissent les propriétés de page communes héritées par toutes les notes pages.
  • Toutes les autres formes du masque de notes apparaissent sur toutes les notes pages.

Le masque de notes est en lecture seule.
comments[]

object (CommentThread)

Uniquement en sortie. Fils de discussion associés à la présentation.

commentsViewMode

enum (CommentsViewMode)

Uniquement en sortie. Mode d'affichage des commentaires appliqué à la présentation.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Presentation.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

Pour en savoir plus, consultez le guide sur l'autorisation.