REST Resource: presentations.pages

Ressource : Page

Une page d'une présentation.

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

  // Union field properties can be only one of the following:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of list of possible types for union field properties.
}
Champs
objectId

string

ID d'objet pour 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 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 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 numéro 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 valide que pendant 24 heures. Il ne peut pas être partagé entre les utilisateurs. Si l'ID de révision n'est pas modifié entre les appels, cela signifie que la présentation n'a pas été modifiée. À 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 changements de format de l'ID.

pageProperties

object (PageProperties)

Propriétés de la page.

Champ d'union properties. Propriétés spécifiques à chaque type de page. Les créations maîtres ne nécessitent aucune propriété supplémentaire. properties ne peut être qu'un des éléments suivants :
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)

Notes des propriétés spécifiques. Défini uniquement si pageType = NOTES.

masterProperties

object (MasterProperties)

Maîtrisez des propriétés spécifiques. Défini uniquement si pageType = MASTER.

PageType

Type de page.

Enums
SLIDE Une page de diapositive.
MASTER Une page de diapositive principale.
LAYOUT Une page de mise en page.
NOTES Une page de notes.
NOTES_MASTER Un masque de notes.

PageElement

Élément visuel affiché sur une page.

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

  // Union field element_kind can be only one of the following:
  "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 list of possible types for union field element_kind.
}
Champs
objectId

string

ID d'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 fait pas partie d'un groupe, sa transformation absolue est identique à la valeur de ce champ.

La transformation initiale de la Group nouvellement créée est toujours la transformation d'identité.

title

string

Titre de l'élément de page. Combiné à une description pour afficher un texte alternatif.

Ce champ n'est pas compatible avec 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 compatible avec les éléments Group.

Champ d'union element_kind. Type d'élément représenté par cet élément "PageElement". Chaque message contient les propriétés spécifiques à ce type d'élément de page. element_kind ne peut être qu'un des éléments suivants :
elementGroup

object (Group)

Ensemble d'éléments de page joints en une seule unité.

shape

object (Shape)

Forme générique.

image

object (Image)

Un élément de page d'image.

video

object (Video)

Un élément de page vidéo.

line

object (Line)

Élément de page linéaire.

table

object (Table)

Un élément de page de tableau.

wordArt

object (WordArt)

Élément de page Word Art.

sheetsChart

object (SheetsChart)

Un graphique lié intégré à partir de Google Sheets Les graphiques dissociés sont représentés sous forme d'images.

speakerSpotlight

object (SpeakerSpotlight)

Vidéo du présentateur.

Groupe

Genre PageElement représentant une collection jointe d'éléments "PageElements".

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

object (PageElement)

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

WordArt

Genre PageElement représentant le texte Word Art.

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

string

Texte affiché au format Word Art.

SpeakerSpotlight

Genre PageElement représentant la vidéo du présentateur.

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

object (SpeakerSpotlightProperties)

Propriétés de l'espace pour l'intervenant.

SpeakerSpotlightProperties

Propriétés de SpeakerSpotlight.

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

object (Outline)

Contours de l'espace pour l'intervenant. Si cette règle n'est pas configurée, elle n'a pas de contour.

shadow

object (Shadow)

Ombre de la vidéo du présentateur. Si cette règle n'est pas configurée, elle n'a pas d'ombre.

SlideProperties

Propriétés de Page qui ne sont pertinentes que pour les pages avec "pageType" 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 maître sur lequel est basée cette diapositive. Cette propriété est en lecture seule.

notesPage

object (Page)

Page de notes à laquelle cette diapositive est associée. Elle définit l'apparence visuelle d'une page de notes lorsque vous imprimez ou exportez des diapositives contenant les commentaires du présentateur. Une page de notes hérite des propriétés de notes master. La forme de l'espace réservé de type BODY sur la page de notes contient les commentaires du présentateur pour cette diapositive. L'ID de cette forme 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 commentaires 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 type de page est LAYOUT (mise en page).

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

string

ID d'objet du maître sur lequel est basée cette mise en page.

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 le type de page est NOTES.

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

string

ID d'objet de la forme sur cette page de notes contenant les commentaires du présentateur pour la diapositive correspondante. Il est possible que la forme réelle ne soit pas toujours présente sur la page de notes. Si vous insérez du texte avec cet ID d'objet, la forme est automatiquement créée. 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 type de page est "MASTER".

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

string

Nom lisible du maître.

PageProperties

Propriétés de Page.

La page héritera des propriétés de la page parente. Selon le 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 cette règle n'est pas configurée, le remplissage de l'arrière-plan est hérité de la page parente, le cas échéant. Si la page n'a pas de parent, le remplissage de l'arrière-plan est défini par défaut sur le remplissage correspondant dans l'éditeur Slides.

colorScheme

object (ColorScheme)

Jeu de couleurs de la page. Si cette règle n'est pas configurée, le jeu de couleurs est hérité de la page parente. Si la page n'a pas de parent, le jeu de couleurs utilise un jeu de couleurs Slides par défaut, qui correspond aux valeurs par défaut de l'éditeur Slides.

Seules les couleurs concrètes des 12 premiers éléments ThemeColorType peuvent être modifiés. De plus, seul le jeu de couleurs des pages Master peut être mis à jour. Pour mettre à jour le champ, vous devez fournir un jeu de couleurs contenant les mappages des 12 premiers ThemeColorTypes avec leurs couleurs concrètes. Les couleurs des ThemeColorTypes restants seront ignorées.

PageBackgroundFill

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

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

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of list of possible types for union field kind.
}
Champs
propertyState

enum (PropertyState)

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

La mise à jour du remplissage sur une page mettra implicitement ce champ sur RENDERED, sauf si une autre valeur est spécifiée dans la même requête. Pour que la 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.

Champ d'union kind. Type de remplissage de l'arrière-plan. kind ne peut être qu'un des éléments suivants :
solidFill

object (SolidFill)

Remplissage de couleur unie.

stretchedPictureFill

object (StretchedPictureFill)

Remplissage étirés de l'image.

StretchedPictureFill

Remplissage de l'image étiré. La page ou l'élément de page est entièrement rempli avec 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 dont la durée de vie par défaut est de 30 minutes. Cette URL comporte un tag avec le compte du demandeur. Toute personne disposant de l'URL accède à l'image en tant que demandeur d'origine. L'accès à l'image peut être perdu en cas de modification des paramètres de partage de la présentation.

Écrire l'élément contentUrl:

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

La longueur de 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)

ThemeColorType et paires de couleurs concrètes correspondantes.

ThemeColorPair

Paire mappant 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.

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 vignette de la dernière version de la page spécifiée dans la présentation et renvoie une URL vers l'image miniature.