REST Resource: documents

Ressource : Document

Un document Google Docs.

Représentation JSON
{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Champs
documentId

string

Uniquement en sortie. ID du document.

title

string

Titre du document.

tabs[]

object (Tab)

Onglets faisant partie d'un document.

Les onglets peuvent contenir des onglets enfants, c'est-à-dire des onglets imbriqués dans d'autres onglets. Les onglets enfants sont représentés par le champ Tab.childTabs.

revisionId

string

Uniquement en sortie. ID de révision du document. Peut être utilisé dans les requêtes de mise à jour pour spécifier la révision d'un document à laquelle appliquer les mises à jour et le comportement de la requête si le document a été modifié depuis cette révision. Champ renseigné uniquement si l'utilisateur est autorisé à modifier le document.

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 le document n'a pas été modifié. À l'inverse, un ID modifié (pour le même document et le même utilisateur) signifie généralement que le document a été mis à jour. Toutefois, un ID modifié peut également être dû à des facteurs internes, tels que des modifications du format de l'ID.

suggestionsViewMode

enum (SuggestionsViewMode)

Uniquement en sortie. Mode d'affichage des suggestions appliqué au document.

Remarque : Lorsque vous modifiez un document, les modifications doivent être basées sur un document avec SUGGESTIONS_INLINE.

body

object (Body)

Uniquement en sortie. Corps principal du document.

Champ obsolète : utilisez plutôt Document.tabs.documentTab.body, qui expose le contenu réel du document à partir de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

headers

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

Uniquement en sortie. En-têtes du document, indexés par ID d'en-tête.

Champ obsolète : utilisez plutôt Document.tabs.documentTab.headers, qui expose le contenu réel du document à partir de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

footers

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

Uniquement en sortie. Pieds de page du document, identifiés par leur ID.

Champ obsolète : utilisez plutôt Document.tabs.documentTab.footers, qui expose le contenu réel du document à partir de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

footnotes

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

Uniquement en sortie. Notes de bas de page du document, identifiées par leur ID.

Champ obsolète : utilisez plutôt Document.tabs.documentTab.footnotes, qui expose le contenu réel du document à partir de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

documentStyle

object (DocumentStyle)

Uniquement en sortie. Style du document.

Champ obsolète : utilisez plutôt Document.tabs.documentTab.documentStyle, qui expose le contenu réel du document à partir de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

suggestedDocumentStyleChanges

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

Uniquement en sortie. Modifications suggérées au style du document, identifiées par l'ID de suggestion.

Champ obsolète : utilisez plutôt Document.tabs.documentTab.suggestedDocumentStyleChanges, qui expose le contenu réel du document à partir de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

namedStyles

object (NamedStyles)

Uniquement en sortie. Styles nommés du document.

Champ obsolète : utilisez plutôt Document.tabs.documentTab.namedStyles, qui expose le contenu réel du document à partir de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

suggestedNamedStylesChanges

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

Uniquement en sortie. Modifications suggérées pour les styles nommés du document, identifiées par ID de suggestion.

Champ obsolète : utilisez plutôt Document.tabs.documentTab.suggestedNamedStylesChanges, qui expose le contenu réel du document à partir de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

lists

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

Uniquement en sortie. Listes du document, indexées par ID de liste.

Champ obsolète : utilisez plutôt Document.tabs.documentTab.lists, qui expose le contenu réel du document à partir de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

namedRanges

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

Uniquement en sortie. Plages nommées dans le document, indexées par nom.

Champ obsolète : utilisez plutôt Document.tabs.documentTab.namedRanges, qui expose le contenu réel du document à partir de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

inlineObjects

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

Uniquement en sortie. Objets intégrés au document, indexés par ID d'objet.

Champ obsolète : utilisez plutôt Document.tabs.documentTab.inlineObjects, qui expose le contenu réel du document à partir de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

positionedObjects

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

Uniquement en sortie. Objets positionnés dans le document, identifiés par leur ID.

Champ obsolète : utilisez plutôt Document.tabs.documentTab.positionedObjects, qui expose le contenu réel du document à partir de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou non définie, ce champ contient des informations sur le premier onglet du document.

Tabulation

Un onglet dans un document.

Représentation JSON
{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

  // Union field content can be only one of the following:
  "documentTab": {
    object (DocumentTab)
  }
  // End of list of possible types for union field content.
}
Champs
tabProperties

object (TabProperties)

Propriétés de l'onglet, comme l'ID et le titre.

childTabs[]

object (Tab)

Onglets enfants imbriqués dans cet onglet.

Champ d'union content. Contenu de l'onglet. content ne peut être qu'un des éléments suivants :
documentTab

object (DocumentTab)

Un onglet contenant le contenu du document, comme du texte et des images.

TabProperties

Propriétés d'un onglet.

Représentation JSON
{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}
Champs
tabId

string

Uniquement en sortie. ID de l'onglet. Ce champ ne peut pas être modifié.

title

string

Nom de l'onglet visible par l'utilisateur.

parentTabId

string

Facultatif. ID de l'onglet parent. Vide lorsque l'onglet actuel est un onglet de niveau racine, ce qui signifie qu'il n'a pas de parent.

index

integer

Index basé sur zéro de l'onglet dans le parent.

nestingLevel

integer

Uniquement en sortie. Profondeur de l'onglet dans le document. Les onglets de niveau racine commencent à 0.

DocumentTab

Un onglet contenant le contenu d'un document.

Représentation JSON
{
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Champs
body

object (Body)

Corps principal de l'onglet du document.

headers

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

En-têtes de l'onglet du document, indexés par ID d'en-tête.

footers

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

Pieds de page dans l'onglet du document, identifiés par leur ID.

footnotes

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

Notes de bas de page dans l'onglet du document, identifiées par leur ID.

documentStyle

object (DocumentStyle)

Style de l'onglet du document.

suggestedDocumentStyleChanges

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

Modifications suggérées pour le style de l'onglet du document, identifiées par l'ID de suggestion.

namedStyles

object (NamedStyles)

Styles nommés de l'onglet du document.

suggestedNamedStylesChanges

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

Modifications suggérées aux styles nommés de l'onglet "Document", identifiées par ID de suggestion.

lists

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

Listes de l'onglet "Document", indexées par ID de liste.

namedRanges

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

Plages nommées dans l'onglet du document, indexées par nom.

inlineObjects

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

Objets intégrés dans l'onglet du document, indexés par ID d'objet.

positionedObjects

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

Objets positionnés dans l'onglet du document, avec l'ID de l'objet comme clé.

Body

Corps du document.

Le corps contient généralement l'intégralité du contenu du document, à l'exception de headers, footers et footnotes.

Représentation JSON
{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
Champs
content[]

object (StructuralElement)

Contenu du corps.

Les index du contenu du corps commencent à zéro.

StructuralElement

Un StructuralElement décrit le contenu qui structure le document.

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

  // Union field content can be only one of the following:
  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
  // End of list of possible types for union field content.
}
Champs
startIndex

integer

Index de début (basé sur zéro) de cet élément structurel, en unités de code UTF-16.

endIndex

integer

Index de fin (exclusif) de cet élément structurel, basé sur zéro, en unités de code UTF-16.

Champ d'union content. Contenu de l'élément structurel. content ne peut être qu'un des éléments suivants :
paragraph

object (Paragraph)

Type de paragraphe d'élément structurel.

sectionBreak

object (SectionBreak)

Type d'élément structurel de saut de section.

table

object (Table)

Type d'élément structurel de tableau.

tableOfContents

object (TableOfContents)

Élément structurel de type table des matières.

Paragraphe

StructuralElement représentant un paragraphe. Un paragraphe est une plage de contenu qui se termine par un caractère de nouvelle ligne.

Représentation JSON
{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}
Champs
elements[]

object (ParagraphElement)

Contenu du paragraphe, décomposé en ses éléments constitutifs.

paragraphStyle

object (ParagraphStyle)

Style de ce paragraphe.

suggestedParagraphStyleChanges

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

Le style de paragraphe suggéré est appliqué à ce paragraphe, identifié par l'ID de suggestion.

bullet

object (Bullet)

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

suggestedBulletChanges

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

Modifications suggérées pour la puce de ce paragraphe.

positionedObjectIds[]

string

ID des objets positionnés ancrés à ce paragraphe.

suggestedPositionedObjectIds

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

ID des objets positionnés suggérés à associer à ce paragraphe, avec l'ID de suggestion comme clé.

ParagraphElement

Un ParagraphElement décrit le contenu d'un Paragraph.

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

  // Union field content can be only one of the following:
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  },
  "pageBreak": {
    object (PageBreak)
  },
  "columnBreak": {
    object (ColumnBreak)
  },
  "footnoteReference": {
    object (FootnoteReference)
  },
  "horizontalRule": {
    object (HorizontalRule)
  },
  "equation": {
    object (Equation)
  },
  "inlineObjectElement": {
    object (InlineObjectElement)
  },
  "person": {
    object (Person)
  },
  "richLink": {
    object (RichLink)
  }
  // End of list of possible types for union field content.
}
Champs
startIndex

integer

Index de début (basé sur zéro) de cet élément de paragraphe, en unités de code UTF-16.

endIndex

integer

Index de fin (exclusif) de cet élément de paragraphe, basé sur zéro, en unités de code UTF-16.

Champ d'union content. Contenu de l'élément de paragraphe. content ne peut être qu'un des éléments suivants :
textRun

object (TextRun)

Élément de paragraphe d'exécution de texte.

autoText

object (AutoText)

Élément de paragraphe de texte automatique.

pageBreak

object (PageBreak)

Élément de paragraphe de saut de page.

columnBreak

object (ColumnBreak)

Élément de paragraphe de saut de colonne.

footnoteReference

object (FootnoteReference)

Élément de paragraphe de référence à une note de bas de page.

horizontalRule

object (HorizontalRule)

Élément de paragraphe de règle horizontale.

equation

object (Equation)

Élément de paragraphe d'équation.

inlineObjectElement

object (InlineObjectElement)

Élément de paragraphe d'objet intégré.

person

object (Person)

Élément de paragraphe qui renvoie à une personne ou à une adresse e-mail.

TextRun

Un ParagraphElement qui représente une série de texte dont le style est identique.

Représentation JSON
{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Champs
content

string

Texte de cette exécution.

Tous les éléments non textuels de l'exécution sont remplacés par le caractère Unicode U+E907.

suggestedInsertionIds[]

string

ID d'insertion suggérés. Un TextRun peut avoir plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

textStyle

object (TextStyle)

Style de texte de cette série.

suggestedTextStyleChanges

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

Les modifications suggérées du style de texte apportées à cette exécution, identifiées par l'ID de suggestion.

TextStyle

Représente le style pouvant être appliqué au texte.

Les styles de texte hérités sont représentés sous forme de champs non définis dans ce message. Le parent d'un style de texte dépend de l'endroit où le style de texte est défini :

  • Le TextStyle du texte d'un Paragraph hérite du named style type correspondant du paragraphe.
  • Le TextStyle d'un named style hérite du style nommé normal text.
  • Le TextStyle du style nommé normal text hérite du style de texte par défaut de l'éditeur Docs.
  • Le TextStyle d'un élément Paragraph contenu dans un tableau peut hériter du style de texte du tableau.

Si le style de texte n'hérite pas d'un parent, la suppression des champs rétablira un style correspondant aux valeurs par défaut de l'éditeur Docs.

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

boolean

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

italic

boolean

Indique si le texte est en italique ou non.

underline

boolean

Indique si le texte est souligné ou non.

strikethrough

boolean

Indique si le texte est barré.

smallCaps

boolean

Indique si le texte est en petites majuscules.

backgroundColor

object (OptionalColor)

Couleur d'arrière-plan du texte. Si elle est définie, la couleur est soit une couleur RVB, soit transparente, selon le champ color.

foregroundColor

object (OptionalColor)

Couleur de premier plan du texte. Si elle est définie, la couleur est soit une couleur RVB, soit transparente, selon le champ color.

fontSize

object (Dimension)

Taille de la police du texte.

weightedFontFamily

object (WeightedFontFamily)

Famille de polices et épaisseur du texte.

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 400 (requête incorrecte) est renvoyée.

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. Les modifications apportées à ce champ n'affectent pas le fontSize.

OptionalColor

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

Représentation JSON
{
  "color": {
    object (Color)
  }
}
Champs
color

object (Color)

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.

Couleur

Une couleur unie.

Représentation JSON
{
  "rgbColor": {
    object (RgbColor)
  }
}
Champs
rgbColor

object (RgbColor)

Valeur de couleur RVB.

RgbColor

Couleur RVB.

Représentation JSON
{
  "red": number,
  "green": number,
  "blue": number
}
Champs
red

number

Composant rouge de la couleur, de 0.0 à 1.0.

green

number

Composant vert de la couleur, de 0,0 à 1,0.

blue

number

Composant bleu de la couleur, de 0,0 à 1,0.

Dimension

Magnitude dans une seule direction, dans les unités spécifiées.

Représentation JSON
{
  "magnitude": number,
  "unit": enum (Unit)
}
Champs
magnitude

number

Magnitude.

unit

enum (Unit)

Unités de magnitude.

Unité

Unités de mesure.

Enums
UNIT_UNSPECIFIED Les unités sont inconnues.
PT Un point, soit 1/72 de pouce.

WeightedFontFamily

Représente une famille de polices et l'épaisseur du texte.

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 Docs ou de Google Fonts. Si le nom de la police n'est pas reconnu, le texte est affiché en Arial.

weight

integer

Épaisseur de la police. Ce champ peut contenir 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.

La valeur par défaut est 400 ("normal").

L'épaisseur de la police ne constitue qu'un seul composant de l'épaisseur de la police affichée. La combinaison de la valeur weight et de la valeur bold résolue du style de texte détermine l'épaisseur affichée, après prise en compte de l'héritage :

  • Si le texte est en gras et que la pondération est inférieure à 400, la pondération affichée est de 400.
  • Si le texte est en gras et que la pondération est supérieure ou égale à 400, mais inférieure à 700, la pondération affichée est 700.
  • Si le poids est supérieur ou égal à 700, le poids affiché est égal au poids.
  • Si le texte n'est pas en gras, la pondération affichée est égale à la pondération.

BaselineOffset

Différentes façons de décaler verticalement le texte 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).

SuggestedTextStyle

Modification suggérée pour un TextStyle.

Représentation JSON
{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
Champs
textStyle

object (TextStyle)

Un TextStyle qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec textStyleSuggestionState pour voir quels champs ont été modifiés et quelles sont leurs nouvelles valeurs.

textStyleSuggestionState

object (TextStyleSuggestionState)

Masque indiquant les champs de la TextStyle de base qui ont été modifiés dans cette suggestion.

TextStyleSuggestionState

Masque indiquant les champs de la TextStyle de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}
Champs
boldSuggested

boolean

Indique si une modification a été suggérée pour bold.

italicSuggested

boolean

Indique si une modification a été suggérée pour italic.

underlineSuggested

boolean

Indique si une modification a été suggérée pour underline.

strikethroughSuggested

boolean

Indique si une modification a été suggérée pour strikethrough.

smallCapsSuggested

boolean

Indique si une modification a été suggérée pour smallCaps.

backgroundColorSuggested

boolean

Indique si une modification a été suggérée pour backgroundColor.

foregroundColorSuggested

boolean

Indique si une modification a été suggérée pour foregroundColor.

fontSizeSuggested

boolean

Indique si une modification a été suggérée pour fontSize.

weightedFontFamilySuggested

boolean

Indique si une modification a été suggérée pour weightedFontFamily.

baselineOffsetSuggested

boolean

Indique si une modification a été suggérée pour baselineOffset.

AutoText

Un ParagraphElement représentant un emplacement dans le texte qui est remplacé de manière dynamique par du contenu pouvant changer au fil du temps, comme un numéro de page.

Représentation JSON
{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Champs
type

enum (Type)

Type de ce texte automatique.

suggestedInsertionIds[]

string

ID d'insertion suggérés. Un AutoText peut avoir plusieurs ID d'insertion s'il s'agit d'une modification suggérée imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

textStyle

object (TextStyle)

Style de texte de ce texte automatique.

suggestedTextStyleChanges

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

Le style de texte suggéré devient ce style AutoTexte, associé à l'ID de suggestion.

Type

Types de texte automatique.

Enums
TYPE_UNSPECIFIED Type de texte automatique non spécifié.
PAGE_NUMBER Saisissez le texte automatique qui représente le numéro de la page actuelle.
PAGE_COUNT Saisissez le texte automatique qui représente le nombre total de pages du document.

PageBreak

Un ParagraphElement représentant un saut de page. Un saut de page permet au texte suivant de commencer en haut de la page suivante.

Représentation JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Champs
suggestedInsertionIds[]

string

ID d'insertion suggérés. Un PageBreak peut avoir plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

textStyle

object (TextStyle)

Style de texte de ce PageBreak.

Comme pour le contenu textuel (par exemple, les séquences de texte et les références de notes de bas de page), le style de texte d'un saut de page peut avoir une incidence sur la mise en page du contenu, ainsi que sur le style du texte inséré à côté.

suggestedTextStyleChanges

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

Le style de texte suggéré passe à PageBreak, avec l'ID de suggestion comme clé.

ColumnBreak

ParagraphElement représentant un saut de colonne. Un saut de colonne permet au texte suivant de commencer en haut de la colonne suivante.

Représentation JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Champs
suggestedInsertionIds[]

string

ID d'insertion suggérés. Un ColumnBreak peut avoir plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

textStyle

object (TextStyle)

Style de texte de ce ColumnBreak.

Comme pour le contenu textuel (par exemple, les séquences de texte et les références de notes de bas de page), le style de texte d'un saut de colonne peut avoir une incidence sur la mise en page du contenu, ainsi que sur le style du texte inséré à côté.

suggestedTextStyleChanges

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

Le style de texte suggéré devient "ColumnBreak", avec l'ID de suggestion comme clé.

FootnoteReference

Un ParagraphElement représentant une référence à une note de bas de page. Une référence à une note de bas de page est un contenu intégré affiché avec un numéro et utilisé pour identifier la note de bas de page.

Représentation JSON
{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Champs
footnoteId

string

ID de l'élément footnote contenant le contenu de cette référence de note de bas de page.

footnoteNumber

string

Numéro de bas de page affiché.

suggestedInsertionIds[]

string

ID d'insertion suggérés. Un FootnoteReference peut avoir plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

textStyle

object (TextStyle)

Style de texte de cette FootnoteReference.

suggestedTextStyleChanges

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

Le style de texte suggéré devient FootnoteReference, avec l'ID de suggestion comme clé.

HorizontalRule

Un ParagraphElement représentant une ligne horizontale.

Représentation JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Champs
suggestedInsertionIds[]

string

ID d'insertion suggérés. Un HorizontalRule peut avoir plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

textStyle

object (TextStyle)

Style de texte de cette règle horizontale.

Comme pour le contenu textuel (par exemple, les séquences de texte et les références de notes de bas de page), le style de texte d'une règle horizontale peut avoir une incidence sur la mise en page du contenu, ainsi que sur le style du texte inséré à côté.

suggestedTextStyleChanges

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

Le style de texte suggéré devient cette HorizontalRule, avec l'ID de suggestion comme clé.

Équation

ParagraphElement représentant une équation.

Représentation JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
Champs
suggestedInsertionIds[]

string

ID d'insertion suggérés. Un Equation peut avoir plusieurs ID d'insertion s'il s'agit d'une modification suggérée imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

InlineObjectElement

Un ParagraphElement contenant un InlineObject.

Représentation JSON
{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Champs
inlineObjectId

string

ID du InlineObject contenu dans cet élément.

suggestedInsertionIds[]

string

ID d'insertion suggérés. Un InlineObjectElement peut avoir plusieurs ID d'insertion s'il s'agit d'une modification suggérée imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

textStyle

object (TextStyle)

Style de texte de cet InlineObjectElement.

Comme pour le contenu textuel (par exemple, les séquences de texte et les références de notes de bas de page), le style de texte d'un élément d'objet intégré peut affecter la mise en page du contenu ainsi que le style du texte inséré à côté.

suggestedTextStyleChanges

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

Le style de texte suggéré devient InlineObject, avec l'ID de suggestion comme clé.

Personne

Personne ou adresse e-mail mentionnée dans un document. Ces mentions se comportent comme un élément unique et immuable contenant le nom ou l'adresse e-mail de la personne.

Représentation JSON
{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}
Champs
personId

string

Uniquement en sortie. Identifiant unique de ce lien.

suggestedInsertionIds[]

string

ID des suggestions qui insèrent ce lien vers la personne dans le document. Un Person peut avoir plusieurs ID d'insertion s'il s'agit d'une modification suggérée imbriquée (une suggestion dans une suggestion faite par un autre utilisateur, par exemple). Si ce champ est vide, le lien vers la personne n'est pas une insertion suggérée.

suggestedDeletionIds[]

string

ID des suggestions qui suppriment le lien "cette personne" du document. Un Person peut avoir plusieurs ID de suppression si, par exemple, plusieurs utilisateurs suggèrent de le supprimer. Si ce champ est vide, le lien vers cette personne ne sera pas suggéré pour suppression.

textStyle

object (TextStyle)

Style de texte de ce Person.

suggestedTextStyleChanges

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

Le style de texte suggéré passe à Person, avec l'ID de suggestion comme clé.

personProperties

object (PersonProperties)

Uniquement en sortie. Propriétés de ce Person. Ce champ est toujours présent.

PersonProperties

Propriétés spécifiques à un Person associé.

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

string

Le nom de la personne s'il est affiché dans le texte du lien au lieu de son adresse e-mail.

email

string

Adresse e-mail associée à ce Person. Ce champ est toujours présent.

RichLinkProperties

Propriétés spécifiques à un RichLink.

Représentation JSON
{
  "title": string,
  "uri": string,
  "mimeType": string
}
Champs
title

string

Uniquement en sortie. Titre de RichLink tel qu'il apparaît dans le lien. Ce titre correspond à celui de la ressource associée au moment de l'insertion ou de la dernière mise à jour du lien. Ce champ est toujours présent.

uri

string

Uniquement en sortie. URI du RichLink. Cette valeur est toujours présente.

mimeType

string

Uniquement en sortie. Le type MIME de RichLink, le cas échéant (par exemple, lorsqu'il s'agit d'un fichier dans Drive).

ParagraphStyle

Styles qui s'appliquent à un paragraphe entier.

Les styles de paragraphe hérités sont représentés sous forme de champs non définis dans ce message. Le parent d'un style de paragraphe dépend de l'endroit où il est défini :

  • Le ParagraphStyle d'un Paragraph hérite du named style type correspondant du paragraphe.
  • Le ParagraphStyle d'un named style hérite du style nommé normal text.
  • Le ParagraphStyle du style nommé normal text hérite du style de paragraphe par défaut de l'éditeur Docs.
  • Le ParagraphStyle d'un élément Paragraph contenu dans un tableau peut hériter de son style de paragraphe à partir du style du tableau.

Si le style de paragraphe n'hérite pas d'un parent, la suppression des champs rétablira une valeur correspondant aux valeurs par défaut de l'éditeur Docs.

Représentation JSON
{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}
Champs
headingId

string

ID de titre du paragraphe. Si ce champ est vide, ce paragraphe n'est pas un titre.

Cette propriété est en lecture seule.

namedStyleType

enum (NamedStyleType)

Type de style nommé du paragraphe.

Étant donné que la mise à jour du type de style nommé affecte d'autres propriétés dans ParagraphStyle, le type de style nommé est appliqué avant la mise à jour des autres propriétés.

alignment

enum (Alignment)

Alignement du texte pour ce paragraphe.

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.

direction

enum (ContentDirection)

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 paragraphe n'est pas hérité.

spacingMode

enum (SpacingMode)

Mode d'espacement du paragraphe.

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.

borderBetween

object (ParagraphBorder)

Bordure entre ce paragraphe et les paragraphes suivants et précédents. Si elle n'est pas définie, la valeur est héritée du parent.

La bordure intermédiaire s'affiche lorsque le paragraphe adjacent possède les mêmes propriétés de bordure et d'indentation.

Les bordures de paragraphe ne peuvent pas être mises à jour partiellement. Lorsque vous modifiez une bordure de paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

borderTop

object (ParagraphBorder)

Bordure en haut de ce paragraphe. Si elle n'est pas définie, la valeur est héritée du parent.

La bordure supérieure s'affiche lorsque le paragraphe précédent présente des propriétés de bordure et de retrait différentes.

Les bordures de paragraphe ne peuvent pas être mises à jour partiellement. Lorsque vous modifiez une bordure de paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

borderBottom

object (ParagraphBorder)

Bordure en bas de ce paragraphe. Si elle n'est pas définie, la valeur est héritée du parent.

La bordure inférieure est affichée lorsque le paragraphe ci-dessous présente des propriétés de bordure et d'indentation différentes.

Les bordures de paragraphe ne peuvent pas être mises à jour partiellement. Lorsque vous modifiez une bordure de paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

borderLeft

object (ParagraphBorder)

Bordure à gauche de ce paragraphe. Si elle n'est pas définie, la valeur est héritée du parent.

Les bordures de paragraphe ne peuvent pas être mises à jour partiellement. Lorsque vous modifiez une bordure de paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

borderRight

object (ParagraphBorder)

Bordure à droite de ce paragraphe. Si elle n'est pas définie, la valeur est héritée du parent.

Les bordures de paragraphe ne peuvent pas être mises à jour partiellement. Lorsque vous modifiez une bordure de paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

indentFirstLine

object (Dimension)

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

indentStart

object (Dimension)

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

indentEnd

object (Dimension)

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

tabStops[]

object (TabStop)

Liste des taquets de tabulation pour ce paragraphe. La liste des taquets de tabulation n'est pas héritée.

Cette propriété est en lecture seule.

keepLinesTogether

boolean

Indique si toutes les lignes du paragraphe doivent être mises en page sur la même page ou colonne, si possible. Si elle n'est pas définie, la valeur est héritée du parent.

keepWithNext

boolean

Indique si au moins une partie de ce paragraphe doit être mise en page sur la même page ou colonne que le paragraphe suivant, si possible. Si elle n'est pas définie, la valeur est héritée du parent.

avoidWidowAndOrphan

boolean

Indique s'il faut éviter les veuves et les orphelines pour le paragraphe. Si elle n'est pas définie, la valeur est héritée du parent.

shading

object (Shading)

Ombre du paragraphe. Si elle n'est pas définie, la valeur est héritée du parent.

pageBreakBefore

boolean

Indique si le paragraphe actuel doit toujours commencer au début d'une page. Si elle n'est pas définie, la valeur est héritée du parent.

Toute tentative de mise à jour de pageBreakBefore pour des paragraphes dans des régions non prises en charge, y compris Table, Header, Footer et Footnote, peut entraîner un état de document non valide qui renvoie une erreur 400 (mauvaise requête).

NamedStyleType

Types de styles nommés.

Enums
NAMED_STYLE_TYPE_UNSPECIFIED Le type de style nommé n'est pas spécifié.
NORMAL_TEXT Texte normal.
TITLE et le titre.
SUBTITLE Sous-titre.
HEADING_1 Titre 1.
HEADING_2 Titre 2.
HEADING_3 Titre 3.
HEADING_4 Titre 4.
HEADING_5 Titre 5.
HEADING_6 Titre 6.

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é sur la fin de la ligne. Aligné à droite pour le texte LTR, aligné à gauche dans le cas contraire.
JUSTIFIED Le paragraphe est justifié.

ContentDirection

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

Enums
CONTENT_DIRECTION_UNSPECIFIED Le sens du contenu n'est pas spécifié.
LEFT_TO_RIGHT Le contenu va de gauche à droite.
RIGHT_TO_LEFT Le contenu 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.

ParagraphBorder

Bordure autour d'un paragraphe.

Représentation JSON
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
Champs
color

object (OptionalColor)

Couleur de la bordure.

width

object (Dimension)

Largeur de la bordure.

padding

object (Dimension)

Marge intérieure de la bordure.

dashStyle

enum (DashStyle)

Style de tirets de la bordure.

DashStyle

Types de tirets avec lesquels la géométrie linéaire peut être affichée. Ces valeurs sont basées sur le type simple "ST_PresetLineDashVal" décrit dans la section 20.1.10.49 de "Office Open XML File Formats - Fundamentals and Markup Language Reference", partie 1 de ECMA-376 5e édition.

Enums
DASH_STYLE_UNSPECIFIED Style de tiret non spécifié.
SOLID Ligne continue. Correspond à la valeur "solid" de ECMA-376 ST_PresetLineDashVal. Il s'agit du style de tiret par défaut.
DOT Ligne en pointillés. Correspond à la valeur "dot" de ECMA-376 ST_PresetLineDashVal.
DASH Ligne en pointillés. Correspond à la valeur "dash" de ECMA-376 ST_PresetLineDashVal.

TabStop

Taquet de tabulation dans un paragraphe.

Représentation JSON
{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}
Champs
offset

object (Dimension)

Décalage entre cette taquet de tabulation et la marge de début.

alignment

enum (TabStopAlignment)

L'alignement de cette taquet de tabulation. Si elle n'est pas définie, la valeur par défaut est START.

TabStopAlignment

Alignement du taquet de tabulation.

Enums
TAB_STOP_ALIGNMENT_UNSPECIFIED L'alignement de la tabulation n'est pas spécifié.
START La taquet de tabulation est aligné sur le début de la ligne. Il s'agit de la valeur par défaut.
CENTER La taquet de tabulation est aligné au centre de la ligne.
END La taquet de tabulation est aligné sur la fin de la ligne.

Ombrage

Ombre d'un paragraphe.

Représentation JSON
{
  "backgroundColor": {
    object (OptionalColor)
  }
}
Champs
backgroundColor

object (OptionalColor)

Couleur d'arrière-plan de l'ombrage de ce paragraphe.

SuggestedParagraphStyle

Modification suggérée pour un ParagraphStyle.

Représentation JSON
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
Champs
paragraphStyle

object (ParagraphStyle)

Un ParagraphStyle qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec paragraphStyleSuggestionState pour voir quels champs ont été modifiés et quelles sont leurs nouvelles valeurs.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Masque indiquant les champs de la ParagraphStyle de base qui ont été modifiés dans cette suggestion.

ParagraphStyleSuggestionState

Masque indiquant les champs de la ParagraphStyle de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "headingIdSuggested": boolean,
  "namedStyleTypeSuggested": boolean,
  "alignmentSuggested": boolean,
  "lineSpacingSuggested": boolean,
  "directionSuggested": boolean,
  "spacingModeSuggested": boolean,
  "spaceAboveSuggested": boolean,
  "spaceBelowSuggested": boolean,
  "borderBetweenSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "indentEndSuggested": boolean,
  "keepLinesTogetherSuggested": boolean,
  "keepWithNextSuggested": boolean,
  "avoidWidowAndOrphanSuggested": boolean,
  "shadingSuggestionState": {
    object (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}
Champs
headingIdSuggested

boolean

Indique si une modification a été suggérée pour headingId.

namedStyleTypeSuggested

boolean

Indique si une modification a été suggérée pour namedStyleType.

alignmentSuggested

boolean

Indique si une modification a été suggérée pour alignment.

lineSpacingSuggested

boolean

Indique si une modification a été suggérée pour lineSpacing.

directionSuggested

boolean

Indique si une modification a été suggérée pour direction.

spacingModeSuggested

boolean

Indique si une modification a été suggérée pour spacingMode.

spaceAboveSuggested

boolean

Indique si une modification a été suggérée pour spaceAbove.

spaceBelowSuggested

boolean

Indique si une modification a été suggérée pour spaceBelow.

borderBetweenSuggested

boolean

Indique si une modification a été suggérée pour borderBetween.

borderTopSuggested

boolean

Indique si une modification a été suggérée pour borderTop.

borderBottomSuggested

boolean

Indique si une modification a été suggérée pour borderBottom.

borderLeftSuggested

boolean

Indique si une modification a été suggérée pour borderLeft.

borderRightSuggested

boolean

Indique si une modification a été suggérée pour borderRight.

indentFirstLineSuggested

boolean

Indique si une modification a été suggérée pour indentFirstLine.

indentStartSuggested

boolean

Indique si une modification a été suggérée pour indentStart.

indentEndSuggested

boolean

Indique si une modification a été suggérée pour indentEnd.

keepLinesTogetherSuggested

boolean

Indique si une modification a été suggérée pour keepLinesTogether.

keepWithNextSuggested

boolean

Indique si une modification a été suggérée pour keepWithNext.

avoidWidowAndOrphanSuggested

boolean

Indique si une modification a été suggérée pour avoidWidowAndOrphan.

shadingSuggestionState

object (ShadingSuggestionState)

Masque indiquant les champs de shading qui ont été modifiés dans cette suggestion.

pageBreakBeforeSuggested

boolean

Indique si une modification a été suggérée pour pageBreakBefore.

ShadingSuggestionState

Masque indiquant les champs de la base Shading qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "backgroundColorSuggested": boolean
}
Champs
backgroundColorSuggested

boolean

Indique si une modification a été suggérée pour le Shading.

Puces

Décrit la puce d'un paragraphe.

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

string

ID de la liste à laquelle appartient ce paragraphe.

nestingLevel

integer

Niveau d'imbrication de ce paragraphe dans la liste.

textStyle

object (TextStyle)

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

SuggestedBullet

Modification suggérée pour un Bullet.

Représentation JSON
{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}
Champs
bullet

object (Bullet)

Un Bullet qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec bulletSuggestionState pour voir quels champs ont été modifiés et quelles sont leurs nouvelles valeurs.

bulletSuggestionState

object (BulletSuggestionState)

Masque indiquant les champs de la Bullet de base qui ont été modifiés dans cette suggestion.

BulletSuggestionState

Masque indiquant les champs de la Bullet de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
Champs
listIdSuggested

boolean

Indique si une modification a été suggérée pour le listId.

nestingLevelSuggested

boolean

Indique si une modification a été suggérée pour le nestingLevel.

textStyleSuggestionState

object (TextStyleSuggestionState)

Masque indiquant les champs de text style qui ont été modifiés dans cette suggestion.

ObjectReferences

Collection d'ID d'objets.

Représentation JSON
{
  "objectIds": [
    string
  ]
}
Champs
objectIds[]

string

ID des objets.

SectionBreak

StructuralElement représentant un saut de section. Une section est une plage de contenu qui possède le même SectionStyle. Un saut de section marque le début d'une nouvelle section. Le style de section s'applique à la section qui suit le saut de section.

Le corps du document commence toujours par un saut de section.

Représentation JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}
Champs
suggestedInsertionIds[]

string

ID d'insertion suggérés. Un SectionBreak peut avoir plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

sectionStyle

object (SectionStyle)

Style de la section après ce saut de section.

SectionStyle

Style qui s'applique à une section.

Représentation JSON
{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}
Champs
columnProperties[]

object (SectionColumnProperties)

Propriétés des colonnes de la section.

Si elle est vide, la section contient une colonne avec les propriétés par défaut de l'éditeur Docs. Une section peut être mise à jour pour ne pas comporter plus de trois colonnes.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 (requête incorrecte) se produira.

columnSeparatorStyle

enum (ColumnSeparatorStyle)

Style des séparateurs de colonnes.

Ce style peut être défini même si la section ne comporte qu'une seule colonne.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 (requête incorrecte) se produit.

contentDirection

enum (ContentDirection)

Direction du contenu de cette section. Si elle n'est pas définie, la valeur par défaut est LEFT_TO_RIGHT.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 (requête incorrecte) se produit.

marginTop

object (Dimension)

Marge supérieure de la section. Si elle n'est pas définie, la valeur par défaut est marginTop à partir de DocumentStyle.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 (requête incorrecte) se produit.

marginBottom

object (Dimension)

Marge inférieure de la page de la section. Si elle n'est pas définie, la valeur par défaut est marginBottom à partir de DocumentStyle.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 (requête incorrecte) se produit.

marginRight

object (Dimension)

Marge de droite de la section. Si elle n'est pas définie, la valeur par défaut est marginRight à partir de DocumentStyle. La modification de la marge de droite entraîne le redimensionnement des colonnes de cette section. Comme la marge affecte la largeur des colonnes, elle est appliquée avant les propriétés des colonnes.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 (requête incorrecte) se produit.

marginLeft

object (Dimension)

Marge de gauche de la section. Si elle n'est pas définie, la valeur par défaut est marginLeft à partir de DocumentStyle. La modification de la marge de gauche entraîne le redimensionnement des colonnes de cette section. Comme la marge affecte la largeur des colonnes, elle est appliquée avant les propriétés des colonnes.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 (requête incorrecte) se produit.

marginHeader

object (Dimension)

Marge de l'en-tête de la section. Si elle n'est pas définie, la valeur par défaut est marginHeader à partir de DocumentStyle. Si la valeur est mise à jour, useCustomHeaderFooterMargins est défini sur "true" dans DocumentStyle. La valeur de useCustomHeaderFooterMargins sur DocumentStyle indique si une marge d'en-tête est respectée pour cette section.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 (requête incorrecte) se produit.

sectionType

enum (SectionType)

Uniquement en sortie. Type de section.

defaultHeaderId

string

ID de l'en-tête par défaut. Si elle n'est pas définie, la valeur hérite de la valeur SectionBreak's SectionStyle précédente. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de defaultHeaderId de DocumentStyle.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Cette propriété est en lecture seule.

firstPageHeaderId

string

ID de l'en-tête utilisé uniquement pour la première page de la section. Si useFirstPageHeaderFooter est défini sur "true", cette valeur est utilisée pour l'en-tête de la première page de la section. Si la valeur est "false", l'en-tête de la première page de la section utilise defaultHeaderId. Si elle n'est pas définie, la valeur hérite de la valeur SectionBreak's SectionStyle précédente. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de firstPageHeaderId de DocumentStyle.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Cette propriété est en lecture seule.

evenPageHeaderId

string

ID de l'en-tête utilisé uniquement pour les pages paires. Si la valeur de useEvenPageHeaderFooter de DocumentStyle est "true", cette valeur est utilisée pour les en-têtes des pages paires de la section. Si la valeur est "false", les en-têtes des pages paires utilisent defaultHeaderId. Si elle n'est pas définie, la valeur hérite de la valeur SectionBreak's SectionStyle précédente. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de evenPageHeaderId de DocumentStyle.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Cette propriété est en lecture seule.

pageNumberStart

integer

Numéro de page à partir duquel commencer à compter le nombre de pages pour cette section. Si cette option n'est pas définie, la numérotation des pages continue à partir de la section précédente. Si la valeur n'est pas définie dans le premier SectionBreak, consultez pageNumberStart de DocumentStyle.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 (requête incorrecte) se produit.

flipPageOrientation

boolean

Facultatif. Indique s'il faut inverser les dimensions de pageSize de DocumentStyle pour cette section, ce qui permet de modifier l'orientation de la page entre portrait et paysage. Si elle n'est pas définie, la valeur est héritée de flipPageOrientation de DocumentStyle.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 (requête incorrecte) se produit.

SectionColumnProperties

Propriétés qui s'appliquent à la colonne d'une section.

Représentation JSON
{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}
Champs
width

object (Dimension)

Uniquement en sortie. Largeur de la colonne.

paddingEnd

object (Dimension)

Marge intérieure à la fin de la colonne.

ColumnSeparatorStyle

Style des séparateurs de colonnes.

Enums
COLUMN_SEPARATOR_STYLE_UNSPECIFIED Style de séparateur de colonnes non spécifié.
NONE Aucune ligne de séparation entre les colonnes.
BETWEEN_EACH_COLUMN Affiche une ligne de séparation entre chaque colonne.

SectionType

Représente la position du début de la section actuelle par rapport à la section précédente.

Enums
SECTION_TYPE_UNSPECIFIED Le type de section n'est pas spécifié.
CONTINUOUS La section commence immédiatement après le dernier paragraphe de la section précédente.
NEXT_PAGE La section commence sur la page suivante.

Tableau

Un StructuralElement représentant un tableau.

Représentation JSON
{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}
Champs
rows

integer

Nombre de lignes dans la table.

columns

integer

Nombre de colonnes dans le tableau.

Il est possible qu'un tableau ne soit pas rectangulaire. Certaines lignes peuvent donc comporter un nombre de cellules différent.

tableRows[]

object (TableRow)

Le contenu et le style de chaque ligne.

suggestedInsertionIds[]

string

ID d'insertion suggérés. Un Table peut avoir plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

tableStyle

object (TableStyle)

Style du tableau.

Ligne de tableau

Contenu et style d'une ligne dans un Table.

Représentation JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}
Champs
startIndex

integer

Index de début de cette ligne (basé sur zéro), en unités de code UTF-16.

endIndex

integer

Index de fin (exclusif) de cette ligne, basé sur zéro, en unités de code UTF-16.

tableCells[]

object (TableCell)

Contenu et style de chaque cellule de cette ligne.

Il est possible qu'un tableau ne soit pas rectangulaire. Certaines lignes peuvent donc comporter un nombre de cellules différent de celui des autres lignes du même tableau.

suggestedInsertionIds[]

string

ID d'insertion suggérés. Un TableRow peut avoir plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

tableRowStyle

object (TableRowStyle)

Style de la ligne du tableau.

suggestedTableRowStyleChanges

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

Les modifications de style suggérées pour cette ligne, identifiées par l'ID de suggestion.

TableCell

Contenu et style d'une cellule dans un Table.

Représentation JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}
Champs
startIndex

integer

Index de début (basé sur zéro) de cette cellule, en unités de code UTF-16.

endIndex

integer

Index de fin (exclusif) de cette cellule, basé sur zéro, en unités de code UTF-16.

content[]

object (StructuralElement)

Contenu de la cellule.

tableCellStyle

object (TableCellStyle)

Style de la cellule.

suggestedInsertionIds[]

string

ID d'insertion suggérés. Un TableCell peut avoir plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

suggestedTableCellStyleChanges

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

Modifications suggérées au style de la cellule du tableau, identifiées par l'ID de la suggestion.

TableCellStyle

Style d'une TableCell.

Les styles de cellules de tableau hérités sont représentés sous forme de champs non définis dans ce message. Le style d'une cellule de tableau peut hériter du style du tableau.

Représentation JSON
{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}
Champs
rowSpan

integer

Nombre de lignes couvertes par la cellule.

Cette propriété est en lecture seule.

columnSpan

integer

Portée de la colonne de la cellule.

Cette propriété est en lecture seule.

backgroundColor

object (OptionalColor)

Couleur d'arrière-plan de la cellule.

borderLeft

object (TableCellBorder)

Bordure gauche de la cellule.

borderRight

object (TableCellBorder)

Bordure droite de la cellule.

borderTop

object (TableCellBorder)

Bordure supérieure de la cellule.

borderBottom

object (TableCellBorder)

Bordure inférieure de la cellule.

paddingLeft

object (Dimension)

Marge intérieure gauche de la cellule.

paddingRight

object (Dimension)

Marge intérieure droite de la cellule.

paddingTop

object (Dimension)

Marge intérieure supérieure de la cellule.

paddingBottom

object (Dimension)

Marge intérieure inférieure de la cellule.

contentAlignment

enum (ContentAlignment)

Alignement du contenu dans la cellule du tableau. L'alignement par défaut correspond à celui des cellules de tableau nouvellement créées dans l'éditeur Docs.

TableCellBorder

Bordure autour d'une cellule de tableau.

Les bordures des cellules de tableau ne peuvent pas être transparentes. Pour masquer la bordure d'une cellule de tableau, définissez sa largeur sur 0.

Représentation JSON
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
Champs
color

object (OptionalColor)

Couleur de la bordure.

Cette couleur ne peut pas être transparente.

width

object (Dimension)

Largeur de la bordure.

dashStyle

enum (DashStyle)

Style de tirets de la bordure.

ContentAlignment

Types d'alignement de contenu.

Dérivé d'un sous-ensemble des valeurs du type simple "ST_TextAnchoringType" dans la section 20.1.10.60 de "Office Open XML File Formats - Fundamentals and Markup Language Reference", partie 1 de ECMA-376 5e édition.

Enums
CONTENT_ALIGNMENT_UNSPECIFIED Alignement de contenu non spécifié. L'alignement du contenu est hérité du parent, le cas échéant.
CONTENT_ALIGNMENT_UNSUPPORTED Alignement de contenu non accepté.
TOP Alignement qui aligne le contenu en haut du conteneur de contenu. Correspond à ECMA-376 ST_TextAnchoringType "t".
MIDDLE Alignement qui aligne le contenu au centre du conteneur de contenu. Correspond à ECMA-376 ST_TextAnchoringType "ctr".
BOTTOM Alignement qui aligne le contenu en bas du conteneur de contenu. Correspond à ECMA-376 ST_TextAnchoringType "b".

SuggestedTableCellStyle

Modification suggérée pour un TableCellStyle.

Représentation JSON
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}
Champs
tableCellStyle

object (TableCellStyle)

Un TableCellStyle qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec tableCellStyleSuggestionState pour voir quels champs ont été modifiés et quelles sont leurs nouvelles valeurs.

tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

Masque indiquant les champs de la TableCellStyle de base qui ont été modifiés dans cette suggestion.

TableCellStyleSuggestionState

Masque indiquant les champs de la TableCellStyle de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}
Champs
rowSpanSuggested

boolean

Indique si une modification a été suggérée pour rowSpan.

columnSpanSuggested

boolean

Indique si une modification a été suggérée pour columnSpan.

backgroundColorSuggested

boolean

Indique si une modification a été suggérée pour backgroundColor.

borderLeftSuggested

boolean

Indique si une modification a été suggérée pour borderLeft.

borderRightSuggested

boolean

Indique si une modification a été suggérée pour borderRight.

borderTopSuggested

boolean

Indique si une modification a été suggérée pour borderTop.

borderBottomSuggested

boolean

Indique si une modification a été suggérée pour borderBottom.

paddingLeftSuggested

boolean

Indique si une modification a été suggérée pour paddingLeft.

paddingRightSuggested

boolean

Indique si une modification a été suggérée pour paddingRight.

paddingTopSuggested

boolean

Indique si une modification a été suggérée pour paddingTop.

paddingBottomSuggested

boolean

Indique si une modification a été suggérée pour paddingBottom.

contentAlignmentSuggested

boolean

Indique si une modification a été suggérée pour contentAlignment.

TableRowStyle

Styles qui s'appliquent à une ligne de tableau.

Représentation JSON
{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}
Champs
minRowHeight

object (Dimension)

Hauteur minimale de la ligne. La ligne sera affichée dans l'éditeur Docs à une hauteur égale ou supérieure à cette valeur afin de montrer tout le contenu des cellules de la ligne.

tableHeader

boolean

Indique si la ligne est un en-tête de tableau.

preventOverflow

boolean

Indique si la ligne ne peut pas déborder au-delà des limites de la page ou de la colonne.

SuggestedTableRowStyle

Modification suggérée pour un TableRowStyle.

Représentation JSON
{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}
Champs
tableRowStyle

object (TableRowStyle)

Un TableRowStyle qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec tableRowStyleSuggestionState pour voir quels champs ont été modifiés et quelles sont leurs nouvelles valeurs.

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

Masque indiquant les champs de la TableRowStyle de base qui ont été modifiés dans cette suggestion.

TableRowStyleSuggestionState

Masque indiquant les champs de la TableRowStyle de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "minRowHeightSuggested": boolean
}
Champs
minRowHeightSuggested

boolean

Indique si une modification a été suggérée pour minRowHeight.

TableStyle

Styles qui s'appliquent à un tableau.

Représentation JSON
{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Champs
tableColumnProperties[]

object (TableColumnProperties)

Propriétés de chaque colonne.

Notez que dans Docs, les tableaux contiennent des lignes et les lignes contiennent des cellules, comme en HTML. Les propriétés d'une ligne se trouvent donc dans le tableRowStyle de la ligne.

TableColumnProperties

Propriétés d'une colonne dans un tableau.

Représentation JSON
{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}
Champs
widthType

enum (WidthType)

Type de largeur de la colonne.

width

object (Dimension)

Largeur de la colonne. Défini lorsque widthType de la colonne est FIXED_WIDTH.

WidthType

Type de largeur de la colonne.

Enums
WIDTH_TYPE_UNSPECIFIED Le type de largeur de colonne n'est pas spécifié.
EVENLY_DISTRIBUTED

La largeur de la colonne est répartie de manière égale entre les autres colonnes de même largeur.

La largeur de la colonne est déterminée automatiquement. Elle correspond à une part égale de la largeur restante du tableau, après prise en compte de toutes les colonnes dont la largeur est spécifiée.

FIXED_WIDTH Largeur de colonne fixe. La propriété [width]google.apps.docs.v1.TableColumnProperties.width contient la largeur de la colonne.

TableOfContents

StructuralElement représentant une table des matières.

Représentation JSON
{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
Champs
content[]

object (StructuralElement)

Contenu de la table des matières.

suggestedInsertionIds[]

string

ID d'insertion suggérés. Un TableOfContents peut avoir plusieurs ID d'insertion s'il s'agit d'une suggestion de modification imbriquée. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

Note de bas de page

Note de bas de page d'un document.

Représentation JSON
{
  "footnoteId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
Champs
footnoteId

string

ID de la note de bas de page.

content[]

object (StructuralElement)

Contenu de la note de bas de page.

Les index du contenu d'une note de bas de page commencent à zéro.

DocumentStyle

Style du document.

Représentation JSON
{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean,
  "documentFormat": {
    object (DocumentFormat)
  }
}
Champs
background

object (Background)

L'arrière-plan du document. Les documents ne peuvent pas avoir de couleur d'arrière-plan transparente.

defaultHeaderId

string

ID de l'en-tête par défaut. Si ce champ n'est pas défini, il n'y a pas d'en-tête par défaut.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Cette propriété est en lecture seule.

evenPageHeaderId

string

ID de l'en-tête utilisé uniquement pour les pages paires. La valeur de useEvenPageHeaderFooter détermine s'il faut utiliser defaultHeaderId ou cette valeur pour l'en-tête des pages paires. Si ce champ n'est pas défini, il n'y a pas d'en-tête pour les pages paires.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Cette propriété est en lecture seule.

firstPageHeaderId

string

ID de l'en-tête utilisé uniquement pour la première page. Si ce champ n'est pas défini, cela signifie qu'il n'existe pas d'en-tête unique pour la première page. La valeur de useFirstPageHeaderFooter détermine s'il faut utiliser defaultHeaderId ou cette valeur pour l'en-tête de la première page. Si ce champ n'est pas défini, aucun en-tête de première page n'est affiché.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

Cette propriété est en lecture seule.

pageNumberStart

integer

Numéro de la page à partir de laquelle le nombre de pages doit être comptabilisé.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

marginTop

object (Dimension)

Marge supérieure de la page.

Si vous modifiez la marge supérieure de la page dans le style du document, la marge supérieure de la page est effacée dans tous les styles de section.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

marginBottom

object (Dimension)

Marge inférieure de la page.

Si vous modifiez la marge inférieure de la page dans le style du document, elle sera supprimée dans tous les styles de section.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

marginRight

object (Dimension)

Marge de droite de la page.

Si vous modifiez la marge de droite dans le style du document, elle sera supprimée dans tous les styles de section. Cela peut également entraîner le redimensionnement des colonnes dans toutes les sections.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

marginLeft

object (Dimension)

Marge de gauche de la page.

Si vous modifiez la marge de gauche de la page dans le style du document, la marge de gauche de la page est effacée dans tous les styles de section. Cela peut également entraîner le redimensionnement des colonnes dans toutes les sections.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

pageSize

object (Size)

Taille d'une page du document.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

marginHeader

object (Dimension)

Quantité d'espace entre le haut de la page et le contenu de l'en-tête.

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

flipPageOrientation

boolean

Facultatif. Indique s'il faut inverser les dimensions du pageSize, ce qui permet de modifier l'orientation de la page (portrait ou paysage).

Si [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] est défini sur PAGELESS, cette propriété ne sera pas affichée.

documentFormat

object (DocumentFormat)

Spécifie les paramètres de format au niveau du document, tels que le mode du document (pages ou sans pages).

Arrière-plan

Représente l'arrière-plan d'un document.

Représentation JSON
{
  "color": {
    object (OptionalColor)
  }
}
Champs
color

object (OptionalColor)

Couleur de l'arrière-plan.

Taille

une largeur et une hauteur ;

Représentation JSON
{
  "height": {
    object (Dimension)
  },
  "width": {
    object (Dimension)
  }
}
Champs
height

object (Dimension)

Hauteur de l'objet.

width

object (Dimension)

Largeur de l'objet.

DocumentFormat

Représente les paramètres de format au niveau du document.

Représentation JSON
{
  "documentMode": enum (DocumentMode)
}
Champs
documentMode

enum (DocumentMode)

Indique si le document comporte des pages ou non.

DocumentMode

Indique si le document comporte des pages ou non.

Enums
DOCUMENT_MODE_UNSPECIFIED Le mode du document n'est pas spécifié.
PAGES Le document comporte des pages.
PAGELESS Le document est au format sans pages.

SuggestedDocumentStyle

Modification suggérée pour DocumentStyle.

Représentation JSON
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "documentStyleSuggestionState": {
    object (DocumentStyleSuggestionState)
  }
}
Champs
documentStyle

object (DocumentStyle)

Un DocumentStyle qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec documentStyleSuggestionState pour voir quels champs ont été modifiés et quelles sont leurs nouvelles valeurs.

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

Masque indiquant les champs de la DocumentStyle de base qui ont été modifiés dans cette suggestion.

DocumentStyleSuggestionState

Masque indiquant les champs de la DocumentStyle de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "backgroundSuggestionState": {
    object (BackgroundSuggestionState)
  },
  "defaultHeaderIdSuggested": boolean,
  "defaultFooterIdSuggested": boolean,
  "evenPageHeaderIdSuggested": boolean,
  "evenPageFooterIdSuggested": boolean,
  "firstPageHeaderIdSuggested": boolean,
  "firstPageFooterIdSuggested": boolean,
  "useFirstPageHeaderFooterSuggested": boolean,
  "useEvenPageHeaderFooterSuggested": boolean,
  "pageNumberStartSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginLeftSuggested": boolean,
  "pageSizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginHeaderSuggested": boolean,
  "marginFooterSuggested": boolean,
  "useCustomHeaderFooterMarginsSuggested": boolean,
  "flipPageOrientationSuggested": boolean
}
Champs
backgroundSuggestionState

object (BackgroundSuggestionState)

Masque indiquant les champs de background qui ont été modifiés dans cette suggestion.

defaultHeaderIdSuggested

boolean

Indique si une modification a été suggérée pour defaultHeaderId.

evenPageHeaderIdSuggested

boolean

Indique si une modification a été suggérée pour evenPageHeaderId.

firstPageHeaderIdSuggested

boolean

Indique si une modification a été suggérée pour firstPageHeaderId.

pageNumberStartSuggested

boolean

Indique si une modification a été suggérée pour pageNumberStart.

marginTopSuggested

boolean

Indique si une modification a été suggérée pour marginTop.

marginBottomSuggested

boolean

Indique si une modification a été suggérée pour marginBottom.

marginRightSuggested

boolean

Indique si une modification a été suggérée pour marginRight.

marginLeftSuggested

boolean

Indique si une modification a été suggérée pour marginLeft.

pageSizeSuggestionState

object (SizeSuggestionState)

Masque indiquant les champs de [size] [google.apps.docs.v1.DocumentStyle.size] qui ont été modifiés dans cette suggestion.

marginHeaderSuggested

boolean

Indique si une modification a été suggérée pour marginHeader.

flipPageOrientationSuggested

boolean

Facultatif. Indique si une modification a été suggérée pour flipPageOrientation.

BackgroundSuggestionState

Masque indiquant les champs de la Background de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", la valeur Backgound a une nouvelle valeur suggérée.

Représentation JSON
{
  "backgroundColorSuggested": boolean
}
Champs
backgroundColorSuggested

boolean

Indique si la couleur d'arrière-plan actuelle a été modifiée dans cette suggestion.

SizeSuggestionState

Masque indiquant les champs de la Size de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", la valeur Size a une nouvelle valeur suggérée.

Représentation JSON
{
  "heightSuggested": boolean,
  "widthSuggested": boolean
}
Champs
heightSuggested

boolean

Indique si une modification a été suggérée pour height.

widthSuggested

boolean

Indique si une modification a été suggérée pour width.

NamedStyles

Styles nommés. Les paragraphes du document peuvent hériter de leur TextStyle et de leur ParagraphStyle à partir de ces styles nommés.

Représentation JSON
{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}
Champs
styles[]

object (NamedStyle)

Styles nommés.

Il existe une entrée pour chaque named style types possible.

NamedStyle

Style nommé. Les paragraphes du document peuvent hériter de leur TextStyle et de leur ParagraphStyle de ce style nommé lorsqu'ils ont le même type de style nommé.

Représentation JSON
{
  "namedStyleType": enum (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}
Champs
namedStyleType

enum (NamedStyleType)

Type de ce style nommé.

textStyle

object (TextStyle)

Style de texte de ce style nommé.

paragraphStyle

object (ParagraphStyle)

Style de paragraphe de ce style nommé.

SuggestedNamedStyles

Modification suggérée pour NamedStyles.

Représentation JSON
{
  "namedStyles": {
    object (NamedStyles)
  },
  "namedStylesSuggestionState": {
    object (NamedStylesSuggestionState)
  }
}
Champs
namedStyles

object (NamedStyles)

Un NamedStyles qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec namedStylesSuggestionState pour voir quels champs ont été modifiés et quelles sont leurs nouvelles valeurs.

namedStylesSuggestionState

object (NamedStylesSuggestionState)

Masque indiquant les champs de la NamedStyles de base qui ont été modifiés dans cette suggestion.

NamedStylesSuggestionState

État de suggestion d'un message NamedStyles.

Représentation JSON
{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}
Champs
stylesSuggestionStates[]

object (NamedStyleSuggestionState)

Masque indiquant les champs de l'NamedStyle correspondant dans styles qui ont été modifiés dans cette suggestion.

L'ordre de ces états de suggestion de style nommés correspond à l'ordre du style nommé correspondant dans la suggestion named styles.

NamedStyleSuggestionState

État de suggestion d'un message NamedStyle.

Représentation JSON
{
  "namedStyleType": enum (NamedStyleType),
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
Champs
namedStyleType

enum (NamedStyleType)

Type de style nommé auquel correspond cet état de suggestion.

Ce champ est fourni pour faciliter la mise en correspondance de NamedStyleSuggestionState avec son NamedStyle correspondant.

textStyleSuggestionState

object (TextStyleSuggestionState)

Masque indiquant les champs de text style qui ont été modifiés dans cette suggestion.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Masque indiquant les champs de paragraph style qui ont été modifiés dans cette suggestion.

Liste

Une liste représente les attributs de liste d'un groupe de paragraphes appartenant tous à la même liste. Un paragraphe faisant partie d'une liste comporte une référence à l'ID de la liste dans son bullet.

Représentation JSON
{
  "listProperties": {
    object (ListProperties)
  },
  "suggestedListPropertiesChanges": {
    string: {
      object (SuggestedListProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Champs
listProperties

object (ListProperties)

Propriétés de la liste.

suggestedListPropertiesChanges

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

Modifications suggérées pour les propriétés de la liste, identifiées par l'ID de suggestion.

suggestedInsertionId

string

ID d'insertion suggéré. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si elle est vide, cela signifie qu'aucune suppression n'est suggérée pour cette liste.

ListProperties

Propriétés d'un list qui décrivent l'apparence des puces appartenant aux paragraphes associés à une liste.

Représentation JSON
{
  "nestingLevels": [
    {
      object (NestingLevel)
    }
  ]
}
Champs
nestingLevels[]

object (NestingLevel)

Décrit les propriétés des puces au niveau associé.

Une liste peut comporter au maximum neuf niveaux d'imbrication. Le niveau 0 correspond au niveau le plus élevé et le niveau 8 au niveau le plus imbriqué. Les niveaux d'imbrication sont renvoyés par ordre croissant, le niveau le moins imbriqué étant renvoyé en premier.

NestingLevel

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

Représentation JSON
{
  "bulletAlignment": enum (BulletAlignment),
  "glyphFormat": string,
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "textStyle": {
    object (TextStyle)
  },
  "startNumber": integer,

  // Union field glyph_kind can be only one of the following:
  "glyphType": enum (GlyphType),
  "glyphSymbol": string
  // End of list of possible types for union field glyph_kind.
}
Champs
bulletAlignment

enum (BulletAlignment)

Alignement de la puce dans l'espace alloué à son affichage.

glyphFormat

string

Chaîne de format utilisée par les puces à ce niveau d'imbrication.

Le format du glyphe contient un ou plusieurs espaces réservés, qui sont remplacés par les valeurs appropriées en fonction de glyphType ou glyphSymbol. Les espaces réservés suivent le modèle %[nestingLevel]. De plus, les espaces réservés peuvent comporter des préfixes et des suffixes. Le format des glyphes suit donc le modèle <prefix>%[nestingLevel]<suffix>. Notez que le préfixe et le suffixe sont facultatifs et peuvent être des chaînes arbitraires.

Par exemple, le format de glyphe %0. indique que le glyphe affiché remplacera l'espace réservé par le glyphe correspondant au niveau d'imbrication 0, suivi d'un point comme suffixe. Ainsi, une liste avec un type de glyphe UPPER_ALPHA et un format de glyphe %0. au niveau d'imbrication 0 générera une liste avec des glyphes affichés.

A.

B.

C.

Le format du glyphe peut contenir des espaces réservés pour le niveau d'imbrication actuel ainsi que pour les niveaux d'imbrication parents. Par exemple, une liste peut avoir un format de glyphe %0. au niveau d'imbrication 0 et un format de glyphe %0.%1. au niveau d'imbrication 1. En supposant que les deux niveaux d'imbrication comportent des types de glyphes DECIMAL, cela générerait une liste avec des glyphes rendus.

1.

2.

2.1.

2.2.

3.

Pour les niveaux d'imbrication ordonnés, la chaîne qui remplace un espace réservé dans le format de glyphe d'un paragraphe donné dépend de l'ordre du paragraphe dans la liste.

indentFirstLine

object (Dimension)

Quantité de retrait pour la première ligne des paragraphes à ce niveau d'imbrication.

indentStart

object (Dimension)

Quantité d'indentation pour les paragraphes à ce niveau d'imbrication. Appliquée au côté qui correspond au début du texte, en fonction du sens de lecture du contenu du paragraphe.

textStyle

object (TextStyle)

Style de texte des puces à ce niveau d'imbrication.

startNumber

integer

Numéro du premier élément de liste à ce niveau d'imbrication.

Une valeur de 0 est traitée comme une valeur de 1 pour les listes alphabétiques et en chiffres romains. Pour les valeurs 0 et 1, les listes alphabétiques et en chiffres romains commenceront respectivement à a et i.

Cette valeur est ignorée pour les niveaux d'imbrication avec des glyphes non ordonnés.

Champ d'union glyph_kind. Type de glyphe utilisé par les puces. Il définit le glyphe de puce qui remplace les espaces réservés dans glyph_format. La glyph_kind ne peut être qu'un des éléments suivants :
glyphType

enum (GlyphType)

Type de glyphe utilisé par les puces lorsque les paragraphes à ce niveau d'imbrication sont ordonnés.

Le type de glyphe détermine le type de glyphe utilisé pour remplacer les espaces réservés dans glyphFormat lorsque les paragraphes à ce niveau d'imbrication sont ordonnés. Par exemple, si le niveau d'imbrication est défini sur 0, que glyphFormat est défini sur %0. et que le type de glyphe est défini sur DECIMAL, le glyphe affiché remplace l'espace réservé %0 dans le format de glyphe par un nombre correspondant à l'ordre de l'élément de la liste.

glyphSymbol

string

Glyphe personnalisé utilisé par les puces lorsque les paragraphes à ce niveau d'imbrication ne sont pas ordonnés.

Le glyphe remplace les espaces réservés dans glyphFormat. Par exemple, si glyphSymbol est le cercle plein correspondant au point de code Unicode U+25cf et que glyphFormat est %0, le glyphe affiché sera le cercle plein.

BulletAlignment

Types d'alignement pour une puce.

Enums
BULLET_ALIGNMENT_UNSPECIFIED L'alignement des puces n'est pas spécifié.
START La puce est alignée sur le début de l'espace alloué à son affichage. Alignement à gauche pour le texte LTR, à droite dans le cas contraire.
CENTER La puce est alignée au centre de l'espace alloué à son affichage.
END La puce est alignée sur la fin de l'espace alloué à son affichage. Aligné à droite pour le texte LTR, aligné à gauche dans le cas contraire.

GlyphType

Types de glyphes utilisés par les puces lorsque les paragraphes à ce niveau d'imbrication sont ordonnés.

Enums
GLYPH_TYPE_UNSPECIFIED Le type de glyphe n'est pas spécifié ou n'est pas accepté.
NONE Chaîne vide.
DECIMAL Un nombre, comme 1, 2 ou 3.
ZERO_DECIMAL Nombre dont les chiffres uniques sont précédés d'un zéro, comme 01, 02 ou 03. Les nombres comportant plusieurs chiffres ne sont pas précédés d'un zéro.
UPPER_ALPHA Une lettre majuscule, comme A, B ou C.
ALPHA Une lettre minuscule, comme a, b ou c.
UPPER_ROMAN Un chiffre romain en majuscules, comme I, II ou III.
ROMAN Un chiffre romain en minuscules, comme i, ii ou iii.

SuggestedListProperties

Modification suggérée pour ListProperties.

Représentation JSON
{
  "listProperties": {
    object (ListProperties)
  },
  "listPropertiesSuggestionState": {
    object (ListPropertiesSuggestionState)
  }
}
Champs
listProperties

object (ListProperties)

Un ListProperties qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec listPropertiesSuggestionState pour voir quels champs ont été modifiés et quelles sont leurs nouvelles valeurs.

listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

Masque indiquant les champs de la ListProperties de base qui ont été modifiés dans cette suggestion.

ListPropertiesSuggestionState

Masque indiquant les champs de la ListProperties de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "nestingLevelsSuggestionStates": [
    {
      object (NestingLevelSuggestionState)
    }
  ]
}
Champs
nestingLevelsSuggestionStates[]

object (NestingLevelSuggestionState)

Masque indiquant les champs de l'NestingLevel correspondant dans nestingLevels qui ont été modifiés dans cette suggestion.

Les états de suggestion de niveau d'imbrication sont renvoyés par ordre croissant du niveau d'imbrication, le niveau le moins imbriqué étant renvoyé en premier.

NestingLevelSuggestionState

Masque indiquant les champs de la NestingLevel de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "bulletAlignmentSuggested": boolean,
  "glyphTypeSuggested": boolean,
  "glyphFormatSuggested": boolean,
  "glyphSymbolSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "startNumberSuggested": boolean
}
Champs
bulletAlignmentSuggested

boolean

Indique si une modification a été suggérée pour bulletAlignment.

glyphTypeSuggested

boolean

Indique si une modification a été suggérée pour glyphType.

glyphFormatSuggested

boolean

Indique si une modification a été suggérée pour glyphFormat.

glyphSymbolSuggested

boolean

Indique si une modification a été suggérée pour glyphSymbol.

indentFirstLineSuggested

boolean

Indique si une modification a été suggérée pour indentFirstLine.

indentStartSuggested

boolean

Indique si une modification a été suggérée pour indentStart.

textStyleSuggestionState

object (TextStyleSuggestionState)

Masque indiquant les champs de text style qui ont été modifiés dans cette suggestion.

startNumberSuggested

boolean

Indique si une modification a été suggérée pour startNumber.

NamedRanges

Collection de tous les NamedRange du document qui partagent un nom donné.

Représentation JSON
{
  "name": string,
  "namedRanges": [
    {
      object (NamedRange)
    }
  ]
}
Champs
name

string

Nom partagé par tous les named ranges.

namedRanges[]

object (NamedRange)

Les NamedRange qui portent le même nom.

NamedRange

Collection de Range ayant le même ID de plage nommée.

Les plages nommées permettent aux développeurs d'associer des parties d'un document à un libellé arbitraire défini par l'utilisateur afin que leur contenu puisse être lu ou modifié par programmation ultérieurement. Un document peut contenir plusieurs plages nommées portant le même nom, mais chaque plage nommée possède un ID unique.

Une plage nommée est créée avec un seul Range, et le contenu inséré dans une plage nommée étend généralement cette plage. Toutefois, certaines modifications apportées au document peuvent entraîner la division de la plage en plusieurs plages.

Les plages nommées ne sont pas privées. Toutes les applications et tous les collaborateurs ayant accès au document peuvent voir ses plages nommées.

Représentation JSON
{
  "namedRangeId": string,
  "name": string,
  "ranges": [
    {
      object (Range)
    }
  ]
}
Champs
namedRangeId

string

ID de la plage nommée.

name

string

Nom de la plage nommée.

ranges[]

object (Range)

Plages appartenant à cette plage nommée.

Plage

Spécifie une plage de texte contiguë.

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

string

ID de l'en-tête, du pied de page ou de la note de bas de page dans lequel se trouve cette plage. Un ID de segment vide indique le corps du document.

startIndex

integer

Index de début de cette plage (basé sur zéro), en unités de code UTF-16.

Dans toutes les utilisations actuelles, un index de début doit être fourni. Ce champ est une Int32Value afin de s'adapter aux futurs cas d'utilisation avec des plages ouvertes.

endIndex

integer

Index de fin (exclusif) de cette plage, basé sur zéro, en unités de code UTF-16.

Dans toutes les utilisations actuelles, un index de fin doit être fourni. Ce champ est une Int32Value afin de s'adapter aux futurs cas d'utilisation avec des plages ouvertes.

tabId

string

Onglet contenant cette plage. En cas d'omission, la requête s'applique au premier onglet.

Dans un document contenant un seul onglet :

  • Si elle est fournie, elle doit correspondre à l'ID de l'onglet au singulier.

  • Si elle est omise, la requête s'applique à l'onglet unique.

Dans un document contenant plusieurs onglets :

  • Si elle est fournie, la requête s'applique à l'onglet spécifié.

  • Si elle est omise, la requête s'applique au premier onglet du document.

InlineObject

Objet qui apparaît sur la même ligne que le texte. Un InlineObject contient un EmbeddedObject tel qu'une image.

Représentation JSON
{
  "objectId": string,
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "suggestedInlineObjectPropertiesChanges": {
    string: {
      object (SuggestedInlineObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Champs
objectId

string

ID de cet objet intégré. Peut être utilisé pour mettre à jour les propriétés d'un objet.

inlineObjectProperties

object (InlineObjectProperties)

Propriétés de cet objet intégré.

suggestedInlineObjectPropertiesChanges

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

Modifications suggérées apportées aux propriétés de l'objet intégré, identifiées par l'ID de suggestion.

suggestedInsertionId

string

ID d'insertion suggéré. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

InlineObjectProperties

Propriétés d'un InlineObject.

Représentation JSON
{
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Champs
embeddedObject

object (EmbeddedObject)

Objet intégré de cet objet en ligne.

EmbeddedObject

Objet intégré dans le document.

Représentation JSON
{
  "title": string,
  "description": string,
  "embeddedObjectBorder": {
    object (EmbeddedObjectBorder)
  },
  "size": {
    object (Size)
  },
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "linkedContentReference": {
    object (LinkedContentReference)
  },

  // Union field properties can be only one of the following:
  "embeddedDrawingProperties": {
    object (EmbeddedDrawingProperties)
  },
  "imageProperties": {
    object (ImageProperties)
  }
  // End of list of possible types for union field properties.
}
Champs
title

string

Titre de l'objet intégré. title et description sont combinés pour afficher le texte alternatif.

description

string

Description de l'objet intégré. title et description sont combinés pour afficher le texte alternatif.

embeddedObjectBorder

object (EmbeddedObjectBorder)

Bordure de l'objet intégré.

size

object (Size)

Taille visible de l'image après recadrage.

marginTop

object (Dimension)

Marge supérieure de l'objet intégré.

marginBottom

object (Dimension)

Marge inférieure de l'objet intégré.

marginRight

object (Dimension)

Marge de droite de l'objet intégré.

marginLeft

object (Dimension)

Marge de gauche de l'objet intégré.

linkedContentReference

object (LinkedContentReference)

Référence au contenu de la source externe associée. Par exemple, il contient une référence au graphique source Google Sheets lorsque l'objet intégré est un graphique associé.

Si elle n'est pas définie, l'objet intégré n'est pas associé.

Champ d'union properties. Propriétés spécifiques à chaque type d'objet intégré. properties ne peut être qu'un des éléments suivants :
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

Propriétés d'un dessin intégré.

imageProperties

object (ImageProperties)

Propriétés d'une image.

EmbeddedDrawingProperties

Ce type ne comporte aucun champ.

Propriétés d'un dessin intégré utilisées pour différencier le type d'objet. Un dessin intégré est un dessin créé et modifié dans un document. Notez que les informations détaillées ne sont pas acceptées.

ImageProperties

Propriétés d'une image.

Représentation JSON
{
  "contentUri": string,
  "sourceUri": string,
  "brightness": number,
  "contrast": number,
  "transparency": number,
  "cropProperties": {
    object (CropProperties)
  },
  "angle": number
}
Champs
contentUri

string

URI de l'image avec une durée de vie par défaut de 30 minutes. Cet URI est associé au compte du demandeur. Toute personne disposant de l'URI accède effectivement à l'image en tant que demandeur d'origine. Vous risquez de perdre l'accès à l'image si les paramètres de partage du document changent.

sourceUri

string

L'URI source est l'URI utilisé pour insérer l'image. L'URI source peut être vide.

brightness

number

Effet de luminosité de l'image. La valeur doit être comprise dans l'intervalle [-1,0, 1,0], où 0 signifie aucun effet.

contrast

number

Effet de contraste de l'image. La valeur doit être comprise dans l'intervalle [-1,0, 1,0], où 0 signifie aucun effet.

transparency

number

Effet de transparence de l'image. La valeur doit être comprise dans l'intervalle [0,0, 1,0], où 0 signifie aucun effet et 1 signifie transparent.

cropProperties

object (CropProperties)

Propriétés de recadrage de l'image.

angle

number

Angle de rotation de l'image dans le sens des aiguilles d'une montre, en radians.

CropProperties

Propriétés de recadrage d'une image.

Le rectangle de recadrage est représenté à l'aide de décalages fractionnaires par rapport aux quatre bords du contenu d'origine.

  • Si le décalage se trouve dans l'intervalle (0, 1), le bord correspondant du rectangle de recadrage est positionné à l'intérieur du rectangle de délimitation d'origine de l'image.
  • Si le décalage est négatif ou supérieur à 1, le bord correspondant du rectangle de recadrage est positionné en dehors du rectangle de sélection d'origine de l'image.
  • Si tous les décalages et angles de rotation sont définis sur 0, l'image n'est pas recadrée.
Représentation JSON
{
  "offsetLeft": number,
  "offsetRight": number,
  "offsetTop": number,
  "offsetBottom": number,
  "angle": number
}
Champs
offsetLeft

number

Le décalage indique la distance entre le bord gauche du rectangle de recadrage et le bord gauche du contenu d'origine, sous forme de fraction de la largeur du contenu d'origine.

offsetRight

number

Le décalage indique la distance entre le bord droit du rectangle de recadrage et le bord droit du contenu d'origine, sous la forme d'une fraction de la largeur du contenu d'origine.

offsetTop

number

Le décalage indique la distance entre le bord supérieur du rectangle de recadrage et le bord supérieur du contenu d'origine, sous la forme d'une fraction de la hauteur du contenu d'origine.

offsetBottom

number

Le décalage indique la distance entre le bord inférieur du rectangle de recadrage et le bord inférieur du contenu d'origine, sous la forme d'une fraction de la hauteur du contenu d'origine.

angle

number

Angle de rotation du rectangle de recadrage autour de son centre, dans le sens des aiguilles d'une montre, en radians. La rotation est appliquée après les décalages.

EmbeddedObjectBorder

Bordure autour d'un EmbeddedObject.

Représentation JSON
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
Champs
color

object (OptionalColor)

Couleur de la bordure.

width

object (Dimension)

Largeur de la bordure.

dashStyle

enum (DashStyle)

Style de tirets de la bordure.

propertyState

enum (PropertyState)

État de la propriété de bordure.

PropertyState

Les différents états possibles d'une propriété.

Enums
RENDERED Si l'état d'une propriété est RENDERED, l'élément possède la propriété correspondante lorsqu'il est affiché dans le document. Il s'agit de la valeur par défaut.
NOT_RENDERED Si l'état d'une propriété est NOT_RENDERED, l'élément ne possède pas la propriété correspondante lorsqu'il est affiché dans le document.

LinkedContentReference

Référence au contenu de la source externe associée.

Représentation JSON
{

  // Union field reference can be only one of the following:
  "sheetsChartReference": {
    object (SheetsChartReference)
  }
  // End of list of possible types for union field reference.
}
Champs
Champ d'union reference. Référence spécifique au type de contenu associé. reference ne peut être qu'un des éléments suivants :
sheetsChartReference

object (SheetsChartReference)

Référence au graphique associé.

SheetsChartReference

Référence à un graphique associé intégré depuis Google Sheets.

Représentation JSON
{
  "spreadsheetId": string,
  "chartId": integer
}
Champs
spreadsheetId

string

ID de la feuille de calcul Google Sheets contenant le graphique source.

chartId

integer

ID du graphique spécifique intégré dans la feuille de calcul Google Sheets.

SuggestedInlineObjectProperties

Modification suggérée pour InlineObjectProperties.

Représentation JSON
{
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "inlineObjectPropertiesSuggestionState": {
    object (InlineObjectPropertiesSuggestionState)
  }
}
Champs
inlineObjectProperties

object (InlineObjectProperties)

Un InlineObjectProperties qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec inlineObjectPropertiesSuggestionState pour voir quels champs ont été modifiés et quelles sont leurs nouvelles valeurs.

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

Masque indiquant les champs de la InlineObjectProperties de base qui ont été modifiés dans cette suggestion.

InlineObjectPropertiesSuggestionState

Masque indiquant les champs de la InlineObjectProperties de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Champs
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Masque indiquant les champs de embeddedObject qui ont été modifiés dans cette suggestion.

EmbeddedObjectSuggestionState

Masque indiquant les champs de la EmbeddedObject de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "embeddedDrawingPropertiesSuggestionState": {
    object (EmbeddedDrawingPropertiesSuggestionState)
  },
  "imagePropertiesSuggestionState": {
    object (ImagePropertiesSuggestionState)
  },
  "titleSuggested": boolean,
  "descriptionSuggested": boolean,
  "embeddedObjectBorderSuggestionState": {
    object (EmbeddedObjectBorderSuggestionState)
  },
  "sizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginLeftSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "linkedContentReferenceSuggestionState": {
    object (LinkedContentReferenceSuggestionState)
  }
}
Champs
embeddedDrawingPropertiesSuggestionState

object (EmbeddedDrawingPropertiesSuggestionState)

Masque indiquant les champs de embeddedDrawingProperties qui ont été modifiés dans cette suggestion.

imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

Masque indiquant les champs de imageProperties qui ont été modifiés dans cette suggestion.

titleSuggested

boolean

Indique si une modification a été suggérée pour title.

descriptionSuggested

boolean

Indique si une modification a été suggérée pour description.

embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

Masque indiquant les champs de embeddedObjectBorder qui ont été modifiés dans cette suggestion.

sizeSuggestionState

object (SizeSuggestionState)

Masque indiquant les champs de size qui ont été modifiés dans cette suggestion.

marginLeftSuggested

boolean

Indique si une modification a été suggérée pour marginLeft.

marginRightSuggested

boolean

Indique si une modification a été suggérée pour marginRight.

marginTopSuggested

boolean

Indique si une modification a été suggérée pour marginTop.

marginBottomSuggested

boolean

Indique si une modification a été suggérée pour marginBottom.

linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

Masque indiquant les champs de linkedContentReference qui ont été modifiés dans cette suggestion.

EmbeddedDrawingPropertiesSuggestionState

Ce type ne comporte aucun champ.

Masque indiquant les champs de la EmbeddedDrawingProperties de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

ImagePropertiesSuggestionState

Masque indiquant les champs de la ImageProperties de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "contentUriSuggested": boolean,
  "sourceUriSuggested": boolean,
  "brightnessSuggested": boolean,
  "contrastSuggested": boolean,
  "transparencySuggested": boolean,
  "cropPropertiesSuggestionState": {
    object (CropPropertiesSuggestionState)
  },
  "angleSuggested": boolean
}
Champs
contentUriSuggested

boolean

Indique si une modification a été suggérée pour contentUri.

sourceUriSuggested

boolean

Indique si une modification a été suggérée pour [sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri].

brightnessSuggested

boolean

Indique si une modification a été suggérée pour [brightness] [google.apps.docs.v1.EmbeddedObject.brightness].

contrastSuggested

boolean

Indique si une modification a été suggérée pour [contraste] [google.apps.docs.v1.EmbeddedObject.contrast].

transparencySuggested

boolean

Indique si une modification a été suggérée pour [transparency] [google.apps.docs.v1.EmbeddedObject.transparency].

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

Masque indiquant les champs de cropProperties qui ont été modifiés dans cette suggestion.

angleSuggested

boolean

Indique si une modification a été suggérée pour [angle] [google.apps.docs.v1.EmbeddedObject.angle].

CropPropertiesSuggestionState

Masque indiquant les champs de la CropProperties de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "offsetLeftSuggested": boolean,
  "offsetRightSuggested": boolean,
  "offsetTopSuggested": boolean,
  "offsetBottomSuggested": boolean,
  "angleSuggested": boolean
}
Champs
offsetLeftSuggested

boolean

Indique si une modification a été suggérée pour offsetLeft.

offsetRightSuggested

boolean

Indique si une modification a été suggérée pour offsetRight.

offsetTopSuggested

boolean

Indique si une modification a été suggérée pour offsetTop.

offsetBottomSuggested

boolean

Indique si une modification a été suggérée pour offsetBottom.

angleSuggested

boolean

Indique si une modification a été suggérée pour angle.

EmbeddedObjectBorderSuggestionState

Masque indiquant les champs de la EmbeddedObjectBorder de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "colorSuggested": boolean,
  "widthSuggested": boolean,
  "dashStyleSuggested": boolean,
  "propertyStateSuggested": boolean
}
Champs
colorSuggested

boolean

Indique si une modification a été suggérée pour [color] [google.apps.docs.v1.EmbeddedBorderObject.color].

widthSuggested

boolean

Indique si une modification a été suggérée pour [width] [google.apps.docs.v1.EmbeddedBorderObject.width].

dashStyleSuggested

boolean

Indique si une modification a été suggérée pour [dashStyle] [google.apps.docs.v1.EmbeddedBorderObject.dash_style].

propertyStateSuggested

boolean

Indique si une modification a été suggérée pour [propertyState] [google.apps.docs.v1.EmbeddedBorderObject.property_state].

LinkedContentReferenceSuggestionState

Masque indiquant les champs de la LinkedContentReference de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "sheetsChartReferenceSuggestionState": {
    object (SheetsChartReferenceSuggestionState)
  }
}
Champs
sheetsChartReferenceSuggestionState

object (SheetsChartReferenceSuggestionState)

Masque indiquant les champs de sheetsChartReference qui ont été modifiés dans cette suggestion.

SheetsChartReferenceSuggestionState

Masque indiquant les champs de la SheetsChartReference de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "spreadsheetIdSuggested": boolean,
  "chartIdSuggested": boolean
}
Champs
spreadsheetIdSuggested

boolean

Indique si une modification a été suggérée pour spreadsheetId.

chartIdSuggested

boolean

Indique si une modification a été suggérée pour chartId.

PositionedObject

Objet rattaché à un Paragraph et positionné par rapport au début du paragraphe. Un PositionedObject contient un EmbeddedObject tel qu'une image.

Représentation JSON
{
  "objectId": string,
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "suggestedPositionedObjectPropertiesChanges": {
    string: {
      object (SuggestedPositionedObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Champs
objectId

string

ID de cet objet positionné.

positionedObjectProperties

object (PositionedObjectProperties)

Propriétés de cet objet positionné.

suggestedPositionedObjectPropertiesChanges

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

Modifications suggérées pour les propriétés de l'objet positionné, indexées par ID de suggestion.

suggestedInsertionId

string

ID d'insertion suggéré. Si ce champ est vide, il ne s'agit pas d'une insertion suggérée.

suggestedDeletionIds[]

string

ID de suppression suggérés. Si ce champ est vide, cela signifie qu'aucune suppression n'est suggérée pour ce contenu.

PositionedObjectProperties

Propriétés d'un PositionedObject.

Représentation JSON
{
  "positioning": {
    object (PositionedObjectPositioning)
  },
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Champs
positioning

object (PositionedObjectPositioning)

Position de cet objet positionné par rapport à la ligne de Paragraph qui le référence.

embeddedObject

object (EmbeddedObject)

Objet intégré de cet objet positionné.

PositionedObjectPositioning

Positionnement d'un PositionedObject. L'objet positionné est positionné par rapport au début du Paragraph auquel il est rattaché.

Représentation JSON
{
  "layout": enum (PositionedObjectLayout),
  "leftOffset": {
    object (Dimension)
  },
  "topOffset": {
    object (Dimension)
  }
}
Champs
layout

enum (PositionedObjectLayout)

Mise en page de cet objet positionné.

leftOffset

object (Dimension)

Décalage du bord gauche de l'objet positionné par rapport au début de l'élément Paragraph auquel il est rattaché. Le positionnement exact de l'objet peut dépendre d'autres contenus du document et de son style.

topOffset

object (Dimension)

Décalage du bord supérieur de l'objet positionné par rapport au début de l'élément Paragraph auquel il est rattaché. Le positionnement exact de l'objet peut dépendre d'autres contenus du document et de son style.

PositionedObjectLayout

Les mises en page possibles d'un [PositionedObject][google.aps.docs.v1.PositionedObject].

Enums
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED La mise en page n'est pas spécifiée.
WRAP_TEXT Le texte s'enroule autour de l'objet positionné.
BREAK_LEFT Insère un saut de ligne pour que l'objet positionné se trouve à gauche et le texte à droite.
BREAK_RIGHT Le texte est coupé de sorte que l'objet positionné se trouve à droite et le texte à gauche.
BREAK_LEFT_RIGHT Le texte est coupé de sorte qu'il n'y ait pas de texte à gauche ou à droite de l'objet positionné.
IN_FRONT_OF_TEXT L'objet positionné se trouve devant le texte.
BEHIND_TEXT L'objet positionné se trouve derrière le texte.

SuggestedPositionedObjectProperties

Modification suggérée pour PositionedObjectProperties.

Représentation JSON
{
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "positionedObjectPropertiesSuggestionState": {
    object (PositionedObjectPropertiesSuggestionState)
  }
}
Champs
positionedObjectProperties

object (PositionedObjectProperties)

Un PositionedObjectProperties qui n'inclut que les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec positionedObjectPropertiesSuggestionState pour voir quels champs ont été modifiés et quelles sont leurs nouvelles valeurs.

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

Masque indiquant les champs de la PositionedObjectProperties de base qui ont été modifiés dans cette suggestion.

PositionedObjectPropertiesSuggestionState

Masque indiquant les champs de la PositionedObjectProperties de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "positioningSuggestionState": {
    object (PositionedObjectPositioningSuggestionState)
  },
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Champs
positioningSuggestionState

object (PositionedObjectPositioningSuggestionState)

Masque indiquant les champs de positioning qui ont été modifiés dans cette suggestion.

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Masque indiquant les champs de embeddedObject qui ont été modifiés dans cette suggestion.

PositionedObjectPositioningSuggestionState

Masque indiquant les champs de la PositionedObjectPositioning de base qui ont été modifiés dans cette suggestion. Pour tout champ défini sur "true", une nouvelle valeur est suggérée.

Représentation JSON
{
  "layoutSuggested": boolean,
  "leftOffsetSuggested": boolean,
  "topOffsetSuggested": boolean
}
Champs
layoutSuggested

boolean

Indique si une modification a été suggérée pour layout.

leftOffsetSuggested

boolean

Indique si une modification a été suggérée pour leftOffset.

topOffsetSuggested

boolean

Indique si une modification a été suggérée pour topOffset.

SuggestionsViewMode

Mode d'affichage des suggestions appliqué au document, qui indique comment les modifications suggérées sont représentées. Il propose des options pour lire le document avec toutes les suggestions intégrées, acceptées ou refusées.

Enums
DEFAULT_FOR_CURRENT_ACCESS Le SuggestionsViewMode appliqué au document renvoyé dépend du niveau d'accès actuel de l'utilisateur. Si l'utilisateur ne dispose que d'un accès en lecture seule, PREVIEW_WITHOUT_SUGGESTIONS est appliqué. Sinon, SUGGESTIONS_INLINE est appliqué. Il s'agit du mode d'affichage des suggestions par défaut.
SUGGESTIONS_INLINE

Le document renvoyé contient des suggestions intégrées. Les suggestions de modifications seront différenciées du contenu de base dans le document.

Les requêtes visant à récupérer un document à l'aide de ce mode renvoient une erreur 403 si l'utilisateur n'est pas autorisé à afficher les modifications suggérées.

PREVIEW_SUGGESTIONS_ACCEPTED

Le document renvoyé est un aperçu dans lequel toutes les modifications suggérées ont été acceptées.

Les requêtes visant à récupérer un document à l'aide de ce mode renvoient une erreur 403 si l'utilisateur n'est pas autorisé à afficher les modifications suggérées.

PREVIEW_WITHOUT_SUGGESTIONS Le document renvoyé est un aperçu dans lequel toutes les suggestions de modifications sont refusées, le cas échéant.

Méthodes

batchUpdate

Applique une ou plusieurs mises à jour au document.

create

Crée un document vierge en utilisant le titre indiqué dans la requête.

get

Récupère la dernière version du document spécifié.