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, qui sont imbriqués dans un autre onglet. Les onglets enfants sont représentés par le champ Tab.child_tabs.

string

Uniquement en sortie. ID de 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. Renseigné uniquement 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 n'est pas modifié 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 changements de format de l'ID.

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 SUGGESTIONS_INLINE.

object (Body)

Uniquement en sortie. Corps principal du document.

Ancien champ: utilisez plutôt Document.tabs.document_tab.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 qu'elle n'est pas configurée, 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.document_tab.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.document_tab.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, associées par leur ID.

Ancien champ: utilisez plutôt Document.tabs.document_tab.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.document_tab.document_style, 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 (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.document_tab.suggested_document_style_changes, 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.document_tab.named_styles, 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 (SuggestedNamedStyles))

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

Ancien champ: utilisez plutôt Document.tabs.document_tab.suggested_named_styles_changes, 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.document_tab.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.document_tab.named_ranges, 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.document_tab.inline_objects, 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 (PositionedObject))

Uniquement en sortie. Objets positionnés dans le document, associés par ID d'objet.

Ancien champ: utilisez plutôt Document.tabs.document_tab.positioned_objects, 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, telles que l'ID et le titre.

object (Tab)

Onglets enfants imbriqués dans cet onglet

object (DocumentTab)

Un onglet avec le contenu d'un 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 de l'onglet visible par les utilisateurs.

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, associé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))

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

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, associés par ID d'objet

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

Objets positionnés dans l'onglet du document, associé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 basé sur zéro de cet élément structurel, exclusif, 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 remplacé par ce paragraphe, associé à l'ID de suggestion.

object (Bullet)

Puce de ce paragraphe. S'il n'est pas présent, le paragraphe n'appartient pas à une liste.

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

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

string

ID des objets positionnés qui sont partagés avec 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 faisant référence à une note de bas de page.

object (HorizontalRule)

Élément de paragraphe de règle 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 vers 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 non textuels lors de l'exécution sont remplacés par le caractère Unicode U+E907.

string

ID d'insertion suggérés. Un élément TextRun 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 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. S'il est défini, la couleur est soit une couleur RVB, soit 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 à la fois 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.

La modification du lien dans une demande 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 par défaut du lien, 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 dans une plage de texte qui chevauche un lien existant, le lien existant sera également mis à jour de sorte qu'il pointe vers la nouvelle URL.
• Les liens ne peuvent pas être définis sur les caractères de retour à la 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 est 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)

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

{
  "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, de 0,0 à 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 la magnitude.

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

string

Famille de polices du texte

Vous pouvez choisir n'importe quelle famille de polices dans le menu "Police" de Docs ou dans 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 contenir n'importe quelle valeur correspondant à un multiple de 100, compris 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 représente qu'un seul composant de l'épaisseur de la police affichée. Une combinaison de weight et de la valeur bold résolue du style de texte détermine l'épaisseur de rendu, 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 de rendu est de 400.
• Si le texte est en gras et que l'épaisseur est supérieure ou égale à 400, mais inférieure à 700, l'épaisseur de rendu 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 favoris d'un onglet unique continuent de renvoyer Link.bookmark_id lorsque le paramètre includeTabsContent est défini sur false ou n'est pas 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.heading_id 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 signet dans ce document.

Ancien champ: définissez plutôt 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 dans ce document.

Ancien champ: définissez plutôt 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 une seule tabulation et renvoie vers un en-tête dans l'onglet singulier. 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 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.

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

string

ID d'un signet 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 les nouvelles valeurs correspondantes.

object (TextStyleSuggestionState)

Masque qui indique quels champs de la base TextStyle 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 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, 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 ce texte automatique.

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, 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 ce saut de page.

Comme pour le contenu textuel, comme les courses 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, 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 ce ColumnBreak.

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

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

Le style de texte suggéré est remplacé par ce ColumnBreak, 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 élément FootnoteReference 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 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, associée à 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 HorizontalRule 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 cette règle HorizontalRule.

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

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, 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.

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

Comme pour le contenu textuel, comme les courses de texte et les références aux notes de bas de page, le style de texte d'un élément d'objet intégré 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 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 de suppression du lien de cette personne du document. Un élément 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 ce Person.

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

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

object (PersonProperties)

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

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

string

Uniquement en sortie. Nom de la personne s'il est affiché dans le texte du lien à la place 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 élément RichLink 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 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, la suppression du lien vers cette personne n'est pas suggérée.

object (TextStyle)

Style de texte de ce RichLink.

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

Le style de texte suggéré est remplacé par ce 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 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.

string

Uniquement en sortie. L'URI de RichLink. Elle est toujours présente.

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 titre du paragraphe. S'il 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 mise à jour du type de style nommé affecte les autres propriétés de ParagraphStyle, il est appliqué avant la mise à jour des autres propriétés.

enum (Alignment)

Alignement du texte de ce paragraphe.

number

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

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 règle n'est pas configurée, la valeur 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.

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 en haut de ce paragraphe. Si cette règle n'est pas configurée, la valeur est héritée du parent.

La bordure supérieure s'affiche lorsque le paragraphe ci-dessus 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, la nouvelle bordure doit être spécifiée dans son intégralité.

object (ParagraphBorder)

Bordure au bas de ce paragraphe. Si cette règle n'est pas configurée, la valeur 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, la nouvelle bordure doit être spécifiée 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 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 (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)

Nombre de retraits du paragraphe sur le côté qui correspond à la fin 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 (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 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

Permet d'éviter les veuves et les orphelins 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 inclut uniquement les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec paragraphStyleSuggestionState pour identifier les champs qui ont été modifiés et les nouvelles valeurs correspondantes.

object (ParagraphStyleSuggestionState)

Masque qui indique quels champs de la base ParagraphStyle 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 qui indique 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 Shading.

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

string

ID de la liste à laquelle appartient ce paragraphe.

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 inclut uniquement les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec bulletSuggestionState pour identifier les champs qui ont été modifiés et les nouvelles valeurs correspondantes.

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 listId.

boolean

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

object (TextStyleSuggestionState)

Masque qui indique 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, 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 (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. La réinitialisation de cette propriété génère une erreur 400 de requête incorrecte.

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. La réinitialisation de cette propriété génère une erreur 400 de requête incorrecte.

object (Dimension)

Marge supérieure de la page de la section. Si cette règle n'est pas configurée, la valeur par défaut de DocumentStyle est marginTop.

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 cette règle n'est pas configurée, la valeur par défaut de DocumentStyle est marginBottom.

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 droite de la page de la section. Si cette règle n'est pas configurée, la valeur par défaut de DocumentStyle est marginRight. 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.

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 gauche de la page 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 a une incidence sur la largeur de la colonne, elle est appliquée avant les propriétés de la colonne.

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 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" pour 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 cette règle n'est pas configurée, la valeur par défaut de DocumentStyle est marginFooter. 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

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.

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 saut de section, elle hérite de la propriété 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 "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 sur 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 saut de section, elle hérite de la propriété 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 du paramètre useEvenPageHeaderFooter de DocumentStyle est "true", cette valeur est utilisée pour les en-têtes sur les pages paires de la section. Si la valeur est "false", les en-têtes des pages paires utilisent 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é 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 sur les 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 saut de section, elle hérite de la propriété 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 cette valeur n'est pas définie pour les secteurs suivants, elle doit être interprétée comme étant "false".

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.

integer

Numéro de page à partir duquel commencer à compter le nombre de pages pour 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.

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.

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 contenir un nombre de cellules différent.

object (TableRow)

Contenu et style de chaque ligne.

string

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

Style du tableau.

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

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

object (TableCell)

Contenu et style de chaque cellule de cette ligne.

Il est possible qu'un tableau ne soit pas rectangulaire, c'est pourquoi certaines lignes peuvent contenir un nombre de cellules différent de celui d'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, 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 (TableRowStyle)

Style de la ligne du tableau.

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

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

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

integer

L'index de départ basé sur zéro de cette cellule, 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 élément TableCell 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.

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

Étendue de colonne de 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 à l'alignement des nouvelles cellules de tableau 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 inclut uniquement les modifications apportées dans cette suggestion. Vous pouvez l'utiliser avec tableCellStyleSuggestionState pour identifier les champs qui ont été modifiés et les nouvelles valeurs correspondantes.

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 correspond à un en-tête de tableau.

boolean

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

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

object (TableRowStyle)

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

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 des lignes des cellules, de la même manière que 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 widthType de la colonne est défini sur 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 une 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 s'il faut 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 cette règle n'est pas configurée, il n'y a pas d'en-tête de première page.

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.

La modification de la marge supérieure de la page dans le style du document la supprime pour tous les styles de section.

object (Dimension)

Marge inférieure de la page.

La modification de la marge inférieure de la page dans le style du document la supprime pour tous les styles de section.

object (Dimension)

Marge 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 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)

Quantité d'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 DocumentStyle marginHeader, SectionStyle marginHeader, DocumentStyle marginFooter et SectionStyle marginFooter sont respectés. Si la valeur est "false", les valeurs par défaut de la marge de l'en-tête et du pied de page sont utilisées dans l'éditeur Docs.

Cette propriété est en lecture seule.

boolean

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

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

object (OptionalColor)