chore: Update discovery artifacts (#1438)
## Deleted keys were detected in the following stable discovery artifacts:
youtube v3 https://github.com/googleapis/google-api-python-client/commit/ec21dff96d9538ad6c7f9b318eca88178533aa95
## Deleted keys were detected in the following pre-stable discovery artifacts:
firebasehosting v1beta1 https://github.com/googleapis/google-api-python-client/commit/c83ac386b65f82e7ba29851d56b496b09a29cf98
## Discovery Artifact Change Summary:
feat(analyticsadmin): update the api https://github.com/googleapis/google-api-python-client/commit/96675a8d9158ec13353fe241f858201fc51b784d
feat(composer): update the api https://github.com/googleapis/google-api-python-client/commit/add2fbdc3afb6696537eb087bc1d79df9194a37a
feat(container): update the api https://github.com/googleapis/google-api-python-client/commit/f8fae98db6d1943411b1a6c0f5a65dea336569f6
feat(content): update the api https://github.com/googleapis/google-api-python-client/commit/0814e009a4a11800db5b4afd7b6260e504c98047
feat(datacatalog): update the api https://github.com/googleapis/google-api-python-client/commit/99706059e58bb3d616253a1af2cd162b5a0b0279
feat(dataflow): update the api https://github.com/googleapis/google-api-python-client/commit/d5f09ef30392532bcfdd82901148bdd3ac6eec01
feat(docs): update the api https://github.com/googleapis/google-api-python-client/commit/dc66f4cafba86baff6149b2f6e59ae1888006911
feat(file): update the api https://github.com/googleapis/google-api-python-client/commit/523fc5c900f53489d56400deb650f6586c9681a0
feat(firebasehosting): update the api https://github.com/googleapis/google-api-python-client/commit/c83ac386b65f82e7ba29851d56b496b09a29cf98
feat(healthcare): update the api https://github.com/googleapis/google-api-python-client/commit/a407471b14349b8c08018196041568f2a35f8d4f
feat(ideahub): update the api https://github.com/googleapis/google-api-python-client/commit/c6b0d83940f238b1330896240492e8db397dcd15
fix(keep): update the api https://github.com/googleapis/google-api-python-client/commit/08fee732e96d3220e624c8fca7b8a9b0c0bcb146
feat(managedidentities): update the api https://github.com/googleapis/google-api-python-client/commit/863b333da7848029fd1614fd48b46cfbe12afcd5
feat(memcache): update the api https://github.com/googleapis/google-api-python-client/commit/17dc001e4649f54944066ce153e3c552c850a146
feat(metastore): update the api https://github.com/googleapis/google-api-python-client/commit/f3a76c9359babc48cc0b76ce7e3be0711ba028ae
feat(slides): update the api https://github.com/googleapis/google-api-python-client/commit/314d61b9ef8c5c30f9756462504dc0df92284cb2
feat(sqladmin): update the api https://github.com/googleapis/google-api-python-client/commit/62784e0b1b5752b480afe1ddd77dcf412bb35dbb
feat(tpu): update the api https://github.com/googleapis/google-api-python-client/commit/16bf712cca4a393d96e4135de3d02e5005051b6d
feat(youtube): update the api https://github.com/googleapis/google-api-python-client/commit/ec21dff96d9538ad6c7f9b318eca88178533aa95
diff --git a/docs/dyn/docs_v1.documents.html b/docs/dyn/docs_v1.documents.html
index ed0cbe8..edd04dd 100644
--- a/docs/dyn/docs_v1.documents.html
+++ b/docs/dyn/docs_v1.documents.html
@@ -1634,6 +1634,115 @@
},
},
},
+ "richLink": { # A link to a Google resource (e.g., a file in Drive, a YouTube video, a Calendar event, etc.). # A paragraph element that links to a Google resource (such as a file in Drive, a Youtube video, a Calendar event, etc.)
+ "richLinkId": "A String", # Output only. The ID of this link.
+ "richLinkProperties": { # Properties specific to a RichLink. # Output only. The properties of this RichLink. This field is always present.
+ "mimeType": "A String", # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the RichLink, if there is one (i.e., when it is a file in Drive).
+ "title": "A String", # Output only. The title of the RichLink as displayed in the link. This title matches the title of the linked resource at the time of the insertion or last update of the link. This field is always present.
+ "uri": "A String", # Output only. The URI to the RichLink. This is always present.
+ },
+ "suggestedDeletionIds": [ # IDs for suggestions that remove this link from the document. A RichLink 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 link into the document. A RichLink 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 RichLink, 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 RichLink.
+ "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.
@@ -3339,6 +3448,115 @@
},
},
},
+ "richLink": { # A link to a Google resource (e.g., a file in Drive, a YouTube video, a Calendar event, etc.). # A paragraph element that links to a Google resource (such as a file in Drive, a Youtube video, a Calendar event, etc.)
+ "richLinkId": "A String", # Output only. The ID of this link.
+ "richLinkProperties": { # Properties specific to a RichLink. # Output only. The properties of this RichLink. This field is always present.
+ "mimeType": "A String", # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the RichLink, if there is one (i.e., when it is a file in Drive).
+ "title": "A String", # Output only. The title of the RichLink as displayed in the link. This title matches the title of the linked resource at the time of the insertion or last update of the link. This field is always present.
+ "uri": "A String", # Output only. The URI to the RichLink. This is always present.
+ },
+ "suggestedDeletionIds": [ # IDs for suggestions that remove this link from the document. A RichLink 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 link into the document. A RichLink 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 RichLink, 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 RichLink.
+ "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.
@@ -4988,6 +5206,115 @@
},
},
},
+ "richLink": { # A link to a Google resource (e.g., a file in Drive, a YouTube video, a Calendar event, etc.). # A paragraph element that links to a Google resource (such as a file in Drive, a Youtube video, a Calendar event, etc.)
+ "richLinkId": "A String", # Output only. The ID of this link.
+ "richLinkProperties": { # Properties specific to a RichLink. # Output only. The properties of this RichLink. This field is always present.
+ "mimeType": "A String", # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the RichLink, if there is one (i.e., when it is a file in Drive).
+ "title": "A String", # Output only. The title of the RichLink as displayed in the link. This title matches the title of the linked resource at the time of the insertion or last update of the link. This field is always present.
+ "uri": "A String", # Output only. The URI to the RichLink. This is always present.
+ },
+ "suggestedDeletionIds": [ # IDs for suggestions that remove this link from the document. A RichLink 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 link into the document. A RichLink 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 RichLink, 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 RichLink.
+ "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.
@@ -6637,6 +6964,115 @@
},
},
},
+ "richLink": { # A link to a Google resource (e.g., a file in Drive, a YouTube video, a Calendar event, etc.). # A paragraph element that links to a Google resource (such as a file in Drive, a Youtube video, a Calendar event, etc.)
+ "richLinkId": "A String", # Output only. The ID of this link.
+ "richLinkProperties": { # Properties specific to a RichLink. # Output only. The properties of this RichLink. This field is always present.
+ "mimeType": "A String", # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the RichLink, if there is one (i.e., when it is a file in Drive).
+ "title": "A String", # Output only. The title of the RichLink as displayed in the link. This title matches the title of the linked resource at the time of the insertion or last update of the link. This field is always present.
+ "uri": "A String", # Output only. The URI to the RichLink. This is always present.
+ },
+ "suggestedDeletionIds": [ # IDs for suggestions that remove this link from the document. A RichLink 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 link into the document. A RichLink 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 RichLink, 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 RichLink.
+ "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.
@@ -9426,6 +9862,115 @@
},
},
},
+ "richLink": { # A link to a Google resource (e.g., a file in Drive, a YouTube video, a Calendar event, etc.). # A paragraph element that links to a Google resource (such as a file in Drive, a Youtube video, a Calendar event, etc.)
+ "richLinkId": "A String", # Output only. The ID of this link.
+ "richLinkProperties": { # Properties specific to a RichLink. # Output only. The properties of this RichLink. This field is always present.
+ "mimeType": "A String", # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the RichLink, if there is one (i.e., when it is a file in Drive).
+ "title": "A String", # Output only. The title of the RichLink as displayed in the link. This title matches the title of the linked resource at the time of the insertion or last update of the link. This field is always present.
+ "uri": "A String", # Output only. The URI to the RichLink. This is always present.
+ },
+ "suggestedDeletionIds": [ # IDs for suggestions that remove this link from the document. A RichLink 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 link into the document. A RichLink 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 RichLink, 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 RichLink.
+ "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.
@@ -11131,6 +11676,115 @@
},
},
},
+ "richLink": { # A link to a Google resource (e.g., a file in Drive, a YouTube video, a Calendar event, etc.). # A paragraph element that links to a Google resource (such as a file in Drive, a Youtube video, a Calendar event, etc.)
+ "richLinkId": "A String", # Output only. The ID of this link.
+ "richLinkProperties": { # Properties specific to a RichLink. # Output only. The properties of this RichLink. This field is always present.
+ "mimeType": "A String", # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the RichLink, if there is one (i.e., when it is a file in Drive).
+ "title": "A String", # Output only. The title of the RichLink as displayed in the link. This title matches the title of the linked resource at the time of the insertion or last update of the link. This field is always present.
+ "uri": "A String", # Output only. The URI to the RichLink. This is always present.
+ },
+ "suggestedDeletionIds": [ # IDs for suggestions that remove this link from the document. A RichLink 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 link into the document. A RichLink 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 RichLink, 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 RichLink.
+ "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.
@@ -12780,6 +13434,115 @@
},
},
},
+ "richLink": { # A link to a Google resource (e.g., a file in Drive, a YouTube video, a Calendar event, etc.). # A paragraph element that links to a Google resource (such as a file in Drive, a Youtube video, a Calendar event, etc.)
+ "richLinkId": "A String", # Output only. The ID of this link.
+ "richLinkProperties": { # Properties specific to a RichLink. # Output only. The properties of this RichLink. This field is always present.
+ "mimeType": "A String", # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the RichLink, if there is one (i.e., when it is a file in Drive).
+ "title": "A String", # Output only. The title of the RichLink as displayed in the link. This title matches the title of the linked resource at the time of the insertion or last update of the link. This field is always present.
+ "uri": "A String", # Output only. The URI to the RichLink. This is always present.
+ },
+ "suggestedDeletionIds": [ # IDs for suggestions that remove this link from the document. A RichLink 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 link into the document. A RichLink 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 RichLink, 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 RichLink.
+ "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.
@@ -14429,6 +15192,115 @@
},
},
},
+ "richLink": { # A link to a Google resource (e.g., a file in Drive, a YouTube video, a Calendar event, etc.). # A paragraph element that links to a Google resource (such as a file in Drive, a Youtube video, a Calendar event, etc.)
+ "richLinkId": "A String", # Output only. The ID of this link.
+ "richLinkProperties": { # Properties specific to a RichLink. # Output only. The properties of this RichLink. This field is always present.
+ "mimeType": "A String", # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the RichLink, if there is one (i.e., when it is a file in Drive).
+ "title": "A String", # Output only. The title of the RichLink as displayed in the link. This title matches the title of the linked resource at the time of the insertion or last update of the link. This field is always present.
+ "uri": "A String", # Output only. The URI to the RichLink. This is always present.
+ },
+ "suggestedDeletionIds": [ # IDs for suggestions that remove this link from the document. A RichLink 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 link into the document. A RichLink 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 RichLink, 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 RichLink.
+ "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.
@@ -17231,6 +18103,115 @@
},
},
},
+ "richLink": { # A link to a Google resource (e.g., a file in Drive, a YouTube video, a Calendar event, etc.). # A paragraph element that links to a Google resource (such as a file in Drive, a Youtube video, a Calendar event, etc.)
+ "richLinkId": "A String", # Output only. The ID of this link.
+ "richLinkProperties": { # Properties specific to a RichLink. # Output only. The properties of this RichLink. This field is always present.
+ "mimeType": "A String", # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the RichLink, if there is one (i.e., when it is a file in Drive).
+ "title": "A String", # Output only. The title of the RichLink as displayed in the link. This title matches the title of the linked resource at the time of the insertion or last update of the link. This field is always present.
+ "uri": "A String", # Output only. The URI to the RichLink. This is always present.
+ },
+ "suggestedDeletionIds": [ # IDs for suggestions that remove this link from the document. A RichLink 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 link into the document. A RichLink 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 RichLink, 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 RichLink.
+ "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.
@@ -18936,6 +19917,115 @@
},
},
},
+ "richLink": { # A link to a Google resource (e.g., a file in Drive, a YouTube video, a Calendar event, etc.). # A paragraph element that links to a Google resource (such as a file in Drive, a Youtube video, a Calendar event, etc.)
+ "richLinkId": "A String", # Output only. The ID of this link.
+ "richLinkProperties": { # Properties specific to a RichLink. # Output only. The properties of this RichLink. This field is always present.
+ "mimeType": "A String", # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the RichLink, if there is one (i.e., when it is a file in Drive).
+ "title": "A String", # Output only. The title of the RichLink as displayed in the link. This title matches the title of the linked resource at the time of the insertion or last update of the link. This field is always present.
+ "uri": "A String", # Output only. The URI to the RichLink. This is always present.
+ },
+ "suggestedDeletionIds": [ # IDs for suggestions that remove this link from the document. A RichLink 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 link into the document. A RichLink 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 RichLink, 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 RichLink.
+ "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.
@@ -20585,6 +21675,115 @@
},
},
},
+ "richLink": { # A link to a Google resource (e.g., a file in Drive, a YouTube video, a Calendar event, etc.). # A paragraph element that links to a Google resource (such as a file in Drive, a Youtube video, a Calendar event, etc.)
+ "richLinkId": "A String", # Output only. The ID of this link.
+ "richLinkProperties": { # Properties specific to a RichLink. # Output only. The properties of this RichLink. This field is always present.
+ "mimeType": "A String", # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the RichLink, if there is one (i.e., when it is a file in Drive).
+ "title": "A String", # Output only. The title of the RichLink as displayed in the link. This title matches the title of the linked resource at the time of the insertion or last update of the link. This field is always present.
+ "uri": "A String", # Output only. The URI to the RichLink. This is always present.
+ },
+ "suggestedDeletionIds": [ # IDs for suggestions that remove this link from the document. A RichLink 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 link into the document. A RichLink 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 RichLink, 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 RichLink.
+ "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.
@@ -22234,6 +23433,115 @@
},
},
},
+ "richLink": { # A link to a Google resource (e.g., a file in Drive, a YouTube video, a Calendar event, etc.). # A paragraph element that links to a Google resource (such as a file in Drive, a Youtube video, a Calendar event, etc.)
+ "richLinkId": "A String", # Output only. The ID of this link.
+ "richLinkProperties": { # Properties specific to a RichLink. # Output only. The properties of this RichLink. This field is always present.
+ "mimeType": "A String", # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the RichLink, if there is one (i.e., when it is a file in Drive).
+ "title": "A String", # Output only. The title of the RichLink as displayed in the link. This title matches the title of the linked resource at the time of the insertion or last update of the link. This field is always present.
+ "uri": "A String", # Output only. The URI to the RichLink. This is always present.
+ },
+ "suggestedDeletionIds": [ # IDs for suggestions that remove this link from the document. A RichLink 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 link into the document. A RichLink 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 RichLink, 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 RichLink.
+ "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.