commit a8b35b9481ec86d3034367a3248fd0cafab9e3e9
author yoshi-code-bot <70984784+yoshi-code-bot@users.noreply.github.com> Wed Mar 31 13:33:30 2021 -0700
committer GitHub <noreply@github.com> Wed Mar 31 16:33:30 2021 -0400
tree 566a08b2fe8f7b5b1848d6974e6036199bd4d366
parent f6c78a8b24c6fd6a8207f72ea778195836bb543d

chore: Update discovery artifacts (#1269)

* chore(accessapproval): update the api
* chore(accesscontextmanager): update the api
* chore(apigateway): update the api
* chore(area120tables): update the api
* chore(bigquerydatatransfer): update the api
* chore(billingbudgets): update the api
* chore(calendar): update the api
* chore(chat): update the api
* chore(cloudbilling): update the api
* chore(cloudfunctions): update the api
* chore(cloudkms): update the api
* chore(cloudprofiler): update the api
* chore(cloudscheduler): update the api
* chore(cloudshell): update the api
* chore(cloudtasks): update the api
* chore(composer): update the api
* chore(datalabeling): update the api
* chore(datamigration): update the api
* chore(deploymentmanager): update the api
* chore(dlp): update the api
* chore(doubleclickbidmanager): update the api
* chore(drive): update the api
* chore(driveactivity): update the api
* chore(eventarc): update the api
* chore(fcm): update the api
* chore(firebaseml): update the api
* chore(firestore): update the api
* chore(gameservices): update the api
* chore(genomics): update the api
* chore(groupsmigration): update the api
* chore(iam): update the api
* chore(language): update the api
* chore(libraryagent): update the api
* chore(lifesciences): update the api
* chore(logging): update the api
* chore(monitoring): update the api
* chore(policytroubleshooter): update the api
* chore(recommendationengine): update the api
* chore(recommender): update the api
* chore(redis): update the api
* chore(runtimeconfig): update the api
* chore(script): update the api
* chore(serviceconsumermanagement): update the api
* chore(servicedirectory): update the api
* chore(servicenetworking): update the api
* chore(serviceusage): update the api
* chore(sheets): update the api
* chore(texttospeech): update the api
* chore(toolresults): update the api
* chore(transcoder): update the api
* chore(translate): update the api
* chore(vision): update the api
* chore(workflows): update the api

Co-authored-by: Yoshi Automation <yoshi-automation@google.com>
Co-authored-by: Anthonios Partheniou <partheniou@google.com>

docs/dyn/docs_v1.documents.html

diff --git a/docs/dyn/docs_v1.documents.html b/docs/dyn/docs_v1.documents.html
index 29fd9d3..ed0cbe8 100644
--- a/docs/dyn/docs_v1.documents.html
+++ b/docs/dyn/docs_v1.documents.html
@@ -1526,6 +1526,114 @@
                   },
                 },
               },
+              "person": { # A person or email address mentioned in a document. These mentions behave as a single, immutable element containing the person's name or email address. # A paragraph element that links to a person or email address.
+                "personId": "A String", # Output only. The unique ID of this link.
+                "personProperties": { # Properties specific to a linked Person. # Output only. The properties of this Person. This field is always present.
+                  "email": "A String", # Output only. The email address linked to this Person. This field is always present.
+                  "name": "A String", # Output only. The name of the person if it is displayed in the link text instead of the person's email address.
+                },
+                "suggestedDeletionIds": [ # IDs for suggestions that remove this person link from the document. A Person might have multiple deletion IDs if, for example, multiple users suggest to delete it. If empty, then this person link isn't suggested for deletion.
+                  "A String",
+                ],
+                "suggestedInsertionIds": [ # IDs for suggestions that insert this person link into the document. A Person might have multiple insertion IDs if it is a nested suggested change (a suggestion within a suggestion made by a different user, for example). If empty, then this person link isn't a suggested insertion.
+                  "A String",
+                ],
+                "suggestedTextStyleChanges": { # The suggested text style changes to this Person, keyed by suggestion ID.
+                  "a_key": { # A suggested change to a TextStyle.
+                    "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # A TextStyle that only includes the changes made in this suggestion. This can be used along with the text_style_suggestion_state to see which fields have changed and their new values.
+                      "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                        "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                          "rgbColor": { # An RGB color. # The RGB color value.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                      },
+                      "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                      "bold": True or False, # Whether or not the text is rendered as bold.
+                      "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                      "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                        "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                          "rgbColor": { # An RGB color. # The RGB color value.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                      },
+                      "italic": True or False, # Whether or not the text is italicized.
+                      "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                        "bookmarkId": "A String", # The ID of a bookmark in this document.
+                        "headingId": "A String", # The ID of a heading in this document.
+                        "url": "A String", # An external URL.
+                      },
+                      "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                      "strikethrough": True or False, # Whether or not the text is struck through.
+                      "underline": True or False, # Whether or not the text is underlined.
+                      "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                        "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                        "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                      },
+                    },
+                    "textStyleSuggestionState": { # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. For any field set to true, there is a new suggested value. # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion.
+                      "backgroundColorSuggested": True or False, # Indicates if there was a suggested change to background_color.
+                      "baselineOffsetSuggested": True or False, # Indicates if there was a suggested change to baseline_offset.
+                      "boldSuggested": True or False, # Indicates if there was a suggested change to bold.
+                      "fontSizeSuggested": True or False, # Indicates if there was a suggested change to font_size.
+                      "foregroundColorSuggested": True or False, # Indicates if there was a suggested change to foreground_color.
+                      "italicSuggested": True or False, # Indicates if there was a suggested change to italic.
+                      "linkSuggested": True or False, # Indicates if there was a suggested change to link.
+                      "smallCapsSuggested": True or False, # Indicates if there was a suggested change to small_caps.
+                      "strikethroughSuggested": True or False, # Indicates if there was a suggested change to strikethrough.
+                      "underlineSuggested": True or False, # Indicates if there was a suggested change to underline.
+                      "weightedFontFamilySuggested": True or False, # Indicates if there was a suggested change to weighted_font_family.
+                    },
+                  },
+                },
+                "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # The text style of this Person.
+                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                    "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                      "rgbColor": { # An RGB color. # The RGB color value.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                  },
+                  "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                  "bold": True or False, # Whether or not the text is rendered as bold.
+                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                    "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                      "rgbColor": { # An RGB color. # The RGB color value.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                  },
+                  "italic": True or False, # Whether or not the text is italicized.
+                  "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                    "bookmarkId": "A String", # The ID of a bookmark in this document.
+                    "headingId": "A String", # The ID of a heading in this document.
+                    "url": "A String", # An external URL.
+                  },
+                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                  "strikethrough": True or False, # Whether or not the text is struck through.
+                  "underline": True or False, # Whether or not the text is underlined.
+                  "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                    "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                    "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                  },
+                },
+              },
               "startIndex": 42, # The zero-based start index of this paragraph element, in UTF-16 code units.
               "textRun": { # A ParagraphElement that represents a run of text that all has the same styling. # A text run paragraph element.
                 "content": "A String", # The text of this run. Any non-text elements in the run are replaced with the Unicode character U+E907.
@@ -3123,6 +3231,114 @@
                     },
                   },
                 },
+                "person": { # A person or email address mentioned in a document. These mentions behave as a single, immutable element containing the person's name or email address. # A paragraph element that links to a person or email address.
+                  "personId": "A String", # Output only. The unique ID of this link.
+                  "personProperties": { # Properties specific to a linked Person. # Output only. The properties of this Person. This field is always present.
+                    "email": "A String", # Output only. The email address linked to this Person. This field is always present.
+                    "name": "A String", # Output only. The name of the person if it is displayed in the link text instead of the person's email address.
+                  },
+                  "suggestedDeletionIds": [ # IDs for suggestions that remove this person link from the document. A Person might have multiple deletion IDs if, for example, multiple users suggest to delete it. If empty, then this person link isn't suggested for deletion.
+                    "A String",
+                  ],
+                  "suggestedInsertionIds": [ # IDs for suggestions that insert this person link into the document. A Person might have multiple insertion IDs if it is a nested suggested change (a suggestion within a suggestion made by a different user, for example). If empty, then this person link isn't a suggested insertion.
+                    "A String",
+                  ],
+                  "suggestedTextStyleChanges": { # The suggested text style changes to this Person, keyed by suggestion ID.
+                    "a_key": { # A suggested change to a TextStyle.
+                      "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # A TextStyle that only includes the changes made in this suggestion. This can be used along with the text_style_suggestion_state to see which fields have changed and their new values.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                        "bold": True or False, # Whether or not the text is rendered as bold.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                          "bookmarkId": "A String", # The ID of a bookmark in this document.
+                          "headingId": "A String", # The ID of a heading in this document.
+                          "url": "A String", # An external URL.
+                        },
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                          "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                          "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                        },
+                      },
+                      "textStyleSuggestionState": { # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. For any field set to true, there is a new suggested value. # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion.
+                        "backgroundColorSuggested": True or False, # Indicates if there was a suggested change to background_color.
+                        "baselineOffsetSuggested": True or False, # Indicates if there was a suggested change to baseline_offset.
+                        "boldSuggested": True or False, # Indicates if there was a suggested change to bold.
+                        "fontSizeSuggested": True or False, # Indicates if there was a suggested change to font_size.
+                        "foregroundColorSuggested": True or False, # Indicates if there was a suggested change to foreground_color.
+                        "italicSuggested": True or False, # Indicates if there was a suggested change to italic.
+                        "linkSuggested": True or False, # Indicates if there was a suggested change to link.
+                        "smallCapsSuggested": True or False, # Indicates if there was a suggested change to small_caps.
+                        "strikethroughSuggested": True or False, # Indicates if there was a suggested change to strikethrough.
+                        "underlineSuggested": True or False, # Indicates if there was a suggested change to underline.
+                        "weightedFontFamilySuggested": True or False, # Indicates if there was a suggested change to weighted_font_family.
+                      },
+                    },
+                  },
+                  "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # The text style of this Person.
+                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                    "bold": True or False, # Whether or not the text is rendered as bold.
+                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "italic": True or False, # Whether or not the text is italicized.
+                    "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                      "bookmarkId": "A String", # The ID of a bookmark in this document.
+                      "headingId": "A String", # The ID of a heading in this document.
+                      "url": "A String", # An external URL.
+                    },
+                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                    "strikethrough": True or False, # Whether or not the text is struck through.
+                    "underline": True or False, # Whether or not the text is underlined.
+                    "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                      "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                      "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                    },
+                  },
+                },
                 "startIndex": 42, # The zero-based start index of this paragraph element, in UTF-16 code units.
                 "textRun": { # A ParagraphElement that represents a run of text that all has the same styling. # A text run paragraph element.
                   "content": "A String", # The text of this run. Any non-text elements in the run are replaced with the Unicode character U+E907.
@@ -4664,6 +4880,114 @@
                     },
                   },
                 },
+                "person": { # A person or email address mentioned in a document. These mentions behave as a single, immutable element containing the person's name or email address. # A paragraph element that links to a person or email address.
+                  "personId": "A String", # Output only. The unique ID of this link.
+                  "personProperties": { # Properties specific to a linked Person. # Output only. The properties of this Person. This field is always present.
+                    "email": "A String", # Output only. The email address linked to this Person. This field is always present.
+                    "name": "A String", # Output only. The name of the person if it is displayed in the link text instead of the person's email address.
+                  },
+                  "suggestedDeletionIds": [ # IDs for suggestions that remove this person link from the document. A Person might have multiple deletion IDs if, for example, multiple users suggest to delete it. If empty, then this person link isn't suggested for deletion.
+                    "A String",
+                  ],
+                  "suggestedInsertionIds": [ # IDs for suggestions that insert this person link into the document. A Person might have multiple insertion IDs if it is a nested suggested change (a suggestion within a suggestion made by a different user, for example). If empty, then this person link isn't a suggested insertion.
+                    "A String",
+                  ],
+                  "suggestedTextStyleChanges": { # The suggested text style changes to this Person, keyed by suggestion ID.
+                    "a_key": { # A suggested change to a TextStyle.
+                      "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # A TextStyle that only includes the changes made in this suggestion. This can be used along with the text_style_suggestion_state to see which fields have changed and their new values.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                        "bold": True or False, # Whether or not the text is rendered as bold.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                          "bookmarkId": "A String", # The ID of a bookmark in this document.
+                          "headingId": "A String", # The ID of a heading in this document.
+                          "url": "A String", # An external URL.
+                        },
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                          "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                          "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                        },
+                      },
+                      "textStyleSuggestionState": { # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. For any field set to true, there is a new suggested value. # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion.
+                        "backgroundColorSuggested": True or False, # Indicates if there was a suggested change to background_color.
+                        "baselineOffsetSuggested": True or False, # Indicates if there was a suggested change to baseline_offset.
+                        "boldSuggested": True or False, # Indicates if there was a suggested change to bold.
+                        "fontSizeSuggested": True or False, # Indicates if there was a suggested change to font_size.
+                        "foregroundColorSuggested": True or False, # Indicates if there was a suggested change to foreground_color.
+                        "italicSuggested": True or False, # Indicates if there was a suggested change to italic.
+                        "linkSuggested": True or False, # Indicates if there was a suggested change to link.
+                        "smallCapsSuggested": True or False, # Indicates if there was a suggested change to small_caps.
+                        "strikethroughSuggested": True or False, # Indicates if there was a suggested change to strikethrough.
+                        "underlineSuggested": True or False, # Indicates if there was a suggested change to underline.
+                        "weightedFontFamilySuggested": True or False, # Indicates if there was a suggested change to weighted_font_family.
+                      },
+                    },
+                  },
+                  "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # The text style of this Person.
+                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                    "bold": True or False, # Whether or not the text is rendered as bold.
+                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "italic": True or False, # Whether or not the text is italicized.
+                    "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                      "bookmarkId": "A String", # The ID of a bookmark in this document.
+                      "headingId": "A String", # The ID of a heading in this document.
+                      "url": "A String", # An external URL.
+                    },
+                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                    "strikethrough": True or False, # Whether or not the text is struck through.
+                    "underline": True or False, # Whether or not the text is underlined.
+                    "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                      "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                      "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                    },
+                  },
+                },
                 "startIndex": 42, # The zero-based start index of this paragraph element, in UTF-16 code units.
                 "textRun": { # A ParagraphElement that represents a run of text that all has the same styling. # A text run paragraph element.
                   "content": "A String", # The text of this run. Any non-text elements in the run are replaced with the Unicode character U+E907.
@@ -6205,6 +6529,114 @@
                     },
                   },
                 },
+                "person": { # A person or email address mentioned in a document. These mentions behave as a single, immutable element containing the person's name or email address. # A paragraph element that links to a person or email address.
+                  "personId": "A String", # Output only. The unique ID of this link.
+                  "personProperties": { # Properties specific to a linked Person. # Output only. The properties of this Person. This field is always present.
+                    "email": "A String", # Output only. The email address linked to this Person. This field is always present.
+                    "name": "A String", # Output only. The name of the person if it is displayed in the link text instead of the person's email address.
+                  },
+                  "suggestedDeletionIds": [ # IDs for suggestions that remove this person link from the document. A Person might have multiple deletion IDs if, for example, multiple users suggest to delete it. If empty, then this person link isn't suggested for deletion.
+                    "A String",
+                  ],
+                  "suggestedInsertionIds": [ # IDs for suggestions that insert this person link into the document. A Person might have multiple insertion IDs if it is a nested suggested change (a suggestion within a suggestion made by a different user, for example). If empty, then this person link isn't a suggested insertion.
+                    "A String",
+                  ],
+                  "suggestedTextStyleChanges": { # The suggested text style changes to this Person, keyed by suggestion ID.
+                    "a_key": { # A suggested change to a TextStyle.
+                      "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # A TextStyle that only includes the changes made in this suggestion. This can be used along with the text_style_suggestion_state to see which fields have changed and their new values.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                        "bold": True or False, # Whether or not the text is rendered as bold.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                          "bookmarkId": "A String", # The ID of a bookmark in this document.
+                          "headingId": "A String", # The ID of a heading in this document.
+                          "url": "A String", # An external URL.
+                        },
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                          "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                          "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                        },
+                      },
+                      "textStyleSuggestionState": { # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. For any field set to true, there is a new suggested value. # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion.
+                        "backgroundColorSuggested": True or False, # Indicates if there was a suggested change to background_color.
+                        "baselineOffsetSuggested": True or False, # Indicates if there was a suggested change to baseline_offset.
+                        "boldSuggested": True or False, # Indicates if there was a suggested change to bold.
+                        "fontSizeSuggested": True or False, # Indicates if there was a suggested change to font_size.
+                        "foregroundColorSuggested": True or False, # Indicates if there was a suggested change to foreground_color.
+                        "italicSuggested": True or False, # Indicates if there was a suggested change to italic.
+                        "linkSuggested": True or False, # Indicates if there was a suggested change to link.
+                        "smallCapsSuggested": True or False, # Indicates if there was a suggested change to small_caps.
+                        "strikethroughSuggested": True or False, # Indicates if there was a suggested change to strikethrough.
+                        "underlineSuggested": True or False, # Indicates if there was a suggested change to underline.
+                        "weightedFontFamilySuggested": True or False, # Indicates if there was a suggested change to weighted_font_family.
+                      },
+                    },
+                  },
+                  "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # The text style of this Person.
+                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                    "bold": True or False, # Whether or not the text is rendered as bold.
+                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "italic": True or False, # Whether or not the text is italicized.
+                    "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                      "bookmarkId": "A String", # The ID of a bookmark in this document.
+                      "headingId": "A String", # The ID of a heading in this document.
+                      "url": "A String", # An external URL.
+                    },
+                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                    "strikethrough": True or False, # Whether or not the text is struck through.
+                    "underline": True or False, # Whether or not the text is underlined.
+                    "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                      "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                      "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                    },
+                  },
+                },
                 "startIndex": 42, # The zero-based start index of this paragraph element, in UTF-16 code units.
                 "textRun": { # A ParagraphElement that represents a run of text that all has the same styling. # A text run paragraph element.
                   "content": "A String", # The text of this run. Any non-text elements in the run are replaced with the Unicode character U+E907.
@@ -8886,6 +9318,114 @@
                   },
                 },
               },
+              "person": { # A person or email address mentioned in a document. These mentions behave as a single, immutable element containing the person's name or email address. # A paragraph element that links to a person or email address.
+                "personId": "A String", # Output only. The unique ID of this link.
+                "personProperties": { # Properties specific to a linked Person. # Output only. The properties of this Person. This field is always present.
+                  "email": "A String", # Output only. The email address linked to this Person. This field is always present.
+                  "name": "A String", # Output only. The name of the person if it is displayed in the link text instead of the person's email address.
+                },
+                "suggestedDeletionIds": [ # IDs for suggestions that remove this person link from the document. A Person might have multiple deletion IDs if, for example, multiple users suggest to delete it. If empty, then this person link isn't suggested for deletion.
+                  "A String",
+                ],
+                "suggestedInsertionIds": [ # IDs for suggestions that insert this person link into the document. A Person might have multiple insertion IDs if it is a nested suggested change (a suggestion within a suggestion made by a different user, for example). If empty, then this person link isn't a suggested insertion.
+                  "A String",
+                ],
+                "suggestedTextStyleChanges": { # The suggested text style changes to this Person, keyed by suggestion ID.
+                  "a_key": { # A suggested change to a TextStyle.
+                    "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # A TextStyle that only includes the changes made in this suggestion. This can be used along with the text_style_suggestion_state to see which fields have changed and their new values.
+                      "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                        "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                          "rgbColor": { # An RGB color. # The RGB color value.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                      },
+                      "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                      "bold": True or False, # Whether or not the text is rendered as bold.
+                      "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                      "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                        "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                          "rgbColor": { # An RGB color. # The RGB color value.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                      },
+                      "italic": True or False, # Whether or not the text is italicized.
+                      "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                        "bookmarkId": "A String", # The ID of a bookmark in this document.
+                        "headingId": "A String", # The ID of a heading in this document.
+                        "url": "A String", # An external URL.
+                      },
+                      "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                      "strikethrough": True or False, # Whether or not the text is struck through.
+                      "underline": True or False, # Whether or not the text is underlined.
+                      "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                        "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                        "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                      },
+                    },
+                    "textStyleSuggestionState": { # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. For any field set to true, there is a new suggested value. # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion.
+                      "backgroundColorSuggested": True or False, # Indicates if there was a suggested change to background_color.
+                      "baselineOffsetSuggested": True or False, # Indicates if there was a suggested change to baseline_offset.
+                      "boldSuggested": True or False, # Indicates if there was a suggested change to bold.
+                      "fontSizeSuggested": True or False, # Indicates if there was a suggested change to font_size.
+                      "foregroundColorSuggested": True or False, # Indicates if there was a suggested change to foreground_color.
+                      "italicSuggested": True or False, # Indicates if there was a suggested change to italic.
+                      "linkSuggested": True or False, # Indicates if there was a suggested change to link.
+                      "smallCapsSuggested": True or False, # Indicates if there was a suggested change to small_caps.
+                      "strikethroughSuggested": True or False, # Indicates if there was a suggested change to strikethrough.
+                      "underlineSuggested": True or False, # Indicates if there was a suggested change to underline.
+                      "weightedFontFamilySuggested": True or False, # Indicates if there was a suggested change to weighted_font_family.
+                    },
+                  },
+                },
+                "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # The text style of this Person.
+                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                    "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                      "rgbColor": { # An RGB color. # The RGB color value.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                  },
+                  "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                  "bold": True or False, # Whether or not the text is rendered as bold.
+                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                    "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                      "rgbColor": { # An RGB color. # The RGB color value.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                  },
+                  "italic": True or False, # Whether or not the text is italicized.
+                  "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                    "bookmarkId": "A String", # The ID of a bookmark in this document.
+                    "headingId": "A String", # The ID of a heading in this document.
+                    "url": "A String", # An external URL.
+                  },
+                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                  "strikethrough": True or False, # Whether or not the text is struck through.
+                  "underline": True or False, # Whether or not the text is underlined.
+                  "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                    "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                    "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                  },
+                },
+              },
               "startIndex": 42, # The zero-based start index of this paragraph element, in UTF-16 code units.
               "textRun": { # A ParagraphElement that represents a run of text that all has the same styling. # A text run paragraph element.
                 "content": "A String", # The text of this run. Any non-text elements in the run are replaced with the Unicode character U+E907.
@@ -10483,6 +11023,114 @@
                     },
                   },
                 },
+                "person": { # A person or email address mentioned in a document. These mentions behave as a single, immutable element containing the person's name or email address. # A paragraph element that links to a person or email address.
+                  "personId": "A String", # Output only. The unique ID of this link.
+                  "personProperties": { # Properties specific to a linked Person. # Output only. The properties of this Person. This field is always present.
+                    "email": "A String", # Output only. The email address linked to this Person. This field is always present.
+                    "name": "A String", # Output only. The name of the person if it is displayed in the link text instead of the person's email address.
+                  },
+                  "suggestedDeletionIds": [ # IDs for suggestions that remove this person link from the document. A Person might have multiple deletion IDs if, for example, multiple users suggest to delete it. If empty, then this person link isn't suggested for deletion.
+                    "A String",
+                  ],
+                  "suggestedInsertionIds": [ # IDs for suggestions that insert this person link into the document. A Person might have multiple insertion IDs if it is a nested suggested change (a suggestion within a suggestion made by a different user, for example). If empty, then this person link isn't a suggested insertion.
+                    "A String",
+                  ],
+                  "suggestedTextStyleChanges": { # The suggested text style changes to this Person, keyed by suggestion ID.
+                    "a_key": { # A suggested change to a TextStyle.
+                      "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # A TextStyle that only includes the changes made in this suggestion. This can be used along with the text_style_suggestion_state to see which fields have changed and their new values.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                        "bold": True or False, # Whether or not the text is rendered as bold.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                          "bookmarkId": "A String", # The ID of a bookmark in this document.
+                          "headingId": "A String", # The ID of a heading in this document.
+                          "url": "A String", # An external URL.
+                        },
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                          "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                          "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                        },
+                      },
+                      "textStyleSuggestionState": { # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. For any field set to true, there is a new suggested value. # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion.
+                        "backgroundColorSuggested": True or False, # Indicates if there was a suggested change to background_color.
+                        "baselineOffsetSuggested": True or False, # Indicates if there was a suggested change to baseline_offset.
+                        "boldSuggested": True or False, # Indicates if there was a suggested change to bold.
+                        "fontSizeSuggested": True or False, # Indicates if there was a suggested change to font_size.
+                        "foregroundColorSuggested": True or False, # Indicates if there was a suggested change to foreground_color.
+                        "italicSuggested": True or False, # Indicates if there was a suggested change to italic.
+                        "linkSuggested": True or False, # Indicates if there was a suggested change to link.
+                        "smallCapsSuggested": True or False, # Indicates if there was a suggested change to small_caps.
+                        "strikethroughSuggested": True or False, # Indicates if there was a suggested change to strikethrough.
+                        "underlineSuggested": True or False, # Indicates if there was a suggested change to underline.
+                        "weightedFontFamilySuggested": True or False, # Indicates if there was a suggested change to weighted_font_family.
+                      },
+                    },
+                  },
+                  "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # The text style of this Person.
+                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                    "bold": True or False, # Whether or not the text is rendered as bold.
+                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "italic": True or False, # Whether or not the text is italicized.
+                    "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                      "bookmarkId": "A String", # The ID of a bookmark in this document.
+                      "headingId": "A String", # The ID of a heading in this document.
+                      "url": "A String", # An external URL.
+                    },
+                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                    "strikethrough": True or False, # Whether or not the text is struck through.
+                    "underline": True or False, # Whether or not the text is underlined.
+                    "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                      "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                      "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                    },
+                  },
+                },
                 "startIndex": 42, # The zero-based start index of this paragraph element, in UTF-16 code units.
                 "textRun": { # A ParagraphElement that represents a run of text that all has the same styling. # A text run paragraph element.
                   "content": "A String", # The text of this run. Any non-text elements in the run are replaced with the Unicode character U+E907.
@@ -12024,6 +12672,114 @@
                     },
                   },
                 },
+                "person": { # A person or email address mentioned in a document. These mentions behave as a single, immutable element containing the person's name or email address. # A paragraph element that links to a person or email address.
+                  "personId": "A String", # Output only. The unique ID of this link.
+                  "personProperties": { # Properties specific to a linked Person. # Output only. The properties of this Person. This field is always present.
+                    "email": "A String", # Output only. The email address linked to this Person. This field is always present.
+                    "name": "A String", # Output only. The name of the person if it is displayed in the link text instead of the person's email address.
+                  },
+                  "suggestedDeletionIds": [ # IDs for suggestions that remove this person link from the document. A Person might have multiple deletion IDs if, for example, multiple users suggest to delete it. If empty, then this person link isn't suggested for deletion.
+                    "A String",
+                  ],
+                  "suggestedInsertionIds": [ # IDs for suggestions that insert this person link into the document. A Person might have multiple insertion IDs if it is a nested suggested change (a suggestion within a suggestion made by a different user, for example). If empty, then this person link isn't a suggested insertion.
+                    "A String",
+                  ],
+                  "suggestedTextStyleChanges": { # The suggested text style changes to this Person, keyed by suggestion ID.
+                    "a_key": { # A suggested change to a TextStyle.
+                      "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # A TextStyle that only includes the changes made in this suggestion. This can be used along with the text_style_suggestion_state to see which fields have changed and their new values.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                        "bold": True or False, # Whether or not the text is rendered as bold.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                          "bookmarkId": "A String", # The ID of a bookmark in this document.
+                          "headingId": "A String", # The ID of a heading in this document.
+                          "url": "A String", # An external URL.
+                        },
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                          "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                          "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                        },
+                      },
+                      "textStyleSuggestionState": { # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. For any field set to true, there is a new suggested value. # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion.
+                        "backgroundColorSuggested": True or False, # Indicates if there was a suggested change to background_color.
+                        "baselineOffsetSuggested": True or False, # Indicates if there was a suggested change to baseline_offset.
+                        "boldSuggested": True or False, # Indicates if there was a suggested change to bold.
+                        "fontSizeSuggested": True or False, # Indicates if there was a suggested change to font_size.
+                        "foregroundColorSuggested": True or False, # Indicates if there was a suggested change to foreground_color.
+                        "italicSuggested": True or False, # Indicates if there was a suggested change to italic.
+                        "linkSuggested": True or False, # Indicates if there was a suggested change to link.
+                        "smallCapsSuggested": True or False, # Indicates if there was a suggested change to small_caps.
+                        "strikethroughSuggested": True or False, # Indicates if there was a suggested change to strikethrough.
+                        "underlineSuggested": True or False, # Indicates if there was a suggested change to underline.
+                        "weightedFontFamilySuggested": True or False, # Indicates if there was a suggested change to weighted_font_family.
+                      },
+                    },
+                  },
+                  "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # The text style of this Person.
+                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                    "bold": True or False, # Whether or not the text is rendered as bold.
+                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "italic": True or False, # Whether or not the text is italicized.
+                    "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                      "bookmarkId": "A String", # The ID of a bookmark in this document.
+                      "headingId": "A String", # The ID of a heading in this document.
+                      "url": "A String", # An external URL.
+                    },
+                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                    "strikethrough": True or False, # Whether or not the text is struck through.
+                    "underline": True or False, # Whether or not the text is underlined.
+                    "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                      "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                      "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                    },
+                  },
+                },
                 "startIndex": 42, # The zero-based start index of this paragraph element, in UTF-16 code units.
                 "textRun": { # A ParagraphElement that represents a run of text that all has the same styling. # A text run paragraph element.
                   "content": "A String", # The text of this run. Any non-text elements in the run are replaced with the Unicode character U+E907.
@@ -13565,6 +14321,114 @@
                     },
                   },
                 },
+                "person": { # A person or email address mentioned in a document. These mentions behave as a single, immutable element containing the person's name or email address. # A paragraph element that links to a person or email address.
+                  "personId": "A String", # Output only. The unique ID of this link.
+                  "personProperties": { # Properties specific to a linked Person. # Output only. The properties of this Person. This field is always present.
+                    "email": "A String", # Output only. The email address linked to this Person. This field is always present.
+                    "name": "A String", # Output only. The name of the person if it is displayed in the link text instead of the person's email address.
+                  },
+                  "suggestedDeletionIds": [ # IDs for suggestions that remove this person link from the document. A Person might have multiple deletion IDs if, for example, multiple users suggest to delete it. If empty, then this person link isn't suggested for deletion.
+                    "A String",
+                  ],
+                  "suggestedInsertionIds": [ # IDs for suggestions that insert this person link into the document. A Person might have multiple insertion IDs if it is a nested suggested change (a suggestion within a suggestion made by a different user, for example). If empty, then this person link isn't a suggested insertion.
+                    "A String",
+                  ],
+                  "suggestedTextStyleChanges": { # The suggested text style changes to this Person, keyed by suggestion ID.
+                    "a_key": { # A suggested change to a TextStyle.
+                      "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # A TextStyle that only includes the changes made in this suggestion. This can be used along with the text_style_suggestion_state to see which fields have changed and their new values.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                        "bold": True or False, # Whether or not the text is rendered as bold.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                          "bookmarkId": "A String", # The ID of a bookmark in this document.
+                          "headingId": "A String", # The ID of a heading in this document.
+                          "url": "A String", # An external URL.
+                        },
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                          "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                          "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                        },
+                      },
+                      "textStyleSuggestionState": { # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. For any field set to true, there is a new suggested value. # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion.
+                        "backgroundColorSuggested": True or False, # Indicates if there was a suggested change to background_color.
+                        "baselineOffsetSuggested": True or False, # Indicates if there was a suggested change to baseline_offset.
+                        "boldSuggested": True or False, # Indicates if there was a suggested change to bold.
+                        "fontSizeSuggested": True or False, # Indicates if there was a suggested change to font_size.
+                        "foregroundColorSuggested": True or False, # Indicates if there was a suggested change to foreground_color.
+                        "italicSuggested": True or False, # Indicates if there was a suggested change to italic.
+                        "linkSuggested": True or False, # Indicates if there was a suggested change to link.
+                        "smallCapsSuggested": True or False, # Indicates if there was a suggested change to small_caps.
+                        "strikethroughSuggested": True or False, # Indicates if there was a suggested change to strikethrough.
+                        "underlineSuggested": True or False, # Indicates if there was a suggested change to underline.
+                        "weightedFontFamilySuggested": True or False, # Indicates if there was a suggested change to weighted_font_family.
+                      },
+                    },
+                  },
+                  "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # The text style of this Person.
+                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                    "bold": True or False, # Whether or not the text is rendered as bold.
+                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "italic": True or False, # Whether or not the text is italicized.
+                    "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                      "bookmarkId": "A String", # The ID of a bookmark in this document.
+                      "headingId": "A String", # The ID of a heading in this document.
+                      "url": "A String", # An external URL.
+                    },
+                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                    "strikethrough": True or False, # Whether or not the text is struck through.
+                    "underline": True or False, # Whether or not the text is underlined.
+                    "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                      "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                      "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                    },
+                  },
+                },
                 "startIndex": 42, # The zero-based start index of this paragraph element, in UTF-16 code units.
                 "textRun": { # A ParagraphElement that represents a run of text that all has the same styling. # A text run paragraph element.
                   "content": "A String", # The text of this run. Any non-text elements in the run are replaced with the Unicode character U+E907.
@@ -16259,6 +17123,114 @@
                   },
                 },
               },
+              "person": { # A person or email address mentioned in a document. These mentions behave as a single, immutable element containing the person's name or email address. # A paragraph element that links to a person or email address.
+                "personId": "A String", # Output only. The unique ID of this link.
+                "personProperties": { # Properties specific to a linked Person. # Output only. The properties of this Person. This field is always present.
+                  "email": "A String", # Output only. The email address linked to this Person. This field is always present.
+                  "name": "A String", # Output only. The name of the person if it is displayed in the link text instead of the person's email address.
+                },
+                "suggestedDeletionIds": [ # IDs for suggestions that remove this person link from the document. A Person might have multiple deletion IDs if, for example, multiple users suggest to delete it. If empty, then this person link isn't suggested for deletion.
+                  "A String",
+                ],
+                "suggestedInsertionIds": [ # IDs for suggestions that insert this person link into the document. A Person might have multiple insertion IDs if it is a nested suggested change (a suggestion within a suggestion made by a different user, for example). If empty, then this person link isn't a suggested insertion.
+                  "A String",
+                ],
+                "suggestedTextStyleChanges": { # The suggested text style changes to this Person, keyed by suggestion ID.
+                  "a_key": { # A suggested change to a TextStyle.
+                    "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # A TextStyle that only includes the changes made in this suggestion. This can be used along with the text_style_suggestion_state to see which fields have changed and their new values.
+                      "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                        "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                          "rgbColor": { # An RGB color. # The RGB color value.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                      },
+                      "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                      "bold": True or False, # Whether or not the text is rendered as bold.
+                      "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                        "magnitude": 3.14, # The magnitude.
+                        "unit": "A String", # The units for magnitude.
+                      },
+                      "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                        "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                          "rgbColor": { # An RGB color. # The RGB color value.
+                            "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                            "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                            "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                          },
+                        },
+                      },
+                      "italic": True or False, # Whether or not the text is italicized.
+                      "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                        "bookmarkId": "A String", # The ID of a bookmark in this document.
+                        "headingId": "A String", # The ID of a heading in this document.
+                        "url": "A String", # An external URL.
+                      },
+                      "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                      "strikethrough": True or False, # Whether or not the text is struck through.
+                      "underline": True or False, # Whether or not the text is underlined.
+                      "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                        "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                        "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                      },
+                    },
+                    "textStyleSuggestionState": { # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. For any field set to true, there is a new suggested value. # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion.
+                      "backgroundColorSuggested": True or False, # Indicates if there was a suggested change to background_color.
+                      "baselineOffsetSuggested": True or False, # Indicates if there was a suggested change to baseline_offset.
+                      "boldSuggested": True or False, # Indicates if there was a suggested change to bold.
+                      "fontSizeSuggested": True or False, # Indicates if there was a suggested change to font_size.
+                      "foregroundColorSuggested": True or False, # Indicates if there was a suggested change to foreground_color.
+                      "italicSuggested": True or False, # Indicates if there was a suggested change to italic.
+                      "linkSuggested": True or False, # Indicates if there was a suggested change to link.
+                      "smallCapsSuggested": True or False, # Indicates if there was a suggested change to small_caps.
+                      "strikethroughSuggested": True or False, # Indicates if there was a suggested change to strikethrough.
+                      "underlineSuggested": True or False, # Indicates if there was a suggested change to underline.
+                      "weightedFontFamilySuggested": True or False, # Indicates if there was a suggested change to weighted_font_family.
+                    },
+                  },
+                },
+                "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # The text style of this Person.
+                  "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                    "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                      "rgbColor": { # An RGB color. # The RGB color value.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                  },
+                  "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                  "bold": True or False, # Whether or not the text is rendered as bold.
+                  "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                    "magnitude": 3.14, # The magnitude.
+                    "unit": "A String", # The units for magnitude.
+                  },
+                  "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                    "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                      "rgbColor": { # An RGB color. # The RGB color value.
+                        "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                        "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                        "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                      },
+                    },
+                  },
+                  "italic": True or False, # Whether or not the text is italicized.
+                  "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                    "bookmarkId": "A String", # The ID of a bookmark in this document.
+                    "headingId": "A String", # The ID of a heading in this document.
+                    "url": "A String", # An external URL.
+                  },
+                  "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                  "strikethrough": True or False, # Whether or not the text is struck through.
+                  "underline": True or False, # Whether or not the text is underlined.
+                  "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                    "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                    "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                  },
+                },
+              },
               "startIndex": 42, # The zero-based start index of this paragraph element, in UTF-16 code units.
               "textRun": { # A ParagraphElement that represents a run of text that all has the same styling. # A text run paragraph element.
                 "content": "A String", # The text of this run. Any non-text elements in the run are replaced with the Unicode character U+E907.
@@ -17856,6 +18828,114 @@
                     },
                   },
                 },
+                "person": { # A person or email address mentioned in a document. These mentions behave as a single, immutable element containing the person's name or email address. # A paragraph element that links to a person or email address.
+                  "personId": "A String", # Output only. The unique ID of this link.
+                  "personProperties": { # Properties specific to a linked Person. # Output only. The properties of this Person. This field is always present.
+                    "email": "A String", # Output only. The email address linked to this Person. This field is always present.
+                    "name": "A String", # Output only. The name of the person if it is displayed in the link text instead of the person's email address.
+                  },
+                  "suggestedDeletionIds": [ # IDs for suggestions that remove this person link from the document. A Person might have multiple deletion IDs if, for example, multiple users suggest to delete it. If empty, then this person link isn't suggested for deletion.
+                    "A String",
+                  ],
+                  "suggestedInsertionIds": [ # IDs for suggestions that insert this person link into the document. A Person might have multiple insertion IDs if it is a nested suggested change (a suggestion within a suggestion made by a different user, for example). If empty, then this person link isn't a suggested insertion.
+                    "A String",
+                  ],
+                  "suggestedTextStyleChanges": { # The suggested text style changes to this Person, keyed by suggestion ID.
+                    "a_key": { # A suggested change to a TextStyle.
+                      "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # A TextStyle that only includes the changes made in this suggestion. This can be used along with the text_style_suggestion_state to see which fields have changed and their new values.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                        "bold": True or False, # Whether or not the text is rendered as bold.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                          "bookmarkId": "A String", # The ID of a bookmark in this document.
+                          "headingId": "A String", # The ID of a heading in this document.
+                          "url": "A String", # An external URL.
+                        },
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                          "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                          "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                        },
+                      },
+                      "textStyleSuggestionState": { # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. For any field set to true, there is a new suggested value. # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion.
+                        "backgroundColorSuggested": True or False, # Indicates if there was a suggested change to background_color.
+                        "baselineOffsetSuggested": True or False, # Indicates if there was a suggested change to baseline_offset.
+                        "boldSuggested": True or False, # Indicates if there was a suggested change to bold.
+                        "fontSizeSuggested": True or False, # Indicates if there was a suggested change to font_size.
+                        "foregroundColorSuggested": True or False, # Indicates if there was a suggested change to foreground_color.
+                        "italicSuggested": True or False, # Indicates if there was a suggested change to italic.
+                        "linkSuggested": True or False, # Indicates if there was a suggested change to link.
+                        "smallCapsSuggested": True or False, # Indicates if there was a suggested change to small_caps.
+                        "strikethroughSuggested": True or False, # Indicates if there was a suggested change to strikethrough.
+                        "underlineSuggested": True or False, # Indicates if there was a suggested change to underline.
+                        "weightedFontFamilySuggested": True or False, # Indicates if there was a suggested change to weighted_font_family.
+                      },
+                    },
+                  },
+                  "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # The text style of this Person.
+                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                    "bold": True or False, # Whether or not the text is rendered as bold.
+                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "italic": True or False, # Whether or not the text is italicized.
+                    "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                      "bookmarkId": "A String", # The ID of a bookmark in this document.
+                      "headingId": "A String", # The ID of a heading in this document.
+                      "url": "A String", # An external URL.
+                    },
+                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                    "strikethrough": True or False, # Whether or not the text is struck through.
+                    "underline": True or False, # Whether or not the text is underlined.
+                    "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                      "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                      "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                    },
+                  },
+                },
                 "startIndex": 42, # The zero-based start index of this paragraph element, in UTF-16 code units.
                 "textRun": { # A ParagraphElement that represents a run of text that all has the same styling. # A text run paragraph element.
                   "content": "A String", # The text of this run. Any non-text elements in the run are replaced with the Unicode character U+E907.
@@ -19397,6 +20477,114 @@
                     },
                   },
                 },
+                "person": { # A person or email address mentioned in a document. These mentions behave as a single, immutable element containing the person's name or email address. # A paragraph element that links to a person or email address.
+                  "personId": "A String", # Output only. The unique ID of this link.
+                  "personProperties": { # Properties specific to a linked Person. # Output only. The properties of this Person. This field is always present.
+                    "email": "A String", # Output only. The email address linked to this Person. This field is always present.
+                    "name": "A String", # Output only. The name of the person if it is displayed in the link text instead of the person's email address.
+                  },
+                  "suggestedDeletionIds": [ # IDs for suggestions that remove this person link from the document. A Person might have multiple deletion IDs if, for example, multiple users suggest to delete it. If empty, then this person link isn't suggested for deletion.
+                    "A String",
+                  ],
+                  "suggestedInsertionIds": [ # IDs for suggestions that insert this person link into the document. A Person might have multiple insertion IDs if it is a nested suggested change (a suggestion within a suggestion made by a different user, for example). If empty, then this person link isn't a suggested insertion.
+                    "A String",
+                  ],
+                  "suggestedTextStyleChanges": { # The suggested text style changes to this Person, keyed by suggestion ID.
+                    "a_key": { # A suggested change to a TextStyle.
+                      "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # A TextStyle that only includes the changes made in this suggestion. This can be used along with the text_style_suggestion_state to see which fields have changed and their new values.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                        "bold": True or False, # Whether or not the text is rendered as bold.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                          "bookmarkId": "A String", # The ID of a bookmark in this document.
+                          "headingId": "A String", # The ID of a heading in this document.
+                          "url": "A String", # An external URL.
+                        },
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                          "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                          "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                        },
+                      },
+                      "textStyleSuggestionState": { # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. For any field set to true, there is a new suggested value. # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion.
+                        "backgroundColorSuggested": True or False, # Indicates if there was a suggested change to background_color.
+                        "baselineOffsetSuggested": True or False, # Indicates if there was a suggested change to baseline_offset.
+                        "boldSuggested": True or False, # Indicates if there was a suggested change to bold.
+                        "fontSizeSuggested": True or False, # Indicates if there was a suggested change to font_size.
+                        "foregroundColorSuggested": True or False, # Indicates if there was a suggested change to foreground_color.
+                        "italicSuggested": True or False, # Indicates if there was a suggested change to italic.
+                        "linkSuggested": True or False, # Indicates if there was a suggested change to link.
+                        "smallCapsSuggested": True or False, # Indicates if there was a suggested change to small_caps.
+                        "strikethroughSuggested": True or False, # Indicates if there was a suggested change to strikethrough.
+                        "underlineSuggested": True or False, # Indicates if there was a suggested change to underline.
+                        "weightedFontFamilySuggested": True or False, # Indicates if there was a suggested change to weighted_font_family.
+                      },
+                    },
+                  },
+                  "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # The text style of this Person.
+                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                    "bold": True or False, # Whether or not the text is rendered as bold.
+                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "italic": True or False, # Whether or not the text is italicized.
+                    "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                      "bookmarkId": "A String", # The ID of a bookmark in this document.
+                      "headingId": "A String", # The ID of a heading in this document.
+                      "url": "A String", # An external URL.
+                    },
+                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                    "strikethrough": True or False, # Whether or not the text is struck through.
+                    "underline": True or False, # Whether or not the text is underlined.
+                    "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                      "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                      "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                    },
+                  },
+                },
                 "startIndex": 42, # The zero-based start index of this paragraph element, in UTF-16 code units.
                 "textRun": { # A ParagraphElement that represents a run of text that all has the same styling. # A text run paragraph element.
                   "content": "A String", # The text of this run. Any non-text elements in the run are replaced with the Unicode character U+E907.
@@ -20938,6 +22126,114 @@
                     },
                   },
                 },
+                "person": { # A person or email address mentioned in a document. These mentions behave as a single, immutable element containing the person's name or email address. # A paragraph element that links to a person or email address.
+                  "personId": "A String", # Output only. The unique ID of this link.
+                  "personProperties": { # Properties specific to a linked Person. # Output only. The properties of this Person. This field is always present.
+                    "email": "A String", # Output only. The email address linked to this Person. This field is always present.
+                    "name": "A String", # Output only. The name of the person if it is displayed in the link text instead of the person's email address.
+                  },
+                  "suggestedDeletionIds": [ # IDs for suggestions that remove this person link from the document. A Person might have multiple deletion IDs if, for example, multiple users suggest to delete it. If empty, then this person link isn't suggested for deletion.
+                    "A String",
+                  ],
+                  "suggestedInsertionIds": [ # IDs for suggestions that insert this person link into the document. A Person might have multiple insertion IDs if it is a nested suggested change (a suggestion within a suggestion made by a different user, for example). If empty, then this person link isn't a suggested insertion.
+                    "A String",
+                  ],
+                  "suggestedTextStyleChanges": { # The suggested text style changes to this Person, keyed by suggestion ID.
+                    "a_key": { # A suggested change to a TextStyle.
+                      "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # A TextStyle that only includes the changes made in this suggestion. This can be used along with the text_style_suggestion_state to see which fields have changed and their new values.
+                        "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                        "bold": True or False, # Whether or not the text is rendered as bold.
+                        "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                          "magnitude": 3.14, # The magnitude.
+                          "unit": "A String", # The units for magnitude.
+                        },
+                        "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                          "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                            "rgbColor": { # An RGB color. # The RGB color value.
+                              "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                              "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                              "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                            },
+                          },
+                        },
+                        "italic": True or False, # Whether or not the text is italicized.
+                        "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                          "bookmarkId": "A String", # The ID of a bookmark in this document.
+                          "headingId": "A String", # The ID of a heading in this document.
+                          "url": "A String", # An external URL.
+                        },
+                        "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                        "strikethrough": True or False, # Whether or not the text is struck through.
+                        "underline": True or False, # Whether or not the text is underlined.
+                        "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                          "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                          "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                        },
+                      },
+                      "textStyleSuggestionState": { # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. For any field set to true, there is a new suggested value. # A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion.
+                        "backgroundColorSuggested": True or False, # Indicates if there was a suggested change to background_color.
+                        "baselineOffsetSuggested": True or False, # Indicates if there was a suggested change to baseline_offset.
+                        "boldSuggested": True or False, # Indicates if there was a suggested change to bold.
+                        "fontSizeSuggested": True or False, # Indicates if there was a suggested change to font_size.
+                        "foregroundColorSuggested": True or False, # Indicates if there was a suggested change to foreground_color.
+                        "italicSuggested": True or False, # Indicates if there was a suggested change to italic.
+                        "linkSuggested": True or False, # Indicates if there was a suggested change to link.
+                        "smallCapsSuggested": True or False, # Indicates if there was a suggested change to small_caps.
+                        "strikethroughSuggested": True or False, # Indicates if there was a suggested change to strikethrough.
+                        "underlineSuggested": True or False, # Indicates if there was a suggested change to underline.
+                        "weightedFontFamilySuggested": True or False, # Indicates if there was a suggested change to weighted_font_family.
+                      },
+                    },
+                  },
+                  "textStyle": { # Represents the styling that can be applied to text. Inherited text styles are represented as unset fields in this message. A text style's parent depends on where the text style is defined: * The TextStyle of text in a Paragraph inherits from the paragraph's corresponding named style type. * The TextStyle on a named style inherits from the normal text named style. * The TextStyle of the normal text named style inherits from the default text style in the Docs editor. * The TextStyle on a Paragraph element that is contained in a table may inherit its text style from the table style. If the text style does not inherit from a parent, unsetting fields will revert the style to a value matching the defaults in the Docs editor. # The text style of this Person.
+                    "backgroundColor": { # A color that can either be fully opaque or fully transparent. # The background color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "baselineOffset": "A String", # The text's vertical offset from its normal position. Text with `SUPERSCRIPT` or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font size, computed based on the `font_size` field. The `font_size` itself is not affected by changes in this field.
+                    "bold": True or False, # Whether or not the text is rendered as bold.
+                    "fontSize": { # A magnitude in a single direction in the specified units. # The size of the text's font.
+                      "magnitude": 3.14, # The magnitude.
+                      "unit": "A String", # The units for magnitude.
+                    },
+                    "foregroundColor": { # A color that can either be fully opaque or fully transparent. # The foreground color of the text. If set, the color is either an RGB color or transparent, depending on the `color` field.
+                      "color": { # A solid color. # If set, this will be used as an opaque color. If unset, this represents a transparent color.
+                        "rgbColor": { # An RGB color. # The RGB color value.
+                          "blue": 3.14, # The blue component of the color, from 0.0 to 1.0.
+                          "green": 3.14, # The green component of the color, from 0.0 to 1.0.
+                          "red": 3.14, # The red component of the color, from 0.0 to 1.0.
+                        },
+                      },
+                    },
+                    "italic": True or False, # Whether or not the text is italicized.
+                    "link": { # A reference to another portion of a document or an external URL resource. # The hyperlink destination of the text. If unset, there is no link. Links are not inherited from parent text. Changing the link in an update request causes some other changes to the text style of the range: * When setting a link, the text foreground color will be updated to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used instead of the link defaults. * Setting a link on a text range that overlaps with an existing link will also update the existing link to point to the new URL. * Links are not settable on newline characters. As a result, setting a link on a text range that crosses a paragraph boundary, such as `"ABC\n123"`, will separate the newline character(s) into their own text runs. The link will be applied separately to the runs before and after the newline. * Removing a link will update the text style of the range to match the style of the preceding text (or the default text styles if the preceding text is another link) unless different styles are being set in the same request.
+                      "bookmarkId": "A String", # The ID of a bookmark in this document.
+                      "headingId": "A String", # The ID of a heading in this document.
+                      "url": "A String", # An external URL.
+                    },
+                    "smallCaps": True or False, # Whether or not the text is in small capital letters.
+                    "strikethrough": True or False, # Whether or not the text is struck through.
+                    "underline": True or False, # Whether or not the text is underlined.
+                    "weightedFontFamily": { # Represents a font family and weight of text. # The font family and rendered weight of the text. If an update request specifies values for both `weighted_font_family` and `bold`, the `weighted_font_family` is applied first, then `bold`. If `weighted_font_family#weight` is not set, it defaults to `400`. If `weighted_font_family` is set, then `weighted_font_family#font_family` must also be set with a non-empty value. Otherwise, a 400 bad request error is returned.
+                      "fontFamily": "A String", # The font family of the text. The font family can be any font from the Font menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font name is unrecognized, the text is rendered in `Arial`.
+                      "weight": 42, # The weight of the font. This field can have any value that is a multiple of `100` between `100` and `900`, inclusive. This range corresponds to the numerical values described in the CSS 2.1 Specification, [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values disallowed. The default value is `400` ("normal"). The font weight makes up just one component of the rendered font weight. The rendered weight is determined by a combination of the `weight` and the text style's resolved `bold` value, after accounting for inheritance: * If the text is bold and the weight is less than `400`, the rendered weight is 400. * If the text is bold and the weight is greater than or equal to `400` but is less than `700`, the rendered weight is `700`. * If the weight is greater than or equal to `700`, the rendered weight is equal to the weight. * If the text is not bold, the rendered weight is equal to the weight.
+                    },
+                  },
+                },
                 "startIndex": 42, # The zero-based start index of this paragraph element, in UTF-16 code units.
                 "textRun": { # A ParagraphElement that represents a run of text that all has the same styling. # A text run paragraph element.
                   "content": "A String", # The text of this run. Any non-text elements in the run are replaced with the Unicode character U+E907.