REST Resource: documents

{
  "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)
    },
    ...
  }
}

string

Uniquement en sortie. ID du document.

string

Titre du document.

object (Tab)

Onglets faisant partie d'un document

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

string

Uniquement en sortie. ID de la révision du document. Peut être utilisée 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. Ce champ n'est renseigné que si l'utilisateur est autorisé à modifier le document.

L'ID de révision n'est pas un numéro séquentiel, mais une chaîne opaque. Le format de l'ID de révision peut changer au fil du temps. Un ID de révision renvoyé n'est valide que pendant 24 heures. Il ne peut pas être partagé entre les utilisateurs. Si l'ID de révision reste inchangé entre les appels, cela signifie que le document n'a pas changé. À l'inverse, un ID modifié (pour le même document et l'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 de format.

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.

object (Body)

Uniquement en sortie. Corps principal du document.

Ancien champ: utilisez plutôt Document.tabs.documentTab.body, qui expose le contenu réel du document 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.

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

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

Ancien champ: utilisez plutôt Document.tabs.documentTab.headers, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou qu'elle n'est pas configurée, ce champ contient des informations sur le premier onglet du document.

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

Uniquement en sortie. Pieds de page du document, associés à un ID de pied de page.

Ancien champ : utilisez plutôt Document.tabs.documentTab.footers, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou qu'elle n'est pas configurée, ce champ contient des informations sur le premier onglet du document.

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

Uniquement en sortie. Notes de bas de page du document, triées par ID de note de bas de page.

Ancien champ : utilisez plutôt Document.tabs.documentTab.footnotes, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou qu'elle n'est pas configurée, ce champ contient des informations sur le premier onglet du document.

object (DocumentStyle)

Uniquement en sortie. Style du document.

Ancien champ : utilisez plutôt Document.tabs.documentTab.documentStyle, qui expose le contenu réel du document 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.

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

Uniquement en sortie. Modifications suggérées pour le style du document, associées à l'ID de suggestion.

Ancien champ : utilisez plutôt Document.tabs.documentTab.suggestedDocumentStyleChanges, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou qu'elle n'est pas configurée, ce champ contient des informations sur le premier onglet du document.

object (NamedStyles)

Uniquement en sortie. Styles nommés du document.

Ancien champ: utilisez plutôt Document.tabs.documentTab.namedStyles, qui expose le contenu réel du document 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.

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

Uniquement en sortie. Modifications suggérées apportées aux styles nommés du document, triées par ID de suggestion.

Ancien champ: utilisez plutôt Document.tabs.documentTab.suggestedNamedStylesChanges, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou qu'elle n'est pas configurée, ce champ contient des informations sur le premier onglet du document.

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

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

Ancien champ : utilisez plutôt Document.tabs.documentTab.lists, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou qu'elle n'est pas configurée, ce champ contient des informations sur le premier onglet du document.

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

Uniquement en sortie. Plages nommées du document, regroupées par nom.

Ancien champ : utilisez plutôt Document.tabs.documentTab.namedRanges, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou qu'elle n'est pas configurée, ce champ contient des informations sur le premier onglet du document.

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

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

Ancien champ: utilisez plutôt Document.tabs.documentTab.inlineObjects, qui expose le contenu réel du document 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.

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

Uniquement en sortie. Objets positionnés dans le document, avec clé correspondant à l'ID de l'objet.

Ancien champ: utilisez plutôt Document.tabs.documentTab.positionedObjects, qui expose le contenu réel du document de tous les onglets lorsque le paramètre includeTabsContent est défini sur true. Si la valeur est false ou qu'elle n'est pas configurée, ce champ contient des informations sur le premier onglet du document.

{
  "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.
}

object (TabProperties)

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

object (Tab)

Onglets enfants imbriqués dans cet onglet

object (DocumentTab)

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

{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}

string

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

string

Nom visible par l'utilisateur de l'onglet.

string

Facultatif. ID de l'onglet parent. Ce champ est vide lorsque l'onglet actuel est un onglet racine, ce qui signifie qu'il n'a pas de parents.

integer

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

integer

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

{
  "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)
    },
    ...
  }
}

object (Body)

Corps principal de l'onglet du document.

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

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

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

Pieds de page de l'onglet du document, associés à un ID de pied de page.

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

Les notes de bas de page de l'onglet du document, triées par ID de note de bas de page.

object (DocumentStyle)

Style de l'onglet du document.

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

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

object (NamedStyles)

Styles nommés de l'onglet du document.

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

Modifications suggérées pour les styles nommés de l'onglet du document, associés par ID de suggestion.

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

Listes de l'onglet des documents, associées par ID de liste.

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

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

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

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

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

Objets positionnés dans l'onglet du document, triés par ID d'objet.

{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

object (StructuralElement)

Contenu du corps.

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

{
  "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.
}

integer

Indice de départ basé sur zéro de cet élément de structure, exprimé en unités de code UTF-16.

integer

Indice de fin de cet élément structurel, à partir de zéro, en unités de code UTF-16.

object (Paragraph)

Type de paragraphe d'un élément de structure.

object (SectionBreak)

Type de saut de section d'un élément de structure.

object (Table)

Type de tableau d'élément structurel.

object (TableOfContents)

Type de table des matières d'un élément structurel.

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

object (ParagraphElement)

Contenu du paragraphe, décomposé en parties.

object (ParagraphStyle)

Style de ce paragraphe.

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

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

object (Bullet)

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

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

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

string

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

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

ID des objets positionnés suggérés pour être joints à ce paragraphe, associés à l'ID de suggestion.

{
  "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.
}

integer

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

integer

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

object (TextRun)

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

object (AutoText)

Élément de paragraphe de texte automatique.

object (PageBreak)

Élément de paragraphe de saut de page.

object (ColumnBreak)

Élément de paragraphe de saut de colonne.

object (FootnoteReference)

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

object (HorizontalRule)

Élément de paragraphe avec ligne horizontale.

object (Equation)

Élément de paragraphe d'équation.

object (InlineObjectElement)

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

object (Person)

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

object (RichLink)

Élément de paragraphe qui renvoie vers une ressource Google (fichier dans Google Drive, vidéo YouTube ou événement d'agenda, par exemple).

{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

Texte de cette exécution.

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

string

ID d'insertion suggérés. Un TextRun peut comporter 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 suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de cette exécution.

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

Le style de texte suggéré change pour cette exécution, associé à l'ID de suggestion.

{
  "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)
  }
}

boolean

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

boolean

Indique si le texte est en italique ou non.

boolean

Indique si le texte est souligné ou non.

boolean

Indique si le texte est barré ou non.

boolean

Indique si le texte est en petites majuscules.

object (OptionalColor)

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

object (OptionalColor)

Couleur de premier plan du texte. S'il est défini, la couleur est soit une couleur RVB, soit transparente, en fonction du champ color.

object (Dimension)

Taille de la police du texte.

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

enum (BaselineOffset)

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

Le texte avec des décalages de référence de SUPERSCRIPT ou SUBSCRIPT s'affiche automatiquement 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.

object (Link)

Destination du lien hypertexte du texte. Si cette règle n'est pas configurée, aucun lien n'est affiché. Les liens ne sont pas hérités du texte parent.

Modifier le lien dans une requête de mise à jour entraîne d'autres modifications du style de texte de la plage :

• Lorsque vous définissez un lien, la couleur de premier plan du texte est remplacée par la couleur de lien par défaut et le texte est souligné. Si ces champs sont modifiés dans la même demande, ces valeurs seront utilisées à la place des valeurs par défaut du lien.
• Si vous définissez un lien sur une plage de texte qui chevauche un lien existant, le lien existant sera également mis à jour pour pointer vers la nouvelle URL.
• Les associations ne peuvent pas être définies sur des caractères de nouvelle ligne. Par conséquent, si vous définissez un lien dans une plage de texte qui dépasse la limite d'un paragraphe, comme "ABC\n123", le ou les caractères de retour à la ligne sont séparés dans leurs propres exécutions de texte. Le lien sera appliqué séparément aux exécutions avant et après le retour à la ligne.
• La suppression d'un lien modifie le style de texte de la plage pour qu'il corresponde au style du texte précédent (ou aux styles de texte par défaut si le texte qui précède est un autre lien), sauf si des styles différents sont définis dans la même requête.

{
  "color": {
    object (Color)
  }
}

object (Color)

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

{
  "rgbColor": {
    object (RgbColor)
  }
}

object (RgbColor)

Valeur de la couleur RVB.

{
  "red": number,
  "green": number,
  "blue": number
}

number

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

number

Composant vert de la couleur, compris entre 0,0 et 1,0.

number

Composant bleu de la couleur, compris entre 0,0 et 1,0.

{
  "magnitude": number,
  "unit": enum (Unit)
}

number

Amplitude.

enum (Unit)

Unités de l'ampleur.

{
  "fontFamily": string,
  "weight": integer
}

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 s'affiche dans Arial.

integer

Épaisseur de la police. Ce champ peut prendre n'importe quelle valeur multiple de 100 comprise entre 100 et 900 inclus. Cette plage correspond aux valeurs numériques décrites dans la section 15.6 de la spécification CSS 2.1, où les valeurs non numériques ne sont pas autorisées.

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. Une 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 l'épaisseur est inférieure à 400, l'épaisseur 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 la pondération est supérieure ou égale à 700, la pondération affichée est égale à la pondération.
• Si le texte n'est pas en gras, l'épaisseur de rendu est égale à l'épaisseur.

{

  // Union field destination can be only one of the following:
  "url": string,
  "tabId": string,
  "bookmark": {
    object (BookmarkLink)
  },
  "heading": {
    object (HeadingLink)
  },
  "bookmarkId": string,
  "headingId": string
  // End of list of possible types for union field destination.
}

string

URL externe.

string

ID d'un onglet de ce document.

object (BookmarkLink)

Un signet dans ce document.

Dans les documents contenant un seul onglet, les liens vers les signets de l'onglet unique continuent de renvoyer Link.bookmarkId lorsque le paramètre includeTabsContent est défini sur false ou non défini. Sinon, ce champ est renvoyé.

object (HeadingLink)

Un titre dans ce document.

Dans les documents contenant un seul onglet, les liens vers les en-têtes d'un onglet singulier continuent de renvoyer Link.headingId lorsque le paramètre includeTabsContent est défini sur false ou n'est pas défini. Sinon, ce champ est renvoyé.

string

ID d'un favori dans ce document.

Ancien champ : définissez includeTabsContent sur true et utilisez Link.bookmark pour les opérations de lecture et d'écriture. Ce champ n'est renvoyé que lorsque includeTabsContent est défini sur false dans les documents contenant un seul onglet et qui renvoie vers un signet dans l'onglet singulier. Sinon, Link.bookmark est renvoyé.

Si ce champ est utilisé dans une requête d'écriture, le favori est considéré comme provenant de l'ID d'onglet spécifié dans la requête. Si aucun ID d'onglet n'est spécifié dans la demande, il est considéré comme provenant du premier onglet du document.

string

ID d'un titre de ce document.

Ancien champ : définissez includeTabsContent sur true et utilisez Link.heading pour les opérations de lecture et d'écriture. Ce champ n'est renvoyé que lorsque includeTabsContent est défini sur false dans les documents contenant un seul onglet et des liens vers un titre dans l'onglet unique. Sinon, Link.heading est renvoyé.

Si ce champ est utilisé dans une requête d'écriture, l'en-tête est considéré comme provenant de l'ID de l'onglet spécifié dans la requête. Si aucun ID d'onglet n'est spécifié dans la requête, il est considéré comme provenant du premier onglet du document.

{
  "id": string,
  "tabId": string
}

string

ID d'un favori dans ce document.

string

ID de l'onglet contenant ce favori.

{
  "id": string,
  "tabId": string
}

string

ID d'un titre dans ce document.

string

ID de l'onglet contenant cet en-tête.

{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

object (TextStyle)

TextStyle qui inclut uniquement les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec textStyleSuggestionState pour identifier les champs qui ont été modifiés et leurs nouvelles valeurs.

object (TextStyleSuggestionState)

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

{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

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

enum (Type)

Type de ce texte automatique.

string

ID d'insertion suggérés. Un élément 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 suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de cet AutoText.

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

Le style de texte suggéré est modifié pour ce texte automatique, associé à l'ID de suggestion.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

ID d'insertion suggérés. Un élément PageBreak 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 suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de ce saut de page.

Comme pour le contenu textuel, comme les passages de texte et les références à des 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é.

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

Le style de texte suggéré est remplacé par ce saut de page, associé à l'ID de suggestion.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

ID d'insertion suggérés. Un élément ColumnBreak 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 suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de ce ColumnBreak.

Comme pour le contenu textuel, comme les passages de texte et les références de note de bas de page, le style de texte d'un saut de colonne peut affecter la mise en page du contenu, ainsi que le style du texte inséré à côté.

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

Le style de texte suggéré est remplacé par ce saut de colonne, associé à l'ID de suggestion.

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

string

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

string

Numéro affiché pour cette note de bas de page.

string

ID d'insertion suggérés. Un FootnoteReference peut comporter 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 suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de cette référence de note de bas de page.

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

Le style de texte suggéré est remplacé par cette référence de note de bas de page, référencée par l'ID de suggestion.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

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

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de cette HorizontalRule.

Comme pour le contenu textuel, comme les passages de texte et les références de note de bas de page, le style de texte d'une ligne horizontale peut affecter la mise en page du contenu ainsi que le style du texte inséré à côté.

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

Le style de texte suggéré est remplacé par cette règle HorizontalRule, associée à l'ID de suggestion.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

string

ID d'insertion suggérés. Un élément 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 suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

ID de l'élément InlineObject contenu dans cet élément.

string

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

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TextStyle)

Style de texte de cet élément InlineObject.

Comme pour le contenu textuel, comme les lignes de texte et les références de note 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é.

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

Le style de texte suggéré est remplacé par cet InlineObject, associé par l'ID de suggestion.

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

string

Uniquement en sortie. Identifiant unique de cette association.

string

ID des suggestions qui insèrent le lien de cette personne dans le document. Un élément 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, ce lien de personne n'est pas une suggestion d'insertion.

string

ID des suggestions qui suppriment le lien vers 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, la suppression du lien vers cette personne n'est pas suggérée.

object (TextStyle)

Style de texte de cet objet Person.

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

Le style de texte suggéré est remplacé par Person, associé à l'ID de suggestion.

object (PersonProperties)

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

{
  "name": string,
  "email": string
}

string

Uniquement en sortie. Nom de la personne si celui-ci s'affiche dans le texte du lien au lieu de son adresse e-mail.

string

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

{
  "richLinkId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
}

string

Uniquement en sortie. ID de cette association.

string

ID des suggestions qui insèrent ce lien dans le document. Un RichLink peut comporter 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 cette personne n'est pas une suggestion d'insertion.

string

ID des suggestions de suppression de ce lien du document. Un élément RichLink 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 n'est pas suggéré pour suppression.

object (TextStyle)

Style de texte de cet objet RichLink.

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

Le style de texte suggéré est remplacé par RichLink, associé à l'ID de suggestion.

object (RichLinkProperties)

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

{
  "title": string,
  "uri": string,
  "mimeType": string
}

string

Uniquement en sortie. Titre de l'élément RichLink tel qu'il est affiché dans le lien. Ce titre correspond au titre 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.

string

Uniquement en sortie. URI de l'RichLink. Il est toujours présent.

string

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

{
  "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
}

string

ID de l'en-tête du paragraphe. Si ce champ est vide, ce paragraphe n'est pas un titre.

Cette propriété est en lecture seule.

enum (NamedStyleType)

Type de style nommé du paragraphe.

Étant donné que la modification du type de style nommé affecte d'autres propriétés de ParagraphStyle, le type de style nommé est appliqué avant que les autres propriétés ne soient mises à jour.

enum (Alignment)

Alignement du texte de ce paragraphe.

number

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

enum (ContentDirection)

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

enum (SpacingMode)

Mode d'espacement du paragraphe.

object (Dimension)

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

object (Dimension)

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

object (ParagraphBorder)

Bordure entre ce paragraphe et les paragraphes suivants et précédents. Si cette règle n'est pas configurée, la valeur est héritée du parent.

La bordure située entre les deux s'affiche lorsque le paragraphe adjacent possède les mêmes propriétés de bordure et de retrait.

Vous ne pouvez pas mettre à jour partiellement les bordures de paragraphe. Lorsque vous modifiez la bordure d'un paragraphe, la nouvelle bordure doit être spécifiée dans son intégralité.

object (ParagraphBorder)

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

La bordure supérieure est affichée lorsque le paragraphe ci-dessus présente des propriétés de bordure et de retrait différentes.

Impossible de mettre à jour partiellement les bordures de paragraphe. Lorsque vous modifiez la bordure d'un paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

object (ParagraphBorder)

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

La bordure inférieure est affichée lorsque le paragraphe ci-dessous a des propriétés de bordure et de retrait différentes.

Impossible de mettre à jour partiellement les bordures de paragraphe. Lorsque vous modifiez la bordure d'un paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

object (ParagraphBorder)

Bordure à gauche de ce paragraphe. Si cette règle n'est pas configurée, la valeur est héritée du parent.

Impossible de mettre à jour partiellement les bordures de paragraphe. Lorsque vous modifiez la bordure d'un paragraphe, la nouvelle bordure doit être spécifiée dans son intégralité.

object (ParagraphBorder)

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

Vous ne pouvez pas mettre à jour partiellement les bordures de paragraphe. Lorsque vous modifiez la bordure d'un paragraphe, vous devez spécifier la nouvelle bordure dans son intégralité.

object (Dimension)

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

object (Dimension)

Nombre de retraits du paragraphe sur le côté qui correspond au début du texte, en fonction de l'orientation actuelle du paragraphe. Si cette règle n'est pas configurée, la valeur est héritée du parent.

object (Dimension)

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

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.

boolean

Indique si toutes les lignes du paragraphe doivent être disposées sur la même page ou dans la même colonne, si possible. Si cette règle n'est pas configurée, la valeur est héritée du parent.

boolean

Indique si au moins une partie de ce paragraphe doit être disposée sur la même page ou colonne que le paragraphe suivant, si possible. Si cette règle n'est pas configurée, la valeur est héritée du parent.

boolean

Indique si les orphelins et les veuves doivent être évités pour le paragraphe. Si cette règle n'est pas configurée, la valeur est héritée du parent.

object (Shading)

Ombre du paragraphe. Si cette règle n'est pas configurée, la valeur est héritée du parent.

boolean

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

Toute tentative de mise à jour de pageBreakBefore pour des paragraphes se trouvant dans des régions non compatibles, y compris Table, Header, Footer et Footnote, peut entraîner un état non valide du document qui renvoie une erreur de requête incorrecte 400.

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

Couleur de la bordure.

object (Dimension)

Largeur de la bordure.

object (Dimension)

Marge intérieure de la bordure.

enum (DashStyle)

Style de tiret de la bordure.

{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}

object (Dimension)

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

enum (TabStopAlignment)

Alignement de cette tabulation. Si cette règle n'est pas configurée, la valeur par défaut est START.

{
  "backgroundColor": {
    object (OptionalColor)
  }
}

object (OptionalColor)

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

{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}

object (ParagraphStyle)

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

object (ParagraphStyleSuggestionState)

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

{
  "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
}

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (ShadingSuggestionState)

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

boolean

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

{
  "backgroundColorSuggested": boolean
}

boolean

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

{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    object (TextStyle)
  }
}

string

ID de la liste à laquelle ce paragraphe appartient.

integer

Niveau d'imbrication de ce paragraphe dans la liste.

object (TextStyle)

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

{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}

object (Bullet)

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

object (BulletSuggestionState)

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

{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

boolean

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

boolean

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

object (TextStyleSuggestionState)

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

{
  "objectIds": [
    string
  ]
}

string

ID des objets.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}

string

ID d'insertion suggérés. Un élément SectionBreak 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 suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (SectionStyle)

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

{
  "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
}

object (SectionColumnProperties)

Propriétés des colonnes de la section.

Si ce champ est vide, la section contient une colonne avec les propriétés par défaut de l'éditeur Docs. Une section ne peut pas comporter plus de trois colonnes.

Lors de la mise à jour de cette propriété, vous devez définir une valeur concrète. La réinitialisation de cette propriété entraînera une erreur 400 de requête incorrecte.

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.

Lors de la mise à jour de cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

enum (ContentDirection)

Orientation du contenu de cette section. Si cette règle n'est pas configurée, la valeur par défaut est LEFT_TO_RIGHT.

Lors de la mise à jour de cette propriété, vous devez définir une valeur concrète. Si vous ne définissez pas cette propriété, une erreur 400 "Bad Request" (Mauvaise requête) s'affiche.

object (Dimension)

Marge supérieure de la page de la section. Si ce champ n'est pas défini, la valeur par défaut est marginTop à partir de DocumentStyle.

Lors de la mise à jour de cette propriété, vous devez définir une valeur concrète. La réinitialisation de cette propriété génère une erreur 400 de requête incorrecte.

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.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. La réinitialisation de cette propriété génère une erreur 400 de requête incorrecte.

object (Dimension)

Marge de droite de la section. Si ce champ n'est pas défini, la valeur par défaut est marginRight à partir de DocumentStyle. La modification de la marge droite entraîne le redimensionnement des colonnes de cette section. Étant donné que la marge a une incidence sur la largeur de la colonne, elle est appliquée avant les propriétés de la 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 "Bad Request" (Mauvaise requête) s'affiche.

object (Dimension)

Marge de gauche de la section. Si cette règle n'est pas configurée, la valeur par défaut de DocumentStyle est marginLeft. La modification de la marge de gauche entraîne le redimensionnement des colonnes de cette section. Étant donné que la marge affecte la largeur de la colonne, elle est appliquée avant les propriétés de la colonne.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. La réinitialisation de cette propriété génère une erreur 400 de requête incorrecte.

object (Dimension)

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

Lors de la mise à jour de cette propriété, vous devez définir une valeur concrète. La réinitialisation de cette propriété génère une erreur 400 de requête incorrecte.

object (Dimension)

Marge du pied de page de la section. Si ce champ n'est pas défini, la valeur par défaut est marginFooter à partir de DocumentStyle. En cas de mise à jour, useCustomHeaderFooterMargins est défini sur "true" sur DocumentStyle. La valeur useCustomHeaderFooterMargins sur DocumentStyle indique si une marge de pied de page est respectée pour cette section

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. La réinitialisation de cette propriété génère une erreur 400 de requête incorrecte.

enum (SectionType)

Uniquement en sortie. Type de section.

string

ID de l'en-tête par défaut. Si cette règle n'est pas configurée, la valeur hérite du style de section SectionBreak's précédent. Si la valeur n'est pas définie dans le premier saut de section, elle hérite de la propriété defaultHeaderId de DocumentStyle.

Cette propriété est en lecture seule.

string

ID du pied de page par défaut. Si cette règle n'est pas configurée, la valeur hérite du style de section SectionBreak's précédent. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de defaultFooterId de DocumentStyle.

Cette propriété est en lecture seule.

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 cette règle n'est pas configurée, la valeur hérite du style de section SectionBreak's précédent. Si la valeur n'est pas définie dans le premier saut de section, elle hérite de la propriété firstPageHeaderId de DocumentStyle.

Cette propriété est en lecture seule.

string

ID du pied de page utilisé uniquement pour la première page de la section. Si useFirstPageHeaderFooter est défini sur "true", cette valeur est utilisée pour le pied de page de la première page de la section. Si la valeur est "false", le pied de page de la première page de la section utilise defaultFooterId. Si cette règle n'est pas configurée, la valeur hérite du style de section SectionBreak's précédent. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de firstPageFooterId de DocumentStyle.

Cette propriété est en lecture seule.

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 cette valeur n'est pas définie, elle hérite de la SectionStyle SectionBreak's précédente. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de evenPageHeaderId de DocumentStyle.

Cette propriété est en lecture seule.

string

ID du pied de page utilisé uniquement pour les pages paires. Si la valeur de useEvenPageHeaderFooter de DocumentStyle est "true", cette valeur est utilisée pour les pieds de page des pages paires de la section. Si la valeur est "false", les pieds de page des pages paires utilisent defaultFooterId. Si cette règle n'est pas configurée, la valeur hérite du style de section SectionBreak's précédent. Si la valeur n'est pas définie dans le premier SectionBreak, elle hérite de evenPageFooterId de DocumentStyle.

Cette propriété est en lecture seule.

boolean

Indique s'il faut utiliser les ID d'en-tête / pied de page de la première page pour la première page de la section. Si cette règle n'est pas configurée, elle hérite du paramètre useFirstPageHeaderFooter de DocumentStyle pour la première section. Si la valeur n'est pas définie pour les secteurs suivants, elle doit être interprétée comme "false".

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 "Bad Request" (Mauvaise requête) s'affiche.

integer

Numéro de page à partir duquel commencer à compter le nombre de pages de cette section. Si cette règle n'est pas configurée, la numérotation des pages continue à partir de la section précédente. Si la valeur n'est pas définie dans la première SectionBreak, consultez la pageNumberStart de DocumentStyle.

Lorsque vous mettez à jour cette propriété, vous devez définir une valeur concrète. La réinitialisation de cette propriété génère une erreur 400 de requête incorrecte.

boolean

Facultatif. Indique si les dimensions du pageSize de DocumentStyle doivent être inversées pour cette section, ce qui permet de changer l'orientation de la page entre portrait et paysage. Si cette règle n'est pas configurée, la valeur hérite de la propriété flipPageOrientation de DocumentStyle.

Lors de la mise à jour de cette propriété, vous devez définir une valeur concrète. La réinitialisation de cette propriété génère une erreur 400 de requête incorrecte.

{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}

object (Dimension)

Uniquement en sortie. Largeur de la colonne.

object (Dimension)

Marge intérieure à la fin de la colonne.

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

integer

Nombre de lignes dans la table.

integer

Nombre de colonnes dans le tableau.

Il est possible qu'un tableau ne soit pas rectangulaire, c'est pourquoi certaines lignes peuvent comporter un nombre de cellules différent.

object (TableRow)

Contenu et style de chaque ligne.

string

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

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TableStyle)

Style de la table.

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

integer

Index de départ basé sur zéro de cette ligne, exprimé en unités de code UTF-16.

integer

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

object (TableCell)

Contenu et style de chaque cellule de cette ligne.

Un tableau peut ne pas être rectangulaire. Par conséquent, le nombre de cellules de certaines lignes peut être différent de celui des autres lignes du même tableau.

string

ID d'insertion suggérés. Un élément TableRow 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 suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

object (TableRowStyle)

Style de la ligne du tableau.

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

Le style suggéré change pour cette ligne, en fonction de l'ID de suggestion.

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

integer

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

integer

L'index de fin basé sur zéro de cette cellule, exclusif, en unités de code UTF-16.

object (StructuralElement)

Contenu de la cellule.

object (TableCellStyle)

Style de la cellule.

string

ID d'insertion suggérés. Un TableCell peut comporter 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 suggestion d'insertion.

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

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

Modifications suggérées pour le style de cellule du tableau, associées à l'ID de suggestion.

{
  "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)
}

integer

Étendue de lignes de la cellule.

Cette propriété est en lecture seule.

integer

Colonne s'étendant sur la cellule.

Cette propriété est en lecture seule.

object (OptionalColor)

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

object (TableCellBorder)

Bordure gauche de la cellule.

object (TableCellBorder)

Bordure droite de la cellule.

object (TableCellBorder)

Bordure supérieure de la cellule.

object (TableCellBorder)

Bordure inférieure de la cellule.

object (Dimension)

Marge intérieure gauche de la cellule.

object (Dimension)

Marge intérieure droite de la cellule.

object (Dimension)

Marge intérieure supérieure de la cellule.

object (Dimension)

Marge intérieure inférieure de la cellule.

enum (ContentAlignment)

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

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

Couleur de la bordure.

Cette couleur ne peut pas être transparente.

object (Dimension)

Largeur de la bordure.

enum (DashStyle)

Style de tiret de la bordure.

{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}

object (TableCellStyle)

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

object (TableCellStyleSuggestionState)

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

{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}

object (Dimension)

Hauteur minimale de la ligne. La ligne s'affiche dans l'éditeur Docs avec une hauteur égale ou supérieure à cette valeur afin d'afficher tout le contenu de ses cellules.

boolean

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

boolean

Indique si la ligne ne peut pas dépasser les limites de page ou de colonne.

{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}

object (TableRowStyle)

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

object (TableRowStyleSuggestionState)

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

{
  "minRowHeightSuggested": boolean
}

boolean

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

{
  "tableColumnProperties": [
    {
      object (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 dans HTML. Ainsi, les propriétés d'une ligne se trouvent dans l'élément tableRowStyle de la ligne.

{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}

enum (WidthType)

Type de largeur de la colonne.

object (Dimension)

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

{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

object (StructuralElement)

Contenu de la table des matières.

string

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

string

ID de suppression suggérés. Si ce champ est vide, aucune suggestion de suppression de ce contenu n'est proposée.

{
  "headerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

ID de l'en-tête.

object (StructuralElement)

Contenu de l'en-tête.

Les index du contenu d'un en-tête commencent à zéro.

{
  "footerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

ID du pied de page.

object (StructuralElement)

Contenu du pied de page.

Les index du contenu d'un pied de page commencent à zéro.

{
  "footnoteId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

ID de la note de bas de page.

object (StructuralElement)

Contenu de la note de bas de page.

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

{
  "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
}

object (Background)

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

string

ID de l'en-tête par défaut. Si cette règle n'est pas configurée, il n'y a pas d'en-tête par défaut.

Cette propriété est en lecture seule.

string

ID du pied de page par défaut. Si cette règle n'est pas configurée, il n'y a pas de pied de page par défaut.

Cette propriété est en lecture seule.

string

ID de l'en-tête utilisé uniquement pour les pages paires. La valeur de useEvenPageHeaderFooter détermine si vous devez utiliser defaultHeaderId ou cette valeur pour l'en-tête sur les pages paires. Si cette règle n'est pas configurée, il n'y a pas d'en-tête de page paire.

Cette propriété est en lecture seule.

string

ID du pied de page utilisé uniquement pour les pages paires. La valeur de useEvenPageHeaderFooter détermine si la valeur defaultFooterId ou celle-ci doit être utilisée pour le pied de page sur les pages paires. Si cette règle n'est pas configurée, il n'y a pas de pied de page paire.

Cette propriété est en lecture seule.

string

ID de l'en-tête utilisé uniquement pour la première page. Si cette règle n'est pas configurée, aucun en-tête unique n'existe 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é.

Cette propriété est en lecture seule.

string

ID du pied de page utilisé uniquement pour la première page. Si cette règle n'est pas configurée, aucun pied de page unique n'existe pour la première page. La valeur de useFirstPageHeaderFooter détermine s'il faut utiliser defaultFooterId ou cette valeur pour le pied de page de la première page. Si cette règle n'est pas configurée, il n'y a pas de pied de page de première page.

Cette propriété est en lecture seule.

boolean

Indique s'il faut utiliser les ID d'en-tête / pied de page de la première page pour la première page.

boolean

Indique si les ID d'en-tête / pied de page des pages paires doivent être utilisés.

integer

Numéro de page à partir duquel commencer à compter le nombre de pages.

object (Dimension)

Marge supérieure de la page.

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

object (Dimension)

Marge inférieure de la page.

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

object (Dimension)

Marge de droite de la page.

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

object (Dimension)

Marge de gauche de la page.

La modification de la marge gauche de la page dans le style du document la supprime pour tous les styles de section. Cela peut également entraîner le redimensionnement des colonnes dans toutes les sections.

object (Size)

Taille d'une page du document.

object (Dimension)

Espace entre le haut de la page et le contenu de l'en-tête.

object (Dimension)

Espace entre le bas de la page et le contenu du pied de page.

boolean

Indique si les valeurs DocumentStyle marginHeader, SectionStyle marginHeader et DocumentStyle marginFooter, SectionStyle marginFooter sont respectées. Si la valeur est "false", les valeurs par défaut de l'éditeur Docs pour la marge d'en-tête et de pied de page sont utilisées.

Cette propriété est en lecture seule.

boolean

Facultatif. Indique si les dimensions du pageSize doivent être inversées, ce qui permet de modifier l'orientation de la page entre portrait et paysage.

{
  "color": {
    object (OptionalColor)
  }
}

object (OptionalColor)

Couleur de l'arrière-plan.