google-apis-docs_v1 0.48.0 → 0.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -23,8 +23,7 @@ module Google
23
23
  module DocsV1
24
24
 
25
25
  # Accepts a suggestion. Returns a 403 forbidden error if the requesting user
26
- # does not have edit access to the document. [Developer Preview](https://
27
- # developers.google.com/workspace/preview).
26
+ # does not have edit access to the document.
28
27
  class AcceptSuggestionRequest
29
28
  include Google::Apis::Core::Hashable
30
29
 
@@ -43,8 +42,7 @@ module Google
43
42
  end
44
43
  end
45
44
 
46
- # Inserts a reply Post into a CommentThread or SuggestionThread. [Developer
47
- # Preview](https://developers.google.com/workspace/preview).
45
+ # Inserts a reply Post into a CommentThread or SuggestionThread.
48
46
  class AddCommentReplyRequest
49
47
  include Google::Apis::Core::Hashable
50
48
 
@@ -53,8 +51,7 @@ module Google
53
51
  # @return [String]
54
52
  attr_accessor :comment_id
55
53
 
56
- # Represents a single post in a comment or suggestion thread. [Developer Preview]
57
- # (https://developers.google.com/workspace/preview).
54
+ # Represents a single post in a comment or suggestion thread.
58
55
  # Corresponds to the JSON property `post`
59
56
  # @return [Google::Apis::DocsV1::Post]
60
57
  attr_accessor :post
@@ -76,13 +73,11 @@ module Google
76
73
  end
77
74
  end
78
75
 
79
- # Response message for adding a reply. [Developer Preview](https://developers.
80
- # google.com/workspace/preview).
76
+ # Response message for adding a reply.
81
77
  class AddCommentReplyResponse
82
78
  include Google::Apis::Core::Hashable
83
79
 
84
- # Represents a single post in a comment or suggestion thread. [Developer Preview]
85
- # (https://developers.google.com/workspace/preview).
80
+ # Represents a single post in a comment or suggestion thread.
86
81
  # Corresponds to the JSON property `post`
87
82
  # @return [Google::Apis::DocsV1::Post]
88
83
  attr_accessor :post
@@ -262,8 +257,7 @@ module Google
262
257
  class BatchUpdateDocumentResponse
263
258
  include Google::Apis::Core::Hashable
264
259
 
265
- # Whether comment updates were applied in the batch request. [Developer Preview](
266
- # https://developers.google.com/workspace/preview).
260
+ # Whether comment updates were applied in the batch request.
267
261
  # Corresponds to the JSON property `commentUpdateState`
268
262
  # @return [String]
269
263
  attr_accessor :comment_update_state
@@ -280,7 +274,7 @@ module Google
280
274
  attr_accessor :replies
281
275
 
282
276
  # The suggestions which were affected by each update. This maps 1:1 with the
283
- # updates. [Developer Preview](https://developers.google.com/workspace/preview).
277
+ # updates.
284
278
  # Corresponds to the JSON property `suggestionResponses`
285
279
  # @return [Array<Google::Apis::DocsV1::SuggestionResponse>]
286
280
  attr_accessor :suggestion_responses
@@ -495,8 +489,7 @@ module Google
495
489
  end
496
490
 
497
491
  # One or more locations in the document that are tied to CommentThreads with the
498
- # same anchorId. Note: Multiple anchors may refer to the same location. [
499
- # Developer Preview](https://developers.google.com/workspace/preview).
492
+ # same anchorId. Note: Multiple anchors may refer to the same location.
500
493
  class CommentAnchor
501
494
  include Google::Apis::Core::Hashable
502
495
 
@@ -521,8 +514,7 @@ module Google
521
514
  end
522
515
  end
523
516
 
524
- # Represents a single comment thread. [Developer Preview](https://developers.
525
- # google.com/workspace/preview).
517
+ # Represents a single comment thread.
526
518
  class CommentThread
527
519
  include Google::Apis::Core::Hashable
528
520
 
@@ -537,8 +529,7 @@ module Google
537
529
  # @return [String]
538
530
  attr_accessor :comment_id
539
531
 
540
- # Represents a single post in a comment or suggestion thread. [Developer Preview]
541
- # (https://developers.google.com/workspace/preview).
532
+ # Represents a single post in a comment or suggestion thread.
542
533
  # Corresponds to the JSON property `headPost`
543
534
  # @return [Google::Apis::DocsV1::Post]
544
535
  attr_accessor :head_post
@@ -574,6 +565,55 @@ module Google
574
565
  end
575
566
  end
576
567
 
568
+ # Creates a new DropdownDefinition in the document.
569
+ class CreateDropdownDefinitionRequest
570
+ include Google::Apis::Core::Hashable
571
+
572
+ # A dropdown definition in the document.
573
+ # Corresponds to the JSON property `dropdownDefinition`
574
+ # @return [Google::Apis::DocsV1::DropdownDefinition]
575
+ attr_accessor :dropdown_definition
576
+
577
+ # The ID of the tab to create the dropdown definition in. When omitted, the
578
+ # request is applied to the first tab. In a document containing a single tab: -
579
+ # If provided, must match the singular tab's ID. - If omitted, the request
580
+ # applies to the singular tab. In a document containing multiple tabs: - If
581
+ # provided, the request applies to the specified tab. - If omitted, the request
582
+ # applies to the first tab in the document.
583
+ # Corresponds to the JSON property `tabId`
584
+ # @return [String]
585
+ attr_accessor :tab_id
586
+
587
+ def initialize(**args)
588
+ update!(**args)
589
+ end
590
+
591
+ # Update properties of this object
592
+ def update!(**args)
593
+ @dropdown_definition = args[:dropdown_definition] if args.key?(:dropdown_definition)
594
+ @tab_id = args[:tab_id] if args.key?(:tab_id)
595
+ end
596
+ end
597
+
598
+ # Response message for creating a dropdown definition.
599
+ class CreateDropdownDefinitionResponse
600
+ include Google::Apis::Core::Hashable
601
+
602
+ # A dropdown definition in the document.
603
+ # Corresponds to the JSON property `dropdownDefinition`
604
+ # @return [Google::Apis::DocsV1::DropdownDefinition]
605
+ attr_accessor :dropdown_definition
606
+
607
+ def initialize(**args)
608
+ update!(**args)
609
+ end
610
+
611
+ # Update properties of this object
612
+ def update!(**args)
613
+ @dropdown_definition = args[:dropdown_definition] if args.key?(:dropdown_definition)
614
+ end
615
+ end
616
+
577
617
  # Creates a Footer. The new footer is applied to the SectionStyle at the
578
618
  # location of the SectionBreak if specified, otherwise it is applied to the
579
619
  # DocumentStyle. If a footer of the specified type already exists, a 400 bad
@@ -1092,8 +1132,7 @@ module Google
1092
1132
 
1093
1133
  # Deletes a reply Post from a CommentThread or SuggestionThread. Returns a 400
1094
1134
  # bad request error if: - The requesting user is not the author of the post. -
1095
- # The reply post contains an action. - The reply post contains an assignee. [
1096
- # Developer Preview](https://developers.google.com/workspace/preview).
1135
+ # The reply post contains an action. - The reply post contains an assignee.
1097
1136
  class DeleteCommentReplyRequest
1098
1137
  include Google::Apis::Core::Hashable
1099
1138
 
@@ -1125,8 +1164,7 @@ module Google
1125
1164
  end
1126
1165
 
1127
1166
  # Deletes a CommentThread. Returns a 400 bad request error if the requesting
1128
- # user is not the author of the headPost. [Developer Preview](https://developers.
1129
- # google.com/workspace/preview).
1167
+ # user is not the author of the headPost.
1130
1168
  class DeleteCommentRequest
1131
1169
  include Google::Apis::Core::Hashable
1132
1170
 
@@ -1164,6 +1202,38 @@ module Google
1164
1202
  end
1165
1203
  end
1166
1204
 
1205
+ # Deletes a DropdownDefinition. If the dropdown definition is referenced by any
1206
+ # dropdown instances (chips) in the document, a 400 bad request error is
1207
+ # returned.
1208
+ class DeleteDropdownDefinitionRequest
1209
+ include Google::Apis::Core::Hashable
1210
+
1211
+ # The ID of the DropdownDefinition to delete.
1212
+ # Corresponds to the JSON property `dropdownDefinitionId`
1213
+ # @return [String]
1214
+ attr_accessor :dropdown_definition_id
1215
+
1216
+ # The ID of the tab that contains the dropdown definition to delete. When
1217
+ # omitted, the request is applied to the first tab. In a document containing a
1218
+ # single tab: - If provided, must match the singular tab's ID. - If omitted, the
1219
+ # request applies to the singular tab. In a document containing multiple tabs: -
1220
+ # If provided, the request applies to the specified tab. - If omitted, the
1221
+ # request applies to the first tab in the document.
1222
+ # Corresponds to the JSON property `tabId`
1223
+ # @return [String]
1224
+ attr_accessor :tab_id
1225
+
1226
+ def initialize(**args)
1227
+ update!(**args)
1228
+ end
1229
+
1230
+ # Update properties of this object
1231
+ def update!(**args)
1232
+ @dropdown_definition_id = args[:dropdown_definition_id] if args.key?(:dropdown_definition_id)
1233
+ @tab_id = args[:tab_id] if args.key?(:tab_id)
1234
+ end
1235
+ end
1236
+
1167
1237
  # Deletes a Footer from the document.
1168
1238
  class DeleteFooterRequest
1169
1239
  include Google::Apis::Core::Hashable
@@ -1316,8 +1386,7 @@ module Google
1316
1386
  end
1317
1387
 
1318
1388
  # Deletes a suggestion. Returns a 403 forbidden error if the requesting user is
1319
- # not the author of the suggestion. [Developer Preview](https://developers.
1320
- # google.com/workspace/preview).
1389
+ # not the author of the suggestion.
1321
1390
  class DeleteSuggestionRequest
1322
1391
  include Google::Apis::Core::Hashable
1323
1392
 
@@ -1430,14 +1499,12 @@ module Google
1430
1499
 
1431
1500
  # Output only. The comments associated with the document. Only populated if the
1432
1501
  # commentsViewMode parameter is set to require comments (such as `
1433
- # COMMENTS_VIEW_MODE_INCLUDED`). [Developer Preview](https://developers.google.
1434
- # com/workspace/preview).
1502
+ # COMMENTS_VIEW_MODE_INCLUDED`).
1435
1503
  # Corresponds to the JSON property `comments`
1436
1504
  # @return [Array<Google::Apis::DocsV1::CommentThread>]
1437
1505
  attr_accessor :comments
1438
1506
 
1439
- # Output only. The comments view mode applied to the document. [Developer
1440
- # Preview](https://developers.google.com/workspace/preview).
1507
+ # Output only. The comments view mode applied to the document.
1441
1508
  # Corresponds to the JSON property `commentsViewMode`
1442
1509
  # @return [String]
1443
1510
  attr_accessor :comments_view_mode
@@ -1556,8 +1623,7 @@ module Google
1556
1623
 
1557
1624
  # Output only. The suggestions associated with the document. Only populated if
1558
1625
  # the commentsViewMode parameter is set to require comments (such as `
1559
- # COMMENTS_VIEW_MODE_INCLUDED`). [Developer Preview](https://developers.google.
1560
- # com/workspace/preview).
1626
+ # COMMENTS_VIEW_MODE_INCLUDED`).
1561
1627
  # Corresponds to the JSON property `suggestions`
1562
1628
  # @return [Array<Google::Apis::DocsV1::SuggestionThread>]
1563
1629
  attr_accessor :suggestions
@@ -1959,8 +2025,7 @@ module Google
1959
2025
 
1960
2026
  # The comment anchors in a document tab, keyed by anchor ID. Only populated if
1961
2027
  # the commentsViewMode parameter is set to require comments (such as `
1962
- # COMMENTS_VIEW_MODE_INCLUDED`). [Developer Preview](https://developers.google.
1963
- # com/workspace/preview).
2028
+ # COMMENTS_VIEW_MODE_INCLUDED`).
1964
2029
  # Corresponds to the JSON property `commentAnchors`
1965
2030
  # @return [Hash<String,Google::Apis::DocsV1::CommentAnchor>]
1966
2031
  attr_accessor :comment_anchors
@@ -1970,6 +2035,11 @@ module Google
1970
2035
  # @return [Google::Apis::DocsV1::DocumentStyle]
1971
2036
  attr_accessor :document_style
1972
2037
 
2038
+ # The dropdown definitions in a document tab, keyed by dropdown definition ID.
2039
+ # Corresponds to the JSON property `dropdownDefinitions`
2040
+ # @return [Hash<String,Google::Apis::DocsV1::DropdownDefinition>]
2041
+ attr_accessor :dropdown_definitions
2042
+
1973
2043
  # The footers in the document tab, keyed by footer ID.
1974
2044
  # Corresponds to the JSON property `footers`
1975
2045
  # @return [Hash<String,Google::Apis::DocsV1::Footer>]
@@ -2031,6 +2101,7 @@ module Google
2031
2101
  @body = args[:body] if args.key?(:body)
2032
2102
  @comment_anchors = args[:comment_anchors] if args.key?(:comment_anchors)
2033
2103
  @document_style = args[:document_style] if args.key?(:document_style)
2104
+ @dropdown_definitions = args[:dropdown_definitions] if args.key?(:dropdown_definitions)
2034
2105
  @footers = args[:footers] if args.key?(:footers)
2035
2106
  @footnotes = args[:footnotes] if args.key?(:footnotes)
2036
2107
  @headers = args[:headers] if args.key?(:headers)
@@ -2044,6 +2115,273 @@ module Google
2044
2115
  end
2045
2116
  end
2046
2117
 
2118
+ # A dropdown in the document. The chip is displayed as a dropdown menu that
2119
+ # allows users to select an option from a configurable list of options.
2120
+ class Dropdown
2121
+ include Google::Apis::Core::Hashable
2122
+
2123
+ # The ID of this dropdown.
2124
+ # Corresponds to the JSON property `dropdownId`
2125
+ # @return [String]
2126
+ attr_accessor :dropdown_id
2127
+
2128
+ # Properties specific to a dropdown.
2129
+ # Corresponds to the JSON property `dropdownProperties`
2130
+ # @return [Google::Apis::DocsV1::DropdownProperties]
2131
+ attr_accessor :dropdown_properties
2132
+
2133
+ # IDs for suggestions that remove this dropdown from the document. If empty,
2134
+ # then this dropdown isn't suggested for deletion.
2135
+ # Corresponds to the JSON property `suggestedDeletionIds`
2136
+ # @return [Array<String>]
2137
+ attr_accessor :suggested_deletion_ids
2138
+
2139
+ # The suggested properties changes to this dropdown, keyed by suggestion ID.
2140
+ # Corresponds to the JSON property `suggestedDropdownPropertiesChanges`
2141
+ # @return [Hash<String,Google::Apis::DocsV1::SuggestedDropdownProperties>]
2142
+ attr_accessor :suggested_dropdown_properties_changes
2143
+
2144
+ # IDs for suggestions that insert this dropdown into the document. If empty,
2145
+ # then this dropdown isn't a suggested insertion.
2146
+ # Corresponds to the JSON property `suggestedInsertionIds`
2147
+ # @return [Array<String>]
2148
+ attr_accessor :suggested_insertion_ids
2149
+
2150
+ # The suggested text style changes to this dropdown, keyed by suggestion ID.
2151
+ # Corresponds to the JSON property `suggestedTextStyleChanges`
2152
+ # @return [Hash<String,Google::Apis::DocsV1::SuggestedTextStyle>]
2153
+ attr_accessor :suggested_text_style_changes
2154
+
2155
+ # Represents the styling that can be applied to text. Inherited text styles are
2156
+ # represented as unset fields in this message. A text style's parent depends on
2157
+ # where the text style is defined: * The TextStyle of text in a Paragraph
2158
+ # inherits from the paragraph's corresponding named style type. * The TextStyle
2159
+ # on a named style inherits from the normal text named style. * The TextStyle of
2160
+ # the normal text named style inherits from the default text style in the Docs
2161
+ # editor. * The TextStyle on a Paragraph element that's contained in a table may
2162
+ # inherit its text style from the table style. If the text style does not
2163
+ # inherit from a parent, unsetting fields will revert the style to a value
2164
+ # matching the defaults in the Docs editor.
2165
+ # Corresponds to the JSON property `textStyle`
2166
+ # @return [Google::Apis::DocsV1::TextStyle]
2167
+ attr_accessor :text_style
2168
+
2169
+ def initialize(**args)
2170
+ update!(**args)
2171
+ end
2172
+
2173
+ # Update properties of this object
2174
+ def update!(**args)
2175
+ @dropdown_id = args[:dropdown_id] if args.key?(:dropdown_id)
2176
+ @dropdown_properties = args[:dropdown_properties] if args.key?(:dropdown_properties)
2177
+ @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
2178
+ @suggested_dropdown_properties_changes = args[:suggested_dropdown_properties_changes] if args.key?(:suggested_dropdown_properties_changes)
2179
+ @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
2180
+ @suggested_text_style_changes = args[:suggested_text_style_changes] if args.key?(:suggested_text_style_changes)
2181
+ @text_style = args[:text_style] if args.key?(:text_style)
2182
+ end
2183
+ end
2184
+
2185
+ # A dropdown definition in the document.
2186
+ class DropdownDefinition
2187
+ include Google::Apis::Core::Hashable
2188
+
2189
+ # The ID of this dropdown definition. If you specify an ID, it must be unique
2190
+ # among all IDs in the tab. The ID must start with `kix.` and match regex `^kix\.
2191
+ # [a-zA-Z0-9_-]`2,14`$` (length 6-18 chars). If you don't specify an ID, a
2192
+ # unique one is generated.
2193
+ # Corresponds to the JSON property `dropdownDefinitionId`
2194
+ # @return [String]
2195
+ attr_accessor :dropdown_definition_id
2196
+
2197
+ # Properties of a dropdown definition.
2198
+ # Corresponds to the JSON property `dropdownDefinitionProperties`
2199
+ # @return [Google::Apis::DocsV1::DropdownDefinitionProperties]
2200
+ attr_accessor :dropdown_definition_properties
2201
+
2202
+ # ID for suggestion that deletes this dropdown definition.
2203
+ # Corresponds to the JSON property `suggestedDeletionId`
2204
+ # @return [String]
2205
+ attr_accessor :suggested_deletion_id
2206
+
2207
+ # Suggested property changes to this definition, keyed by suggestion ID.
2208
+ # Corresponds to the JSON property `suggestedDropdownDefinitionPropertiesChanges`
2209
+ # @return [Hash<String,Google::Apis::DocsV1::SuggestedDropdownDefinitionProperties>]
2210
+ attr_accessor :suggested_dropdown_definition_properties_changes
2211
+
2212
+ # ID for suggestion that inserts this dropdown definition.
2213
+ # Corresponds to the JSON property `suggestedInsertionId`
2214
+ # @return [String]
2215
+ attr_accessor :suggested_insertion_id
2216
+
2217
+ def initialize(**args)
2218
+ update!(**args)
2219
+ end
2220
+
2221
+ # Update properties of this object
2222
+ def update!(**args)
2223
+ @dropdown_definition_id = args[:dropdown_definition_id] if args.key?(:dropdown_definition_id)
2224
+ @dropdown_definition_properties = args[:dropdown_definition_properties] if args.key?(:dropdown_definition_properties)
2225
+ @suggested_deletion_id = args[:suggested_deletion_id] if args.key?(:suggested_deletion_id)
2226
+ @suggested_dropdown_definition_properties_changes = args[:suggested_dropdown_definition_properties_changes] if args.key?(:suggested_dropdown_definition_properties_changes)
2227
+ @suggested_insertion_id = args[:suggested_insertion_id] if args.key?(:suggested_insertion_id)
2228
+ end
2229
+ end
2230
+
2231
+ # Properties of a dropdown definition.
2232
+ class DropdownDefinitionProperties
2233
+ include Google::Apis::Core::Hashable
2234
+
2235
+ # The list of options defined by this dropdown definition. A dropdown definition
2236
+ # must have at least 2 options and at most 50 options.
2237
+ # Corresponds to the JSON property `options`
2238
+ # @return [Array<Google::Apis::DocsV1::DropdownOption>]
2239
+ attr_accessor :options
2240
+
2241
+ # The title of the dropdown definition.
2242
+ # Corresponds to the JSON property `title`
2243
+ # @return [String]
2244
+ attr_accessor :title
2245
+
2246
+ def initialize(**args)
2247
+ update!(**args)
2248
+ end
2249
+
2250
+ # Update properties of this object
2251
+ def update!(**args)
2252
+ @options = args[:options] if args.key?(:options)
2253
+ @title = args[:title] if args.key?(:title)
2254
+ end
2255
+ end
2256
+
2257
+ # A mask that indicates which of the fields on the base
2258
+ # DropdownDefinitionProperties have been changed in this suggestion. For any
2259
+ # field set to true, there's a new suggested value.
2260
+ class DropdownDefinitionPropertiesSuggestionState
2261
+ include Google::Apis::Core::Hashable
2262
+
2263
+ # Indicates if there was a suggested change to options.
2264
+ # Corresponds to the JSON property `optionsSuggested`
2265
+ # @return [Boolean]
2266
+ attr_accessor :options_suggested
2267
+ alias_method :options_suggested?, :options_suggested
2268
+
2269
+ # Indicates if there was a suggested change to title.
2270
+ # Corresponds to the JSON property `titleSuggested`
2271
+ # @return [Boolean]
2272
+ attr_accessor :title_suggested
2273
+ alias_method :title_suggested?, :title_suggested
2274
+
2275
+ def initialize(**args)
2276
+ update!(**args)
2277
+ end
2278
+
2279
+ # Update properties of this object
2280
+ def update!(**args)
2281
+ @options_suggested = args[:options_suggested] if args.key?(:options_suggested)
2282
+ @title_suggested = args[:title_suggested] if args.key?(:title_suggested)
2283
+ end
2284
+ end
2285
+
2286
+ # An option in a Dropdown.
2287
+ class DropdownOption
2288
+ include Google::Apis::Core::Hashable
2289
+
2290
+ # The display value of this dropdown option.
2291
+ # Corresponds to the JSON property `displayValue`
2292
+ # @return [String]
2293
+ attr_accessor :display_value
2294
+
2295
+ # The ID of this dropdown option. If you specify an ID, it must be unique among
2296
+ # all options in this dropdown definition. The ID must start with `dropdownItem.`
2297
+ # and match regex `^dropdownItem\.[a-zA-Z0-9_-]`2,14`$` (length 15-27 chars).
2298
+ # If you don't specify an ID, a unique one is generated.
2299
+ # Corresponds to the JSON property `optionId`
2300
+ # @return [String]
2301
+ attr_accessor :option_id
2302
+
2303
+ # Represents the styling that can be applied to text. Inherited text styles are
2304
+ # represented as unset fields in this message. A text style's parent depends on
2305
+ # where the text style is defined: * The TextStyle of text in a Paragraph
2306
+ # inherits from the paragraph's corresponding named style type. * The TextStyle
2307
+ # on a named style inherits from the normal text named style. * The TextStyle of
2308
+ # the normal text named style inherits from the default text style in the Docs
2309
+ # editor. * The TextStyle on a Paragraph element that's contained in a table may
2310
+ # inherit its text style from the table style. If the text style does not
2311
+ # inherit from a parent, unsetting fields will revert the style to a value
2312
+ # matching the defaults in the Docs editor.
2313
+ # Corresponds to the JSON property `textStyle`
2314
+ # @return [Google::Apis::DocsV1::TextStyle]
2315
+ attr_accessor :text_style
2316
+
2317
+ def initialize(**args)
2318
+ update!(**args)
2319
+ end
2320
+
2321
+ # Update properties of this object
2322
+ def update!(**args)
2323
+ @display_value = args[:display_value] if args.key?(:display_value)
2324
+ @option_id = args[:option_id] if args.key?(:option_id)
2325
+ @text_style = args[:text_style] if args.key?(:text_style)
2326
+ end
2327
+ end
2328
+
2329
+ # Properties specific to a dropdown.
2330
+ class DropdownProperties
2331
+ include Google::Apis::Core::Hashable
2332
+
2333
+ # The human-readable display text of the currently selected item. This field is
2334
+ # populated by the server based on the dropdown definition and the selected
2335
+ # option ID. It may differ from `DropdownOption.display_value` if the underlying
2336
+ # option definition was modified or deleted, or during pending suggested changes.
2337
+ # Corresponds to the JSON property `displayValue`
2338
+ # @return [String]
2339
+ attr_accessor :display_value
2340
+
2341
+ # The ID of the DropdownDefinition that defines the options for this dropdown.
2342
+ # Corresponds to the JSON property `dropdownDefinitionId`
2343
+ # @return [String]
2344
+ attr_accessor :dropdown_definition_id
2345
+
2346
+ # The ID of the selected option in this dropdown.
2347
+ # Corresponds to the JSON property `selectedOptionId`
2348
+ # @return [String]
2349
+ attr_accessor :selected_option_id
2350
+
2351
+ def initialize(**args)
2352
+ update!(**args)
2353
+ end
2354
+
2355
+ # Update properties of this object
2356
+ def update!(**args)
2357
+ @display_value = args[:display_value] if args.key?(:display_value)
2358
+ @dropdown_definition_id = args[:dropdown_definition_id] if args.key?(:dropdown_definition_id)
2359
+ @selected_option_id = args[:selected_option_id] if args.key?(:selected_option_id)
2360
+ end
2361
+ end
2362
+
2363
+ # A mask that indicates which of the fields on the base DropdownProperties have
2364
+ # been changed in this suggestion. For any field set to true, there's a new
2365
+ # suggested value.
2366
+ class DropdownPropertiesSuggestionState
2367
+ include Google::Apis::Core::Hashable
2368
+
2369
+ # Indicates if there was a suggested change to selected_option_id.
2370
+ # Corresponds to the JSON property `selectedOptionIdSuggested`
2371
+ # @return [Boolean]
2372
+ attr_accessor :selected_option_id_suggested
2373
+ alias_method :selected_option_id_suggested?, :selected_option_id_suggested
2374
+
2375
+ def initialize(**args)
2376
+ update!(**args)
2377
+ end
2378
+
2379
+ # Update properties of this object
2380
+ def update!(**args)
2381
+ @selected_option_id_suggested = args[:selected_option_id_suggested] if args.key?(:selected_option_id_suggested)
2382
+ end
2383
+ end
2384
+
2047
2385
  # The properties of an embedded drawing and used to differentiate the object
2048
2386
  # type. An embedded drawing is one that's created and edited within a document.
2049
2387
  # Note that extensive details are not supported.
@@ -2882,8 +3220,7 @@ module Google
2882
3220
  end
2883
3221
  end
2884
3222
 
2885
- # Inserts a CommentThread into the document. [Developer Preview](https://
2886
- # developers.google.com/workspace/preview).
3223
+ # Inserts a CommentThread into the document.
2887
3224
  class InsertCommentRequest
2888
3225
  include Google::Apis::Core::Hashable
2889
3226
 
@@ -2918,13 +3255,11 @@ module Google
2918
3255
  end
2919
3256
  end
2920
3257
 
2921
- # Response message for inserting a comment. [Developer Preview](https://
2922
- # developers.google.com/workspace/preview).
3258
+ # Response message for inserting a comment.
2923
3259
  class InsertCommentResponse
2924
3260
  include Google::Apis::Core::Hashable
2925
3261
 
2926
- # Represents a single comment thread. [Developer Preview](https://developers.
2927
- # google.com/workspace/preview).
3262
+ # Represents a single comment thread.
2928
3263
  # Corresponds to the JSON property `commentThread`
2929
3264
  # @return [Google::Apis::DocsV1::CommentThread]
2930
3265
  attr_accessor :comment_thread
@@ -2971,6 +3306,67 @@ module Google
2971
3306
  end
2972
3307
  end
2973
3308
 
3309
+ # Inserts a Dropdown at the specified location.
3310
+ class InsertDropdownRequest
3311
+ include Google::Apis::Core::Hashable
3312
+
3313
+ # Required. The DropdownDefinition ID.
3314
+ # Corresponds to the JSON property `dropdownDefinitionId`
3315
+ # @return [String]
3316
+ attr_accessor :dropdown_definition_id
3317
+
3318
+ # Location at the end of a body, header, footer or footnote. The location is
3319
+ # immediately before the last newline in the document segment.
3320
+ # Corresponds to the JSON property `endOfSegmentLocation`
3321
+ # @return [Google::Apis::DocsV1::EndOfSegmentLocation]
3322
+ attr_accessor :end_of_segment_location
3323
+
3324
+ # A particular location in the document.
3325
+ # Corresponds to the JSON property `location`
3326
+ # @return [Google::Apis::DocsV1::Location]
3327
+ attr_accessor :location
3328
+
3329
+ # Optional initial value for the dropdown. If this field is not specified, the
3330
+ # new dropdown will default to selecting the first option defined in the
3331
+ # dropdown definition. If this field is specified but does not reference a valid
3332
+ # option in the dropdown definition, a 400 bad request error is returned.
3333
+ # Corresponds to the JSON property `selectedOptionId`
3334
+ # @return [String]
3335
+ attr_accessor :selected_option_id
3336
+
3337
+ def initialize(**args)
3338
+ update!(**args)
3339
+ end
3340
+
3341
+ # Update properties of this object
3342
+ def update!(**args)
3343
+ @dropdown_definition_id = args[:dropdown_definition_id] if args.key?(:dropdown_definition_id)
3344
+ @end_of_segment_location = args[:end_of_segment_location] if args.key?(:end_of_segment_location)
3345
+ @location = args[:location] if args.key?(:location)
3346
+ @selected_option_id = args[:selected_option_id] if args.key?(:selected_option_id)
3347
+ end
3348
+ end
3349
+
3350
+ # The result of inserting a Dropdown.
3351
+ class InsertDropdownResponse
3352
+ include Google::Apis::Core::Hashable
3353
+
3354
+ # A dropdown in the document. The chip is displayed as a dropdown menu that
3355
+ # allows users to select an option from a configurable list of options.
3356
+ # Corresponds to the JSON property `dropdown`
3357
+ # @return [Google::Apis::DocsV1::Dropdown]
3358
+ attr_accessor :dropdown
3359
+
3360
+ def initialize(**args)
3361
+ update!(**args)
3362
+ end
3363
+
3364
+ # Update properties of this object
3365
+ def update!(**args)
3366
+ @dropdown = args[:dropdown] if args.key?(:dropdown)
3367
+ end
3368
+ end
3369
+
2974
3370
  # Inserts an InlineObject containing an image at the given location.
2975
3371
  class InsertInlineImageRequest
2976
3372
  include Google::Apis::Core::Hashable
@@ -4143,6 +4539,12 @@ module Google
4143
4539
  # @return [Google::Apis::DocsV1::DateElement]
4144
4540
  attr_accessor :date_element
4145
4541
 
4542
+ # A dropdown in the document. The chip is displayed as a dropdown menu that
4543
+ # allows users to select an option from a configurable list of options.
4544
+ # Corresponds to the JSON property `dropdown`
4545
+ # @return [Google::Apis::DocsV1::Dropdown]
4546
+ attr_accessor :dropdown
4547
+
4146
4548
  # The zero-base end index of this paragraph element, exclusive, in UTF-16 code
4147
4549
  # units.
4148
4550
  # Corresponds to the JSON property `endIndex`
@@ -4207,6 +4609,7 @@ module Google
4207
4609
  @auto_text = args[:auto_text] if args.key?(:auto_text)
4208
4610
  @column_break = args[:column_break] if args.key?(:column_break)
4209
4611
  @date_element = args[:date_element] if args.key?(:date_element)
4612
+ @dropdown = args[:dropdown] if args.key?(:dropdown)
4210
4613
  @end_index = args[:end_index] if args.key?(:end_index)
4211
4614
  @equation = args[:equation] if args.key?(:equation)
4212
4615
  @footnote_reference = args[:footnote_reference] if args.key?(:footnote_reference)
@@ -4843,8 +5246,7 @@ module Google
4843
5246
  end
4844
5247
  end
4845
5248
 
4846
- # Represents a single post in a comment or suggestion thread. [Developer Preview]
4847
- # (https://developers.google.com/workspace/preview).
5249
+ # Represents a single post in a comment or suggestion thread.
4848
5250
  class Post
4849
5251
  include Google::Apis::Core::Hashable
4850
5252
 
@@ -4857,8 +5259,7 @@ module Google
4857
5259
  # @return [String]
4858
5260
  attr_accessor :assignee_email
4859
5261
 
4860
- # Represents a user who authored a comment or suggestion post. [Developer
4861
- # Preview](https://developers.google.com/workspace/preview).
5262
+ # Represents a user who authored a comment or suggestion post.
4862
5263
  # Corresponds to the JSON property `author`
4863
5264
  # @return [Google::Apis::DocsV1::PostAuthor]
4864
5265
  attr_accessor :author
@@ -4951,8 +5352,7 @@ module Google
4951
5352
  end
4952
5353
  end
4953
5354
 
4954
- # Represents a user who authored a comment or suggestion post. [Developer
4955
- # Preview](https://developers.google.com/workspace/preview).
5355
+ # Represents a user who authored a comment or suggestion post.
4956
5356
  class PostAuthor
4957
5357
  include Google::Apis::Core::Hashable
4958
5358
 
@@ -5043,8 +5443,7 @@ module Google
5043
5443
 
5044
5444
  # Rejects a suggestion. Returns a 403 forbidden error if the requesting user
5045
5445
  # does not have edit access to the document and is not the author of the
5046
- # suggestion. [Developer Preview](https://developers.google.com/workspace/
5047
- # preview).
5446
+ # suggestion.
5048
5447
  class RejectSuggestionRequest
5049
5448
  include Google::Apis::Core::Hashable
5050
5449
 
@@ -5213,14 +5612,12 @@ module Google
5213
5612
  include Google::Apis::Core::Hashable
5214
5613
 
5215
5614
  # Accepts a suggestion. Returns a 403 forbidden error if the requesting user
5216
- # does not have edit access to the document. [Developer Preview](https://
5217
- # developers.google.com/workspace/preview).
5615
+ # does not have edit access to the document.
5218
5616
  # Corresponds to the JSON property `acceptSuggestion`
5219
5617
  # @return [Google::Apis::DocsV1::AcceptSuggestionRequest]
5220
5618
  attr_accessor :accept_suggestion
5221
5619
 
5222
- # Inserts a reply Post into a CommentThread or SuggestionThread. [Developer
5223
- # Preview](https://developers.google.com/workspace/preview).
5620
+ # Inserts a reply Post into a CommentThread or SuggestionThread.
5224
5621
  # Corresponds to the JSON property `addCommentReply`
5225
5622
  # @return [Google::Apis::DocsV1::AddCommentReplyRequest]
5226
5623
  attr_accessor :add_comment_reply
@@ -5231,6 +5628,11 @@ module Google
5231
5628
  # @return [Google::Apis::DocsV1::AddDocumentTabRequest]
5232
5629
  attr_accessor :add_document_tab
5233
5630
 
5631
+ # Creates a new DropdownDefinition in the document.
5632
+ # Corresponds to the JSON property `createDropdownDefinition`
5633
+ # @return [Google::Apis::DocsV1::CreateDropdownDefinitionRequest]
5634
+ attr_accessor :create_dropdown_definition
5635
+
5234
5636
  # Creates a Footer. The new footer is applied to the SectionStyle at the
5235
5637
  # location of the SectionBreak if specified, otherwise it is applied to the
5236
5638
  # DocumentStyle. If a footer of the specified type already exists, a 400 bad
@@ -5271,16 +5673,14 @@ module Google
5271
5673
  attr_accessor :create_paragraph_bullets
5272
5674
 
5273
5675
  # Deletes a CommentThread. Returns a 400 bad request error if the requesting
5274
- # user is not the author of the headPost. [Developer Preview](https://developers.
5275
- # google.com/workspace/preview).
5676
+ # user is not the author of the headPost.
5276
5677
  # Corresponds to the JSON property `deleteComment`
5277
5678
  # @return [Google::Apis::DocsV1::DeleteCommentRequest]
5278
5679
  attr_accessor :delete_comment
5279
5680
 
5280
5681
  # Deletes a reply Post from a CommentThread or SuggestionThread. Returns a 400
5281
5682
  # bad request error if: - The requesting user is not the author of the post. -
5282
- # The reply post contains an action. - The reply post contains an assignee. [
5283
- # Developer Preview](https://developers.google.com/workspace/preview).
5683
+ # The reply post contains an action. - The reply post contains an assignee.
5284
5684
  # Corresponds to the JSON property `deleteCommentReply`
5285
5685
  # @return [Google::Apis::DocsV1::DeleteCommentReplyRequest]
5286
5686
  attr_accessor :delete_comment_reply
@@ -5290,6 +5690,13 @@ module Google
5290
5690
  # @return [Google::Apis::DocsV1::DeleteContentRangeRequest]
5291
5691
  attr_accessor :delete_content_range
5292
5692
 
5693
+ # Deletes a DropdownDefinition. If the dropdown definition is referenced by any
5694
+ # dropdown instances (chips) in the document, a 400 bad request error is
5695
+ # returned.
5696
+ # Corresponds to the JSON property `deleteDropdownDefinition`
5697
+ # @return [Google::Apis::DocsV1::DeleteDropdownDefinitionRequest]
5698
+ attr_accessor :delete_dropdown_definition
5699
+
5293
5700
  # Deletes a Footer from the document.
5294
5701
  # Corresponds to the JSON property `deleteFooter`
5295
5702
  # @return [Google::Apis::DocsV1::DeleteFooterRequest]
@@ -5318,8 +5725,7 @@ module Google
5318
5725
  attr_accessor :delete_positioned_object
5319
5726
 
5320
5727
  # Deletes a suggestion. Returns a 403 forbidden error if the requesting user is
5321
- # not the author of the suggestion. [Developer Preview](https://developers.
5322
- # google.com/workspace/preview).
5728
+ # not the author of the suggestion.
5323
5729
  # Corresponds to the JSON property `deleteSuggestion`
5324
5730
  # @return [Google::Apis::DocsV1::DeleteSuggestionRequest]
5325
5731
  attr_accessor :delete_suggestion
@@ -5339,8 +5745,7 @@ module Google
5339
5745
  # @return [Google::Apis::DocsV1::DeleteTableRowRequest]
5340
5746
  attr_accessor :delete_table_row
5341
5747
 
5342
- # Inserts a CommentThread into the document. [Developer Preview](https://
5343
- # developers.google.com/workspace/preview).
5748
+ # Inserts a CommentThread into the document.
5344
5749
  # Corresponds to the JSON property `insertComment`
5345
5750
  # @return [Google::Apis::DocsV1::InsertCommentRequest]
5346
5751
  attr_accessor :insert_comment
@@ -5350,6 +5755,11 @@ module Google
5350
5755
  # @return [Google::Apis::DocsV1::InsertDateRequest]
5351
5756
  attr_accessor :insert_date
5352
5757
 
5758
+ # Inserts a Dropdown at the specified location.
5759
+ # Corresponds to the JSON property `insertDropdown`
5760
+ # @return [Google::Apis::DocsV1::InsertDropdownRequest]
5761
+ attr_accessor :insert_dropdown
5762
+
5353
5763
  # Inserts an InlineObject containing an image at the given location.
5354
5764
  # Corresponds to the JSON property `insertInlineImage`
5355
5765
  # @return [Google::Apis::DocsV1::InsertInlineImageRequest]
@@ -5409,8 +5819,7 @@ module Google
5409
5819
 
5410
5820
  # Rejects a suggestion. Returns a 403 forbidden error if the requesting user
5411
5821
  # does not have edit access to the document and is not the author of the
5412
- # suggestion. [Developer Preview](https://developers.google.com/workspace/
5413
- # preview).
5822
+ # suggestion.
5414
5823
  # Corresponds to the JSON property `rejectSuggestion`
5415
5824
  # @return [Google::Apis::DocsV1::RejectSuggestionRequest]
5416
5825
  attr_accessor :reject_suggestion
@@ -5444,8 +5853,7 @@ module Google
5444
5853
 
5445
5854
  # Updates a Post in a CommentThread or SuggestionThread. Returns a 400 bad
5446
5855
  # request error if: - The post is the headPost of a SuggestionThread. - The
5447
- # requesting user is not the author of the post. [Developer Preview](https://
5448
- # developers.google.com/workspace/preview).
5856
+ # requesting user is not the author of the post.
5449
5857
  # Corresponds to the JSON property `updateCommentPost`
5450
5858
  # @return [Google::Apis::DocsV1::UpdateCommentPostRequest]
5451
5859
  attr_accessor :update_comment_post
@@ -5460,6 +5868,16 @@ module Google
5460
5868
  # @return [Google::Apis::DocsV1::UpdateDocumentTabPropertiesRequest]
5461
5869
  attr_accessor :update_document_tab_properties
5462
5870
 
5871
+ # Updates the properties of a DropdownDefinition.
5872
+ # Corresponds to the JSON property `updateDropdownDefinitionProperties`
5873
+ # @return [Google::Apis::DocsV1::UpdateDropdownDefinitionPropertiesRequest]
5874
+ attr_accessor :update_dropdown_definition_properties
5875
+
5876
+ # Updates the properties of a Dropdown.
5877
+ # Corresponds to the JSON property `updateDropdownProperties`
5878
+ # @return [Google::Apis::DocsV1::UpdateDropdownPropertiesRequest]
5879
+ attr_accessor :update_dropdown_properties
5880
+
5463
5881
  # Updates a named style.
5464
5882
  # Corresponds to the JSON property `updateNamedStyle`
5465
5883
  # @return [Google::Apis::DocsV1::UpdateNamedStyleRequest]
@@ -5504,6 +5922,7 @@ module Google
5504
5922
  @accept_suggestion = args[:accept_suggestion] if args.key?(:accept_suggestion)
5505
5923
  @add_comment_reply = args[:add_comment_reply] if args.key?(:add_comment_reply)
5506
5924
  @add_document_tab = args[:add_document_tab] if args.key?(:add_document_tab)
5925
+ @create_dropdown_definition = args[:create_dropdown_definition] if args.key?(:create_dropdown_definition)
5507
5926
  @create_footer = args[:create_footer] if args.key?(:create_footer)
5508
5927
  @create_footnote = args[:create_footnote] if args.key?(:create_footnote)
5509
5928
  @create_header = args[:create_header] if args.key?(:create_header)
@@ -5512,6 +5931,7 @@ module Google
5512
5931
  @delete_comment = args[:delete_comment] if args.key?(:delete_comment)
5513
5932
  @delete_comment_reply = args[:delete_comment_reply] if args.key?(:delete_comment_reply)
5514
5933
  @delete_content_range = args[:delete_content_range] if args.key?(:delete_content_range)
5934
+ @delete_dropdown_definition = args[:delete_dropdown_definition] if args.key?(:delete_dropdown_definition)
5515
5935
  @delete_footer = args[:delete_footer] if args.key?(:delete_footer)
5516
5936
  @delete_header = args[:delete_header] if args.key?(:delete_header)
5517
5937
  @delete_named_range = args[:delete_named_range] if args.key?(:delete_named_range)
@@ -5523,6 +5943,7 @@ module Google
5523
5943
  @delete_table_row = args[:delete_table_row] if args.key?(:delete_table_row)
5524
5944
  @insert_comment = args[:insert_comment] if args.key?(:insert_comment)
5525
5945
  @insert_date = args[:insert_date] if args.key?(:insert_date)
5946
+ @insert_dropdown = args[:insert_dropdown] if args.key?(:insert_dropdown)
5526
5947
  @insert_inline_image = args[:insert_inline_image] if args.key?(:insert_inline_image)
5527
5948
  @insert_page_break = args[:insert_page_break] if args.key?(:insert_page_break)
5528
5949
  @insert_person = args[:insert_person] if args.key?(:insert_person)
@@ -5542,6 +5963,8 @@ module Google
5542
5963
  @update_comment_post = args[:update_comment_post] if args.key?(:update_comment_post)
5543
5964
  @update_document_style = args[:update_document_style] if args.key?(:update_document_style)
5544
5965
  @update_document_tab_properties = args[:update_document_tab_properties] if args.key?(:update_document_tab_properties)
5966
+ @update_dropdown_definition_properties = args[:update_dropdown_definition_properties] if args.key?(:update_dropdown_definition_properties)
5967
+ @update_dropdown_properties = args[:update_dropdown_properties] if args.key?(:update_dropdown_properties)
5545
5968
  @update_named_style = args[:update_named_style] if args.key?(:update_named_style)
5546
5969
  @update_paragraph_style = args[:update_paragraph_style] if args.key?(:update_paragraph_style)
5547
5970
  @update_section_style = args[:update_section_style] if args.key?(:update_section_style)
@@ -5556,8 +5979,7 @@ module Google
5556
5979
  class Response
5557
5980
  include Google::Apis::Core::Hashable
5558
5981
 
5559
- # Response message for adding a reply. [Developer Preview](https://developers.
5560
- # google.com/workspace/preview).
5982
+ # Response message for adding a reply.
5561
5983
  # Corresponds to the JSON property `addCommentReply`
5562
5984
  # @return [Google::Apis::DocsV1::AddCommentReplyResponse]
5563
5985
  attr_accessor :add_comment_reply
@@ -5567,6 +5989,11 @@ module Google
5567
5989
  # @return [Google::Apis::DocsV1::AddDocumentTabResponse]
5568
5990
  attr_accessor :add_document_tab
5569
5991
 
5992
+ # Response message for creating a dropdown definition.
5993
+ # Corresponds to the JSON property `createDropdownDefinition`
5994
+ # @return [Google::Apis::DocsV1::CreateDropdownDefinitionResponse]
5995
+ attr_accessor :create_dropdown_definition
5996
+
5570
5997
  # The result of creating a footer.
5571
5998
  # Corresponds to the JSON property `createFooter`
5572
5999
  # @return [Google::Apis::DocsV1::CreateFooterResponse]
@@ -5587,12 +6014,16 @@ module Google
5587
6014
  # @return [Google::Apis::DocsV1::CreateNamedRangeResponse]
5588
6015
  attr_accessor :create_named_range
5589
6016
 
5590
- # Response message for inserting a comment. [Developer Preview](https://
5591
- # developers.google.com/workspace/preview).
6017
+ # Response message for inserting a comment.
5592
6018
  # Corresponds to the JSON property `insertComment`
5593
6019
  # @return [Google::Apis::DocsV1::InsertCommentResponse]
5594
6020
  attr_accessor :insert_comment
5595
6021
 
6022
+ # The result of inserting a Dropdown.
6023
+ # Corresponds to the JSON property `insertDropdown`
6024
+ # @return [Google::Apis::DocsV1::InsertDropdownResponse]
6025
+ attr_accessor :insert_dropdown
6026
+
5596
6027
  # The result of inserting an inline image.
5597
6028
  # Corresponds to the JSON property `insertInlineImage`
5598
6029
  # @return [Google::Apis::DocsV1::InsertInlineImageResponse]
@@ -5616,11 +6047,13 @@ module Google
5616
6047
  def update!(**args)
5617
6048
  @add_comment_reply = args[:add_comment_reply] if args.key?(:add_comment_reply)
5618
6049
  @add_document_tab = args[:add_document_tab] if args.key?(:add_document_tab)
6050
+ @create_dropdown_definition = args[:create_dropdown_definition] if args.key?(:create_dropdown_definition)
5619
6051
  @create_footer = args[:create_footer] if args.key?(:create_footer)
5620
6052
  @create_footnote = args[:create_footnote] if args.key?(:create_footnote)
5621
6053
  @create_header = args[:create_header] if args.key?(:create_header)
5622
6054
  @create_named_range = args[:create_named_range] if args.key?(:create_named_range)
5623
6055
  @insert_comment = args[:insert_comment] if args.key?(:insert_comment)
6056
+ @insert_dropdown = args[:insert_dropdown] if args.key?(:insert_dropdown)
5624
6057
  @insert_inline_image = args[:insert_inline_image] if args.key?(:insert_inline_image)
5625
6058
  @insert_inline_sheets_chart = args[:insert_inline_sheets_chart] if args.key?(:insert_inline_sheets_chart)
5626
6059
  @replace_all_text = args[:replace_all_text] if args.key?(:replace_all_text)
@@ -6323,6 +6756,60 @@ module Google
6323
6756
  end
6324
6757
  end
6325
6758
 
6759
+ # A suggested change to dropdown definition properties.
6760
+ class SuggestedDropdownDefinitionProperties
6761
+ include Google::Apis::Core::Hashable
6762
+
6763
+ # Properties of a dropdown definition.
6764
+ # Corresponds to the JSON property `dropdownDefinitionProperties`
6765
+ # @return [Google::Apis::DocsV1::DropdownDefinitionProperties]
6766
+ attr_accessor :dropdown_definition_properties
6767
+
6768
+ # A mask that indicates which of the fields on the base
6769
+ # DropdownDefinitionProperties have been changed in this suggestion. For any
6770
+ # field set to true, there's a new suggested value.
6771
+ # Corresponds to the JSON property `dropdownDefinitionPropertiesSuggestionState`
6772
+ # @return [Google::Apis::DocsV1::DropdownDefinitionPropertiesSuggestionState]
6773
+ attr_accessor :dropdown_definition_properties_suggestion_state
6774
+
6775
+ def initialize(**args)
6776
+ update!(**args)
6777
+ end
6778
+
6779
+ # Update properties of this object
6780
+ def update!(**args)
6781
+ @dropdown_definition_properties = args[:dropdown_definition_properties] if args.key?(:dropdown_definition_properties)
6782
+ @dropdown_definition_properties_suggestion_state = args[:dropdown_definition_properties_suggestion_state] if args.key?(:dropdown_definition_properties_suggestion_state)
6783
+ end
6784
+ end
6785
+
6786
+ # A suggested change to dropdown properties.
6787
+ class SuggestedDropdownProperties
6788
+ include Google::Apis::Core::Hashable
6789
+
6790
+ # Properties specific to a dropdown.
6791
+ # Corresponds to the JSON property `dropdownProperties`
6792
+ # @return [Google::Apis::DocsV1::DropdownProperties]
6793
+ attr_accessor :dropdown_properties
6794
+
6795
+ # A mask that indicates which of the fields on the base DropdownProperties have
6796
+ # been changed in this suggestion. For any field set to true, there's a new
6797
+ # suggested value.
6798
+ # Corresponds to the JSON property `dropdownPropertiesSuggestionState`
6799
+ # @return [Google::Apis::DocsV1::DropdownPropertiesSuggestionState]
6800
+ attr_accessor :dropdown_properties_suggestion_state
6801
+
6802
+ def initialize(**args)
6803
+ update!(**args)
6804
+ end
6805
+
6806
+ # Update properties of this object
6807
+ def update!(**args)
6808
+ @dropdown_properties = args[:dropdown_properties] if args.key?(:dropdown_properties)
6809
+ @dropdown_properties_suggestion_state = args[:dropdown_properties_suggestion_state] if args.key?(:dropdown_properties_suggestion_state)
6810
+ end
6811
+ end
6812
+
6326
6813
  # A suggested change to InlineObjectProperties.
6327
6814
  class SuggestedInlineObjectProperties
6328
6815
  include Google::Apis::Core::Hashable
@@ -6559,8 +7046,7 @@ module Google
6559
7046
  end
6560
7047
  end
6561
7048
 
6562
- # The suggestions which were affected by a given update. [Developer Preview](
6563
- # https://developers.google.com/workspace/preview).
7049
+ # The suggestions which were affected by a given update.
6564
7050
  class SuggestionResponse
6565
7051
  include Google::Apis::Core::Hashable
6566
7052
 
@@ -6605,13 +7091,11 @@ module Google
6605
7091
 
6606
7092
  # Represents a single suggestion thread. Suggestion threads are created as a
6607
7093
  # byproduct of saving changes to the document while in suggestion mode, and
6608
- # cannot be created directly. [Developer Preview](https://developers.google.com/
6609
- # workspace/preview).
7094
+ # cannot be created directly.
6610
7095
  class SuggestionThread
6611
7096
  include Google::Apis::Core::Hashable
6612
7097
 
6613
- # Represents a single post in a comment or suggestion thread. [Developer Preview]
6614
- # (https://developers.google.com/workspace/preview).
7098
+ # Represents a single post in a comment or suggestion thread.
6615
7099
  # Corresponds to the JSON property `headPost`
6616
7100
  # @return [Google::Apis::DocsV1::Post]
6617
7101
  attr_accessor :head_post
@@ -7651,8 +8135,7 @@ module Google
7651
8135
 
7652
8136
  # Updates a Post in a CommentThread or SuggestionThread. Returns a 400 bad
7653
8137
  # request error if: - The post is the headPost of a SuggestionThread. - The
7654
- # requesting user is not the author of the post. [Developer Preview](https://
7655
- # developers.google.com/workspace/preview).
8138
+ # requesting user is not the author of the post.
7656
8139
  class UpdateCommentPostRequest
7657
8140
  include Google::Apis::Core::Hashable
7658
8141
 
@@ -7758,6 +8241,112 @@ module Google
7758
8241
  end
7759
8242
  end
7760
8243
 
8244
+ # Updates the properties of a DropdownDefinition.
8245
+ class UpdateDropdownDefinitionPropertiesRequest
8246
+ include Google::Apis::Core::Hashable
8247
+
8248
+ # The ID of the DropdownDefinition to update.
8249
+ # Corresponds to the JSON property `dropdownDefinitionId`
8250
+ # @return [String]
8251
+ attr_accessor :dropdown_definition_id
8252
+
8253
+ # Properties of a dropdown definition.
8254
+ # Corresponds to the JSON property `dropdownDefinitionProperties`
8255
+ # @return [Google::Apis::DocsV1::DropdownDefinitionProperties]
8256
+ attr_accessor :dropdown_definition_properties
8257
+
8258
+ # The fields that should be updated. At least one field must be specified. The
8259
+ # root `dropdown_definition_properties` is implied and should not be specified.
8260
+ # A single `"*"` can be used as short-hand for listing every field. When `
8261
+ # dropdown_definition_properties.options` is included in the field mask, the
8262
+ # full, complete list of desired options must be provided in `
8263
+ # dropdown_definition_properties.options`.
8264
+ # Corresponds to the JSON property `fields`
8265
+ # @return [String]
8266
+ attr_accessor :fields
8267
+
8268
+ # A map of option IDs to their replacements, used to automatically reassign
8269
+ # orphaned Dropdown chips when an option is deleted. The keys are the IDs of the
8270
+ # options being deleted, and the values are the IDs of their replacement options.
8271
+ # If an option being deleted is selected in one or more Dropdown chips in the
8272
+ # document, a replacement entry for that option must be provided in this map,
8273
+ # and the replacement option ID must exist in the updated DropdownDefinition. If
8274
+ # a replacement is required but not provided, a 400 bad request error is
8275
+ # returned. Options being deleted that are not selected in any Dropdown chips do
8276
+ # not require a replacement. For example, if option A is being replaced by
8277
+ # option B, the map should be ``"A": "B"``.
8278
+ # Corresponds to the JSON property `selectedOptionIdReplacements`
8279
+ # @return [Hash<String,String>]
8280
+ attr_accessor :selected_option_id_replacements
8281
+
8282
+ # The ID of the tab that contains the dropdown definition to update. When
8283
+ # omitted, the request is applied to the first tab. In a document containing a
8284
+ # single tab: - If provided, must match the singular tab's ID. - If omitted, the
8285
+ # request applies to the singular tab. In a document containing multiple tabs: -
8286
+ # If provided, the request applies to the specified tab. - If omitted, the
8287
+ # request applies to the first tab in the document.
8288
+ # Corresponds to the JSON property `tabId`
8289
+ # @return [String]
8290
+ attr_accessor :tab_id
8291
+
8292
+ def initialize(**args)
8293
+ update!(**args)
8294
+ end
8295
+
8296
+ # Update properties of this object
8297
+ def update!(**args)
8298
+ @dropdown_definition_id = args[:dropdown_definition_id] if args.key?(:dropdown_definition_id)
8299
+ @dropdown_definition_properties = args[:dropdown_definition_properties] if args.key?(:dropdown_definition_properties)
8300
+ @fields = args[:fields] if args.key?(:fields)
8301
+ @selected_option_id_replacements = args[:selected_option_id_replacements] if args.key?(:selected_option_id_replacements)
8302
+ @tab_id = args[:tab_id] if args.key?(:tab_id)
8303
+ end
8304
+ end
8305
+
8306
+ # Updates the properties of a Dropdown.
8307
+ class UpdateDropdownPropertiesRequest
8308
+ include Google::Apis::Core::Hashable
8309
+
8310
+ # Required. The Dropdown ID.
8311
+ # Corresponds to the JSON property `dropdownId`
8312
+ # @return [String]
8313
+ attr_accessor :dropdown_id
8314
+
8315
+ # Properties specific to a dropdown.
8316
+ # Corresponds to the JSON property `dropdownProperties`
8317
+ # @return [Google::Apis::DocsV1::DropdownProperties]
8318
+ attr_accessor :dropdown_properties
8319
+
8320
+ # The fields that should be updated. At least one field must be specified. The
8321
+ # root `dropdown_properties` is implied and should not be specified. A single `"*
8322
+ # "` can be used as short-hand for listing every field.
8323
+ # Corresponds to the JSON property `fields`
8324
+ # @return [String]
8325
+ attr_accessor :fields
8326
+
8327
+ # The ID of the tab that contains the dropdown to update. When omitted, the
8328
+ # request is applied to the first tab. In a document containing a single tab: -
8329
+ # If provided, must match the singular tab's ID. - If omitted, the request
8330
+ # applies to the singular tab. In a document containing multiple tabs: - If
8331
+ # provided, the request applies to the specified tab. - If omitted, the request
8332
+ # applies to the first tab in the document.
8333
+ # Corresponds to the JSON property `tabId`
8334
+ # @return [String]
8335
+ attr_accessor :tab_id
8336
+
8337
+ def initialize(**args)
8338
+ update!(**args)
8339
+ end
8340
+
8341
+ # Update properties of this object
8342
+ def update!(**args)
8343
+ @dropdown_id = args[:dropdown_id] if args.key?(:dropdown_id)
8344
+ @dropdown_properties = args[:dropdown_properties] if args.key?(:dropdown_properties)
8345
+ @fields = args[:fields] if args.key?(:fields)
8346
+ @tab_id = args[:tab_id] if args.key?(:tab_id)
8347
+ end
8348
+ end
8349
+
7761
8350
  # Updates a named style.
7762
8351
  class UpdateNamedStyleRequest
7763
8352
  include Google::Apis::Core::Hashable
@@ -8125,8 +8714,7 @@ module Google
8125
8714
  attr_accessor :target_revision_id
8126
8715
 
8127
8716
  # How the request updates should be applied to the document. If unspecified, the
8128
- # request updates will be applied as normal edits. [Developer Preview](https://
8129
- # developers.google.com/workspace/preview).
8717
+ # request updates will be applied as normal edits.
8130
8718
  # Corresponds to the JSON property `writeMode`
8131
8719
  # @return [String]
8132
8720
  attr_accessor :write_mode