REST Resource: presentations.pages

Ressource : Page

Page d'une présentation.

Représentation JSON 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of mutually exclusive fields.
}
Champs
objectId

string

ID d'objet de cette page. Les ID d'objet utilisés par Page et PageElement partagent le même espace de noms.
pageType

enum (PageType)

Type de page.
pageElements[]

object (PageElement)

Éléments de la page affichés sur la page.
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. Champ 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 opaque. Le format de l'ID de révision peut changer au fil du temps. Un ID de révision renvoyé n'est garanti valide que pendant 24 heures après son renvoi 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 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.
pageProperties

object (PageProperties)

Propriétés de la page.
commentAnchors[]

object (CommentAnchor)

Uniquement en sortie. Les ancres de commentaires présentes sur la page.

comments[]

object (CommentThread)

Uniquement en sortie. Fils de commentaires associés à la page. N'est renseigné que si la page a été récupérée via un GetPageRequest avec un commentsViewMode renseigné. Sinon, les commentaires sont renvoyés dans Presentation via GetPresentationRequest.

commentsViewMode

enum (CommentsViewMode)

Uniquement en sortie. Mode d'affichage des commentaires appliqué à la page. N'est renseigné que si la page a été récupérée via un GetPageRequest avec un commentsViewMode renseigné.

Propriétés spécifiques à chaque type de page. Les masters ne nécessitent aucune propriété supplémentaire. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
slideProperties

object (SlideProperties)

Propriétés spécifiques aux diapositives. Défini uniquement si pageType = SLIDE.
layoutProperties

object (LayoutProperties)

Propriétés spécifiques à la mise en page. Défini uniquement si pageType = LAYOUT.
notesProperties

object (NotesProperties)

Note les propriétés spécifiques. Défini uniquement si pageType = NOTES.
masterProperties

object (MasterProperties)

Maîtriser des propriétés spécifiques. Défini uniquement si pageType = MASTER.
Fin des champs qui s'excluent mutuellement.

PageType

Type de page.

Enums
SLIDE Une page de diapositive.
MASTER Page de diapositive principale.
LAYOUT une page de mise en page.
NOTES Une page de notes.
NOTES_MASTER Page maître des notes.

PageElement

Élément visuel affiché sur une page.

Représentation JSON 
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "elementGroup": {
    object (Group)
  },
  "shape": {
    object (Shape)
  },
  "image": {
    object (Image)
  },
  "video": {
    object (Video)
  },
  "line": {
    object (Line)
  },
  "table": {
    object (Table)
  },
  "wordArt": {
    object (WordArt)
  },
  "sheetsChart": {
    object (SheetsChart)
  },
  "speakerSpotlight": {
    object (SpeakerSpotlight)
  }
  // End of mutually exclusive fields.
}
Champs
objectId

string

ID de l'objet pour cet élément de page. Les ID d'objet utilisés par google.apps.slides.v1.Page et google.apps.slides.v1.PageElement partagent le même espace de noms.
size

object (Size)

Taille de l'élément de page.
transform

object (AffineTransform)

Transformation de l'élément de page.

L'apparence visuelle de l'élément de page est déterminée par sa transformation absolue. Pour calculer la transformation absolue, préconcaténez la transformation d'un élément de page avec les transformations de tous ses groupes parents. Si l'élément de page ne se trouve pas dans un groupe, sa transformation absolue est identique à la valeur de ce champ.

La transformation initiale du Group nouvellement créé est toujours la transformation d'identité.
title

string

Titre de l'élément de page. Combiné à la description pour afficher le texte alternatif.

Ce champ n'est pas disponible pour les éléments Group.
description

string

Description de l'élément de page. Combiné au titre pour afficher le texte alternatif.

Ce champ n'est pas disponible pour les éléments Group.
Type d'élément représenté par cet objet PageElement. Chaque message contient les propriétés spécifiques à ce type d'élément de page. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
elementGroup

object (Group)

Ensemble d'éléments de page regroupés en une seule unité.
shape

object (Shape)

Forme générique.
image

object (Image)

Élément de page image.
video

object (Video)

Élément de page vidéo.
line

object (Line)

Élément de page de type ligne.
table

object (Table)

Élément de page de tableau.
wordArt

object (WordArt)

Élément de page Word Art.
sheetsChart

object (SheetsChart)

Graphique associé intégré depuis Google Sheets. Les graphiques dissociés sont représentés sous forme d'images.
speakerSpotlight

object (SpeakerSpotlight)

Un espace pour l'intervenant.
Fin des champs qui s'excluent mutuellement.

Groupe

Type PageElement représentant une collection jointe d'éléments de page.

Représentation JSON 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
Champs
children[]

object (PageElement)

Collection d'éléments du groupe. La taille minimale d'un groupe est de deux.

WordArt

Type PageElement représentant un mot artistique.

Représentation JSON 
{
  "renderedText": string
}
Champs
renderedText

string

Texte affiché sous forme de WordArt.

SpeakerSpotlight

Type PageElement représentant une vidéo du présentateur.

Représentation JSON 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
Champs
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

Propriétés de la vidéo du présentateur.

SpeakerSpotlightProperties

Propriétés de SpeakerSpotlight.

Représentation JSON 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
Champs
outline

object (Outline)

Contour de l'espace pour l'intervenant. Si elle n'est pas définie, il n'y a pas de contour.
shadow

object (Shadow)

Ombre de la vidéo du présentateur. Si elle n'est pas définie, l'élément n'a pas d'ombre.

SlideProperties

Propriétés de Page qui ne sont pertinentes que pour les pages dont le pageType est SLIDE.

Représentation JSON 
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
Champs
layoutObjectId

string

ID d'objet de la mise en page sur laquelle cette diapositive est basée. Cette propriété est en lecture seule.
masterObjectId

string

ID d'objet du masque sur lequel cette diapositive est basée. Cette propriété est en lecture seule.
notesPage

object (Page)

Page de notes à laquelle cette diapositive est associée. Il définit l'apparence visuelle d'une page de notes lorsque vous imprimez ou exportez des diapositives avec des commentaires du présentateur. Une page de notes hérite des propriétés de notes master. L'espace réservé de type BODY sur la page de notes contient les commentaires du présentateur pour cette diapositive. L'ID de ce tracé est identifié par le champ speakerNotesObjectId. La page de notes est en lecture seule, à l'exception du contenu textuel et des styles de la forme des notes du présentateur. Cette propriété est en lecture seule.
isSkipped

boolean

Indique si la diapositive est ignorée en mode Présentation. Valeur par défaut : "false".

LayoutProperties

Les propriétés de Page ne sont pertinentes que pour les pages dont le pageType est LAYOUT.

Représentation JSON 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
Champs
masterObjectId

string

ID de l'objet du modèle sur lequel cette mise en page est basée.
name

string

Nom de la mise en page.
displayName

string

Nom lisible de la mise en page.

NotesProperties

Propriétés de Page qui ne sont pertinentes que pour les pages dont la valeur pageType est NOTES.

Représentation JSON 
{
  "speakerNotesObjectId": string
}
Champs
speakerNotesObjectId

string

ID d'objet de la forme sur cette page de notes qui contient les notes du présentateur pour la diapositive correspondante. Il est possible que la forme réelle n'existe pas toujours sur la page de notes. L'insertion de texte à l'aide de cet ID d'objet créera automatiquement la forme. Dans ce cas, la forme réelle peut avoir un ID d'objet différent. L'action presentations.get ou pages.get renvoie toujours le dernier ID d'objet.

MasterProperties

Propriétés de Page qui ne sont pertinentes que pour les pages dont le pageType est MASTER.

Représentation JSON 
{
  "displayName": string
}
Champs
displayName

string

Nom lisible du master.

PageProperties

Propriétés de Page.

La page hérite des propriétés de la page parente. En fonction du type de page, la hiérarchie est définie dans SlideProperties ou LayoutProperties.

Représentation JSON 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
Champs
pageBackgroundFill

object (PageBackgroundFill)

Remplissage de l'arrière-plan de la page. Si elle n'est pas définie, la couleur de remplissage de l'arrière-plan est héritée d'une page parente, le cas échéant. Si la page n'a pas de parent, la couleur de remplissage de l'arrière-plan est celle définie par défaut dans l'éditeur Slides.
colorScheme

object (ColorScheme)

Jeu de couleurs de la page. Si elle n'est pas définie, le jeu de couleurs est hérité d'une page parente. Si la page n'a pas de parent, le schéma de couleurs utilise un schéma de couleurs Slides par défaut, correspondant aux valeurs par défaut de l'éditeur Slides.

Seules les couleurs concrètes des 12 premiers ThemeColorType sont modifiables. De plus, seul le jeu de couleurs des pages Master peut être modifié. Pour mettre à jour le champ, vous devez fournir un jeu de couleurs contenant des mappages de tous les 12 premiers ThemeColorTypes vers leurs couleurs concrètes. Les couleurs des autres ThemeColorTypes seront ignorées.

PageBackgroundFill

Remplissage de l'arrière-plan de la page.

Représentation JSON 
{
  "propertyState": enum (PropertyState),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of mutually exclusive fields.
}
Champs
propertyState

enum (PropertyState)

État de la propriété de remplissage de l'arrière-plan.

La mise à jour du remplissage d'une page mettra implicitement à jour ce champ sur RENDERED, sauf si une autre valeur est spécifiée dans la même requête. Pour qu'une page ne comporte aucun remplissage, définissez ce champ sur NOT_RENDERED. Dans ce cas, tous les autres champs de remplissage définis dans la même requête seront ignorés.
Type de remplissage de l'arrière-plan. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
solidFill

object (SolidFill)

Remplissage de couleur unie.
stretchedPictureFill

object (StretchedPictureFill)

Remplissage de l'image étirée.
Fin des champs qui s'excluent mutuellement.

StretchedPictureFill

Remplissage de l'image étirée. La page ou l'élément de page est entièrement rempli par l'image spécifiée. L'image est étirée pour s'adapter à son conteneur.

Représentation JSON 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
Champs
contentUrl

string

Lecture de contentUrl :

URL d'une image avec une durée de vie par défaut de 30 minutes. Cette URL est taguée avec le compte du demandeur. Toute personne disposant de l'URL peut accéder à l'image en tant que demandeur d'origine. Vous risquez de perdre l'accès à l'image si les paramètres de partage de la présentation changent.

Écrire le contentUrl :

L'image est récupérée 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 au format PNG, JPEG ou GIF, ne pas dépasser 50 Mo et ne pas dépasser 25 mégapixels.

L'URL fournie ne doit pas dépasser 2 Ko.
size

object (Size)

Taille d'origine du remplissage de l'image. Ce champ est en lecture seule.

ColorScheme

Palette de couleurs prédéfinies pour une page.

Représentation JSON 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Champs
colors[]

object (ThemeColorPair)

Type ThemeColorType et paires de couleurs concrètes correspondantes.

ThemeColorPair

Paire associant un type de couleur de thème à la couleur concrète qu'il représente.

Représentation JSON 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
Champs
type

enum (ThemeColorType)

Type de couleur du thème.
color

object (RgbColor)

Couleur concrète correspondant au type de couleur du thème ci-dessus.

CommentAnchor

Contient la liste de tous les emplacements d'un Page ancrés à un CommentThread via le même anchorId. Plusieurs ancres distinctes peuvent faire référence au même emplacement, que ce soit dans un même Page ou sur différentes pages.

Représentation JSON 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
Champs
anchorId

string

Uniquement en sortie. Identifiant unique de l'ancrage du commentaire.
objectAnchors[]

object (ObjectAnchor)

Uniquement en sortie. Toutes les positions basées sur l'ID d'objet d'une page qui font référence à l'ID d'ancrage.

ObjectAnchor

Représente les données d'ancrage des commentaires associées à un objet Slides, par exemple Page ou PageElement.

Représentation JSON 
{
  "objectId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
  // End of mutually exclusive fields.
}
Champs
objectId

string

Uniquement en sortie. Page ou élément de page auxquels le fil de commentaires est ancré.
Uniquement en sortie. Plages de texte dans l'élément de page auquel le fil de discussion est ancré. Cette valeur sera vide si l'ancrage du commentaire concerne l'ensemble de la page ou de l'élément de page, plutôt qu'une plage de texte au sein de l'élément. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
shapeTextAnchors

object (ShapeTextAnchors)

Rempli pour les Shapes dont les commentaires sont ancrés à des plages de texte dans le [contenu textuel][google.apps.slides.v1.Shape.TextContent] de la forme.
tableCellAnchors

object (TableCellAnchors)

Renseigné pour les Tables dont les commentaires sont ancrés à des plages de texte dans une ou plusieurs cellules du tableau.
Fin des champs qui s'excluent mutuellement.

ShapeTextAnchors

Représente les plages de texte d'une forme couvertes par un point d'ancrage de commentaire.

Représentation JSON 
{
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Champs
ranges[]

object (TextRange)

Liste des plages de texte couvertes par l'ancre du commentaire.

TextRange

Spécifie une plage de texte contiguë dans le text d'une forme ou d'une cellule de tableau.

Représentation JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
Champs
startIndex

integer

Index basé sur zéro du début de la plage. Ce champ est une Int32Value afin de s'adapter aux futurs cas d'utilisation avec des plages ouvertes.
endIndex

integer

Index basé sur zéro de la fin de la plage. Ce champ est une Int32Value afin de s'adapter aux futurs cas d'utilisation avec des plages ouvertes.

TableCellAnchors

Représente les plages de cellules d'un tableau couvertes par une ancre de commentaire.

Représentation JSON 
{
  "cellRanges": [
    {
      object (TableCellTextRanges)
    }
  ]
}
Champs
cellRanges[]

object (TableCellTextRanges)

Liste de toutes les cellules de tableau dont le texte est couvert par l'ancrage dans le tableau.

TableCellTextRanges

Représente les plages de texte d'une cellule de tableau couvertes par un point d'ancrage de commentaire.

Représentation JSON 
{
  "cellLocation": {
    object (TableCellLocation)
  },
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Champs
cellLocation

object (TableCellLocation)

Emplacement de la cellule du tableau.
ranges[]

object (TextRange)

Liste de toutes les plages de texte couvertes par l'ancrage dans cette cellule.

Méthodes

get

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

getThumbnail

 Génère une miniature de la dernière version de la page spécifiée dans la présentation et renvoie une URL vers l'image miniature.