Text

TextContent

Contenu textuel général. Le texte doit respecter une forme compatible (par exemple, une zone de texte ou un rectangle) ou une cellule de tableau dans 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))

Listes à puces contenues dans ce texte, classé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 table de table.

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 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 que l'un des éléments suivants:
paragraphMarker

object (ParagraphMarker)

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

La startIndex et endIndex de cet élément TextElement représentent la plage du paragraphe. Les autres éléments TextElements dont la plage d'index est incluse 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 chevauchera jamais.

textRun

object (TextRun)

Élément TextElement représentant une séquence de texte dans laquelle tous les caractères de l'exécution ont le même TextStyle

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

autoText

object (AutoText)

Élément TextElement représentant un emplacement dans le texte qui est remplacé de manière dynamique par du contenu susceptible de 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. S'il n'est pas présent, 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 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 son style de paragraphe du paragraphe à son niveau d'imbrication correspondant dans 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 normale, où la normale est représentée par 100,0. Si cette règle n'est pas configurée, la valeur est héritée du parent.

alignment

enum (Alignment)

Alignement du texte pour ce paragraphe.

indentStart

object (Dimension)

Retrait du montant du paragraphe sur le côté qui correspond au début du texte, en fonction de l'orientation actuelle du texte. 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 règle n'est pas configurée, la valeur est héritée du parent.

spaceAbove

object (Dimension)

La quantité d'espace supplémentaire au-dessus du paragraphe. Si cette règle n'est pas configurée, la valeur est héritée du parent.

spaceBelow

object (Dimension)

La quantité d'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

Les différents modes d'espacement des paragraphes.

Enums
SPACING_MODE_UNSPECIFIED Le mode d'espacement est hérité du parent.
NEVER_COLLAPSE L'espacement des 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 parent placeholder, ces styles de texte peuvent alors être hérités de l'élément parent. Les styles de texte hérités dépendent du niveau d'imbrication des listes:

  • Un texte exécuté dans un paragraphe qui ne figure pas dans une liste hérite son style de texte du caractère de retour à la ligne du paragraphe au niveau d'imbrication 0 de la liste à l'intérieur de l'espace réservé parent.
  • Un texte exécuté dans un paragraphe qui se trouve dans une liste hérite son style de texte du caractère de nouvelle ligne du paragraphe à son niveau d'imbrication correspondant dans la liste à l'intérieur de 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 une forme contient du texte sans espace réservé parent, la désactivation de ces champs rétablira le style sur une valeur correspondant aux valeurs par défaut dans 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 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 s'affiche au format Arial

Certaines polices peuvent avoir une incidence sur l'épaisseur du texte. Si une demande de mise à jour spécifie des valeurs fontFamily et bold, la valeur définie explicitement bold 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é. Ainsi, lors de la lecture du 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 à celui 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éfinie et fontFamily n'est pas le cas, la famille de polices et l'épaisseur weightedFontFamily est appliqué.
  • Si aucun des champs n'est défini, la famille de polices et l'épaisseur du texte héritent du parent. Notez que ces propriétés ne peuvent pas hériter indépendamment les unes des autres.

Si une demande de mise à jour spécifie des valeurs weightedFontFamily et bold, le 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 référence du texte est hérité de l'élément 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 s'affiche au format Arial

weight

integer

Épaisseur du texte à afficher. 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 ne sont pas autorisées. Pondérations supérieures ou égales à 700 sont considérés comme en gras et les pondérations inférieures à 700 ne sont pas en gras. La valeur par défaut est 400 ("normal").

TextRun

Genre 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 texte automatique.

content

string

Contenu rendu de ce texte automatique, si disponible.

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

ID 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. Par conséquent, les valeurs possibles pour les clés de cette carte sont comprises entre 0 et 8 inclus.

NestingLevel

Contient les propriétés décrivant l'apparence d'une liste à puces à un niveau d'imbrication donné.

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

object (TextStyle)

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