Text

TextContent

Contenu textuel général. Le texte doit se trouver dans une forme compatible (par exemple, une zone de texte ou un rectangle) ou dans une cellule de tableau sur une page.

Représentation JSON 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Champs
textElements[]

object (TextElement)

Contenu textuel décomposé en ses éléments constitutifs, y compris les informations de style. Cette propriété est en lecture seule.

lists

map (key: string, value: object ( List))

Listes à puces contenues dans ce texte, avec l'ID de liste comme clé.

TextElement

Un TextElement décrit le contenu d'une plage d'index dans le contenu textuel d'une forme ou d'une TableCell.

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

  // Union field kind can be only one of the following:
  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
  // End of list of possible types for union field kind.
}
Champs
startIndex

integer

Index de début (basé sur zéro) de cet élément de texte, en unités de code Unicode.

endIndex

integer

Index de fin (basé sur zéro) de cet élément de texte, exclusif, en unités de code Unicode.

Champ d'union kind. Type de texte représenté par cet élément. kind ne peut être qu'un des éléments suivants :
paragraphMarker

object (ParagraphMarker)

Marqueur représentant le début d'un nouveau paragraphe.

Les valeurs startIndex et endIndex de cet élément TextElement représentent la plage du paragraphe. Les autres TextElements dont la plage d'index est incluse dans celle de ce paragraphe sont considérés comme faisant partie de ce paragraphe. Les plages d'index de deux paragraphes distincts ne se chevaucheront jamais.

textRun

object (TextRun)

TextElement représentant une séquence de texte où tous les caractères de la séquence ont le même TextStyle.

Les startIndex et endIndex de TextRuns seront toujours entièrement contenus dans la plage d'index d'un seul TextElement paragraphMarker. En d'autres termes, un TextRun ne s'étendra jamais sur plusieurs paragraphes.

autoText

object (AutoText)

TextElement représentant un emplacement dans le texte qui est remplacé de manière dynamique par du contenu pouvant changer au fil du temps.

ParagraphMarker

Type TextElement qui représente le début d'un nouveau paragraphe.

Représentation JSON 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Champs
style

object (ParagraphStyle)

Style du paragraphe

bullet

object (Bullet)

La puce de ce paragraphe. Si elle n'est pas présente, le paragraphe n'appartient pas à une liste.

ParagraphStyle

Styles qui s'appliquent à un paragraphe entier.

Si ce texte est contenu dans une forme avec un placeholder parent, ces styles de paragraphe peuvent être hérités du parent. Les styles de paragraphe hérités dépendent du niveau d'imbrication des listes :

  • Un paragraphe qui ne figure pas dans une liste hérite de son style de paragraphe à partir du paragraphe au niveau d'imbrication 0 de la liste à l'intérieur de l'espace réservé parent.
  • Un paragraphe d'une liste hérite de son style de paragraphe à partir du paragraphe correspondant à son niveau d'imbrication dans la liste à l'intérieur du code de substitution parent.

Les styles de paragraphe hérités sont représentés sous forme de champs non définis dans ce message.

Représentation JSON 
{
  "lineSpacing": number,
  "alignment": enum (Alignment),
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "direction": enum (TextDirection),
  "spacingMode": enum (SpacingMode)
}
Champs
lineSpacing

number

Quantité d'espace entre les lignes, en pourcentage de la normale (100, 0). Si elle n'est pas définie, la valeur est héritée du parent.

alignment

enum (Alignment)

Alignement du texte pour ce paragraphe.

indentStart

object (Dimension)

Quantité d'indentation du paragraphe du côté qui correspond au début du texte, en fonction du sens de lecture actuel. Si elle n'est pas définie, la valeur est héritée du parent.

indentEnd

object (Dimension)

Retrait du paragraphe sur le côté correspondant à la fin du texte, en fonction de la direction du texte actuel. Si elle n'est pas définie, la valeur est héritée du parent.

spaceAbove

object (Dimension)

Quantité d'espace supplémentaire au-dessus du paragraphe. Si elle n'est pas définie, la valeur est héritée du parent.

spaceBelow

object (Dimension)

Quantité d'espace supplémentaire sous le paragraphe. Si elle n'est pas définie, la valeur est héritée du parent.

indentFirstLine

object (Dimension)

Quantité de retrait pour le début de la première ligne du paragraphe. Si elle n'est pas définie, la valeur est héritée du parent.

direction

enum (TextDirection)

Sens de lecture de ce paragraphe. Si elle n'est pas définie, la valeur par défaut est LEFT_TO_RIGHT, car le sens du texte n'est pas hérité.

spacingMode

enum (SpacingMode)

Mode d'espacement du paragraphe.

Alignement

Types d'alignement du texte pour un paragraphe.

Enums
ALIGNMENT_UNSPECIFIED L'alignement des paragraphes est hérité du parent.
START Le paragraphe est aligné sur le début de la ligne. Alignement à gauche pour le texte LTR, à droite dans le cas contraire.
CENTER Le paragraphe est centré.
END Le paragraphe est aligné à la fin de la ligne. Aligné à droite pour le texte LTR, aligné à gauche dans le cas contraire.
JUSTIFIED Le paragraphe est justifié.

TextDirection

Le texte des instructions peut être inséré.

Enums
TEXT_DIRECTION_UNSPECIFIED La direction du texte est héritée du parent.
LEFT_TO_RIGHT Le texte va de gauche à droite.
RIGHT_TO_LEFT Le texte va de droite à gauche.

SpacingMode

Les différents modes d'espacement des paragraphes.

Enums
SPACING_MODE_UNSPECIFIED Le mode d'espacement est hérité du parent.
NEVER_COLLAPSE L'espace entre les paragraphes est toujours affiché.
COLLAPSE_LISTS L'espacement des paragraphes est ignoré entre les éléments de la liste.

Puces

Décrit la puce d'un paragraphe.

Représentation JSON 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
Champs
listId

string

ID de la liste à laquelle appartient ce paragraphe.

nestingLevel

integer

Niveau d'imbrication de ce paragraphe dans la liste.

glyph

string

Glyphe de puce affiché pour ce paragraphe.

bulletStyle

object (TextStyle)

Style de texte spécifique au paragraphe appliqué à cette puce.

TextStyle

Représente le style pouvant être appliqué à un TextRun.

Si ce texte est contenu dans une forme avec un placeholder parent, ces styles de texte peuvent être hérités du parent. Les styles de texte hérités dépendent du niveau d'imbrication des listes :

  • Une série de texte dans un paragraphe qui ne figure pas dans une liste hérite de son style de texte à partir du caractère de retour à la ligne dans le paragraphe au niveau d'imbrication 0 de la liste à l'intérieur de l'espace réservé parent.
  • Une série de texte dans un paragraphe d'une liste hérite de son style de texte à partir du caractère de nouvelle ligne dans le paragraphe, au niveau d'imbrication correspondant de la liste à l'intérieur du code de substitution parent.

Les styles de texte hérités sont représentés sous forme de champs non définis dans ce message. Si du texte est contenu dans une forme sans espace réservé parent, la suppression de ces champs rétablira un style correspondant aux valeurs par défaut de l'éditeur Slides.

Représentation JSON 
{
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "bold": boolean,
  "italic": boolean,
  "fontFamily": string,
  "fontSize": {
    object (Dimension)
  },
  "link": {
    object (Link)
  },
  "baselineOffset": enum (BaselineOffset),
  "smallCaps": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "weightedFontFamily": {
    object (WeightedFontFamily)
  }
}
Champs
backgroundColor

object (OptionalColor)

Couleur d'arrière-plan du texte. Si elle est définie, la couleur est opaque ou transparente, selon que le champ opaqueColor est défini ou non.

foregroundColor

object (OptionalColor)

Couleur du texte lui-même. Si elle est définie, la couleur est opaque ou transparente, selon que le champ opaqueColor est défini ou non.

bold

boolean

Indique si le texte est affiché en gras ou non.

italic

boolean

Indique si le texte est en italique ou non.

fontFamily

string

Famille de polices du texte.

La famille de polices peut être n'importe quelle police du menu "Police" de Slides ou de Google Fonts. Si le nom de la police n'est pas reconnu, le texte est affiché en Arial.

Certaines polices peuvent avoir une incidence sur l'épaisseur du texte. Si une demande de mise à jour spécifie des valeurs pour fontFamily et bold, la valeur bold définie de manière explicite est utilisée.

fontSize

object (Dimension)

Taille de la police du texte. Lorsqu'elle est lue, la valeur fontSize est spécifiée en points.

baselineOffset

enum (BaselineOffset)

Décalage vertical du texte par rapport à sa position normale.

Le texte avec des décalages de référence SUPERSCRIPT ou SUBSCRIPT est automatiquement affiché dans une taille de police plus petite, calculée en fonction du champ fontSize. La fontSize elle-même n'est pas affectée par les modifications apportées à ce champ.

smallCaps

boolean

Indique si le texte est en petites majuscules.

strikethrough

boolean

Indique si le texte est barré ou non.

underline

boolean

Indique si le texte est souligné ou non.

weightedFontFamily

object (WeightedFontFamily)

Famille de polices et épaisseur du texte.

Ce champ est une extension de fontFamily destinée à prendre en charge les épaisseurs de police explicites sans compromettre la rétrocompatibilité. Par conséquent, lorsque vous lisez le style d'une plage de texte, la valeur de weightedFontFamily#fontFamily sera toujours égale à celle de fontFamily. Toutefois, lors de l'écriture, si les deux champs sont inclus dans le masque de champ (de manière explicite ou via le caractère générique "*"), leurs valeurs sont réconciliées comme suit :

  • Si fontFamily est défini et que weightedFontFamily ne l'est pas, la valeur de fontFamily est appliquée avec le poids 400 ("normal").
  • Si les deux champs sont définis, la valeur de fontFamily doit correspondre à celle de weightedFontFamily#fontFamily. Si c'est le cas, la famille et l'épaisseur de police de weightedFontFamily sont appliquées. Sinon, une erreur 400 (requête incorrecte) est renvoyée.
  • Si weightedFontFamily est défini et que fontFamily ne l'est pas, la famille et la graisse de la police de weightedFontFamily sont appliquées.
  • Si aucun champ n'est défini, la famille et l'épaisseur de la police du texte héritent de celles du parent. Notez que ces propriétés ne peuvent pas hériter séparément les unes des autres.

Si une demande de mise à jour spécifie des valeurs pour weightedFontFamily et bold, weightedFontFamily est appliqué en premier, puis bold.

Si weightedFontFamily#weight n'est pas défini, la valeur par défaut est 400.

Si weightedFontFamily est défini, weightedFontFamily#fontFamily doit également être défini avec une valeur non vide. Sinon, une erreur 400 Bad Request est renvoyée.

OptionalColor

Couleur qui peut être entièrement opaque ou entièrement transparente.

Représentation JSON 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Champs
opaqueColor

object (OpaqueColor)

Si cette valeur est définie, elle sera utilisée comme couleur opaque. Si cette valeur n'est pas définie, elle représente une couleur transparente.

BaselineOffset

Manières dont le texte peut être décalé verticalement par rapport à sa position normale.

Enums
BASELINE_OFFSET_UNSPECIFIED Le décalage de la ligne de base du texte est hérité du parent.
NONE Le texte n'est pas décalé verticalement.
SUPERSCRIPT Le texte est décalé verticalement vers le haut (exposant).
SUBSCRIPT Le texte est décalé verticalement vers le bas (indice).

WeightedFontFamily

Représente une famille et une épaisseur de police utilisées pour styliser un TextRun.

Représentation JSON 
{
  "fontFamily": string,
  "weight": integer
}
Champs
fontFamily

string

Famille de polices du texte.

La famille de polices peut être n'importe quelle police du menu "Police" de Slides ou de Google Fonts. Si le nom de la police n'est pas reconnu, le texte est affiché en Arial.

weight

integer

Épaisseur du texte affiché. Ce champ peut avoir n'importe quelle valeur multiple de 100 comprise entre 100 et 900, inclus. Cette plage correspond aux valeurs numériques décrites dans la spécification CSS 2.1, section 15.6, avec les valeurs non numériques interdites. Les poids supérieurs ou égaux à 700 sont considérés comme gras, et les poids inférieurs à 700 ne le sont pas. La valeur par défaut est 400 ("normal").

TextRun

Type TextElement qui représente une série de texte dont le style est identique.

Représentation JSON 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Champs
content

string

Texte de cette exécution.

style

object (TextStyle)

Style appliqué à cette série.

AutoText

Type TextElement représentant un texte automatique.

Représentation JSON 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Champs
type

enum (Type)

Type de ce texte automatique.

content

string

Contenu affiché de ce texte automatique, le cas échéant.

style

object (TextStyle)

Style appliqué à ce texte automatique.

Type

Types de texte automatique

Enums
TYPE_UNSPECIFIED Type de texte automatique non spécifié.
SLIDE_NUMBER Type pour le texte automatique qui représente le numéro de la diapositive actuelle.

Liste

Une liste décrit l'apparence des puces appartenant aux paragraphes associés à une liste. Un paragraphe faisant partie d'une liste comporte une référence implicite à l'ID de cette liste.

Représentation JSON 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Champs
listId

string

ID de la liste.

nestingLevel

map (key: integer, value: object ( NestingLevel))

Mappage des niveaux d'imbrication aux propriétés des puces au niveau associé. Une liste comporte au maximum neuf niveaux d'imbrication. Les valeurs possibles pour les clés de cette carte sont donc comprises entre 0 et 8 (inclus).

NestingLevel

Contient des propriétés décrivant l'apparence d'une puce de liste à un niveau d'imbrication donné.

Représentation JSON 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Champs
bulletStyle

object (TextStyle)

Style d'une puce à ce niveau d'imbrication.