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 d'une page.

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

object (TextElement)

Contenu textuel divisé en plusieurs parties, y compris les informations de style Cette propriété est en lecture seule.

lists

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

Les listes à puces contenues dans ce texte, triées par ID de liste.

TextElement

Un élément TextElement décrit le contenu d'une plage d'indices dans le contenu textuel d'une forme ou d'une cellule de tableau.

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épart basé sur zéro de cet élément textuel, en unités de code Unicode.

endIndex

integer

Index de fin de cet élément de texte, basé sur zéro, 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)

Repère représentant le début d'un nouveau paragraphe.

Les éléments startIndex et endIndex de cet élément TextElement représentent la plage du paragraphe. Les autres éléments de texte dont la plage d'index est comprise dans la plage de ce paragraphe sont considérés comme faisant partie de ce paragraphe. La plage d'indices de deux paragraphes distincts ne se chevauche jamais.

textRun

object (TextRun)

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

Les startIndex et endIndex des TextRuns sont toujours entièrement contenus dans la plage d'index d'un seul élément de texte paragraphMarker. En d'autres termes, un TextRun ne s'étend jamais sur plusieurs paragraphes.

autoText

object (AutoText)

Un élément 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

Genre TextElement représentant 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)

Puce de ce paragraphe. En l'absence de cette balise, le paragraphe n'appartient à aucune liste.

ParagraphStyle

Styles qui s'appliquent à un paragraphe entier.

Si ce texte est contenu dans une forme avec un parent placeholder, ces styles de paragraphe peuvent alors être hérités de l'élément 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 son style de paragraphe 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 au niveau d'imbrication correspondant de la liste dans l'espace réservé parent.

Les styles de paragraphe hérités sont représentés par des 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

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

alignment

enum (Alignment)

Alignement du texte de ce paragraphe.

indentStart

object (Dimension)

Indentation du paragraphe sur le côté correspondant au début du texte, en fonction du sens du texte actuel. Si cette règle n'est pas configurée, la valeur est héritée du parent.

indentEnd

object (Dimension)

Retrait du montant du paragraphe sur le côté qui correspond à la fin du texte, en fonction de l'orientation actuelle du texte. Si cette valeur n'est pas définie, elle est héritée du parent.

spaceAbove

object (Dimension)

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

spaceBelow

object (Dimension)

Espace supplémentaire sous le paragraphe. Si cette règle n'est pas configurée, la valeur est héritée du parent.

indentFirstLine

object (Dimension)

Nombre de retraits pour le début de la première ligne du paragraphe. Si cette règle n'est pas configurée, la valeur est héritée du parent.

direction

enum (TextDirection)

Sens du texte de ce paragraphe. Si cette règle n'est pas configurée, la valeur par défaut est définie sur LEFT_TO_RIGHT car l'orientation du texte n'est pas héritée.

spacingMode

enum (SpacingMode)

Mode d'espacement du paragraphe.

Alignement

Types d'alignement de texte pour un paragraphe.

Enums
ALIGNMENT_UNSPECIFIED L'alignement du paragraphe est hérité de l'élément parent.
START Le paragraphe est aligné par rapport au début de la ligne. Aligné à gauche pour le texte de gauche à droite, aligné à 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 de gauche à droite, aligné à gauche dans le cas contraire.
JUSTIFIED Le paragraphe est justifié.

TextDirection

Le texte de l'itinéraire peut s'afficher correctement.

Enums
TEXT_DIRECTION_UNSPECIFIED L'orientation 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

Différents modes d'espacement des paragraphes.

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

Puces

Décrit le point de liste d'un paragraphe.

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

string

ID de la liste à laquelle ce paragraphe appartient.

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 qui peut ê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équence de texte dans un paragraphe qui ne figure pas dans une liste hérite de son style de texte du caractère de retour à la ligne dans le paragraphe au niveau d'imbrication 0 de la liste dans l'espace réservé parent.
  • Une séquence de texte dans un paragraphe d'une liste hérite de son style de texte à partir du caractère de nouvelle ligne du paragraphe au niveau d'imbrication correspondant de la liste dans l'espace réservé parent.

Les styles de texte hérités sont représentés par des champs non définis dans ce message. Si le texte est contenu dans une forme sans espace réservé parent, la valeur du style sera rétablie sur les valeurs par défaut de l'éditeur de diapositives si vous désactivez ces champs.

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 soit opaque, soit transparente, selon que la opaqueColor qui y figure est défini.

foregroundColor

object (OptionalColor)

Couleur du texte lui-même. Si elle est définie, la couleur est soit opaque, soit transparente, selon que la opaqueColor qui y figure est défini.

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

Vous pouvez choisir n'importe quelle famille dans le menu "Police" de Slides Google Fonts : Si le nom de la police n'est pas reconnu, le texte est affiché en Arial.

Certaines polices peuvent affecter l'épaisseur du texte. Si une requête de mise à jour spécifie des valeurs pour fontFamily et bold, la valeur bold définie explicitement est utilisée.

fontSize

object (Dimension)

Taille de la police du texte. Lorsqu'il est lu, le fontSize sera spécifiée en points.

baselineOffset

enum (BaselineOffset)

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

Envoyer un SMS avec SUPERSCRIPT ou SUBSCRIPT les décalages de référence s'affichent automatiquement dans une taille de police plus petite, calculée en fonction fontSize . La fontSize 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és à prendre en charge des épaisseurs de police explicites sans entraver la rétrocompatibilité. Par conséquent, lorsque vous lisez le style d'une plage de texte, la valeur de weightedFontFamily#fontFamily est toujours égale à celle de fontFamily. Toutefois, lors de l'écriture, si les deux champs sont inclus dans le masque de champ (soit explicitement, soit à l'aide du caractère générique) "*"), leurs valeurs sont rapprochées comme suit:

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

Si une requête 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 de requête incorrecte 400 est renvoyée.

OptionalColor

Couleur qui peut être soit totalement opaque, soit totalement transparente.

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

object (OpaqueColor)

S'il est défini, il est utilisé comme couleur opaque. Si cette valeur n'est pas définie, il s'agit d'une couleur transparente.

BaselineOffset

Façons 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 (indice).
SUBSCRIPT Le texte est décalé verticalement vers le bas (indice).

WeightedFontFamily

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

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

string

Famille de polices du texte

Vous pouvez choisir n'importe quelle famille dans le menu "Police" de Slides 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 contenir n'importe quelle valeur qui est un multiple de 100 entre 100 et 900, inclus. Cette plage correspond aux valeurs numériques décrites dans la spécification CSS 2.1, section 15.6, les valeurs non numériques étant interdites. Les épaisseurs supérieures ou égales à 700 sont considérées comme en gras, et les épaisseurs inférieures à 700 ne le sont pas. La valeur par défaut est 400 ("normal").

TextRun

Type TextElement qui représente une séquence de texte ayant tous le même style.

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

string

Texte de cette exécution.

style

object (TextStyle)

Style appliqué à cette exécution.

AutoText

Genre TextElement qui représente le 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 de texte automatique représentant le numéro actuel de la diapositive.

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

Identifiant de la liste.

nestingLevel

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

Carte des niveaux d'imbrication et des 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 mise en correspondance sont donc comprises entre 0 et 8, inclus.

NestingLevel

Contient des propriétés décrivant l'apparence d'un point 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.