google-apis-docs_v1 0.28.0 → 0.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9112afa252a6d614924717856b382beeacf68c8d5121f3de1ad0e6e08401402
-  data.tar.gz: 673be4169151c4f3e4bb56f9951a5b69c3b85804ae364a99e264efbb976d6ea9
+  metadata.gz: 01e0d46f6f83dd74aa299cd83a2000b35cc8c5ff31867fd404b92aa4535fe342
+  data.tar.gz: a18432ae3a1023ef90f729dd50ae5c4cc1ab855e0453a12961104947c6fdae94
 SHA512:
-  metadata.gz: 9026ffd2eb6f120dd20f52b3ff8436c61cf904020fba1cd14a66d814954eec9d7f79b43889882b4e08eabc9f1ac66457cda814ff7c932262b38c9473df68240d
-  data.tar.gz: de8b15af71ddcaf19e5e2e2b15bce777e85b92e6d580531535f6aa53282326241a19a9d508696c42c5850448e04e92d6d445c2208b26e7b78d32d396265ac337
+  metadata.gz: ef1f5dc6f7b6b445eb3c4b2ce7adbda2254cb38a933042c1206e4d6c741b8dadc20cc0286defd3bb9bc8dd12f63b08c97d104563bc52cf298bb0e07bd40c59c8
+  data.tar.gz: 5ec45dc0afda64f8124d38adcb17d80563ff75a27d2df42d3aac08bb0464f03288648e55b1cff6fd552bb035b02f20453543b72223cf3ff5fab0272fe86628d5

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-docs_v1
 
+### v0.30.0 (2024-08-11)
+
+* Regenerated from discovery document revision 20240730
+
+### v0.29.0 (2024-08-04)
+
+* Regenerated from discovery document revision 20240726
+* Regenerated using generator version 0.15.1
+
 ### v0.28.0 (2024-07-25)
 
 * Regenerated from discovery document revision 20240722

data/lib/google/apis/docs_v1/classes.rb

@@ -945,32 +945,56 @@ module Google
         # @return [Google::Apis::DocsV1::DocumentStyle]
         attr_accessor :document_style
       
-        # Output only. The footers in the document, keyed by footer ID.
+        # Output only. The footers in the document, keyed by footer ID. Legacy field:
+        # Instead, use Document.tabs.documentTab.footers, which exposes the actual
+        # document content from all tabs when the includeTabsContent parameter is set to
+        # `true`. If `false` or unset, this field contains information about the first
+        # tab in the document.
         # Corresponds to the JSON property `footers`
         # @return [Hash<String,Google::Apis::DocsV1::Footer>]
         attr_accessor :footers
       
-        # Output only. The footnotes in the document, keyed by footnote ID.
+        # Output only. The footnotes in the document, keyed by footnote ID. Legacy field:
+        # Instead, use Document.tabs.documentTab.footnotes, which exposes the actual
+        # document content from all tabs when the includeTabsContent parameter is set to
+        # `true`. If `false` or unset, this field contains information about the first
+        # tab in the document.
         # Corresponds to the JSON property `footnotes`
         # @return [Hash<String,Google::Apis::DocsV1::Footnote>]
         attr_accessor :footnotes
       
-        # Output only. The headers in the document, keyed by header ID.
+        # Output only. The headers in the document, keyed by header ID. Legacy field:
+        # Instead, use Document.tabs.documentTab.headers, which exposes the actual
+        # document content from all tabs when the includeTabsContent parameter is set to
+        # `true`. If `false` or unset, this field contains information about the first
+        # tab in the document.
         # Corresponds to the JSON property `headers`
         # @return [Hash<String,Google::Apis::DocsV1::Header>]
         attr_accessor :headers
       
-        # Output only. The inline objects in the document, keyed by object ID.
+        # Output only. The inline objects in the document, keyed by object ID. Legacy
+        # field: Instead, use Document.tabs.documentTab.inlineObjects, which exposes the
+        # actual document content from all tabs when the includeTabsContent parameter is
+        # set to `true`. If `false` or unset, this field contains information about the
+        # first tab in the document.
         # Corresponds to the JSON property `inlineObjects`
         # @return [Hash<String,Google::Apis::DocsV1::InlineObject>]
         attr_accessor :inline_objects
       
-        # Output only. The lists in the document, keyed by list ID.
+        # Output only. The lists in the document, keyed by list ID. Legacy field:
+        # Instead, use Document.tabs.documentTab.lists, which exposes the actual
+        # document content from all tabs when the includeTabsContent parameter is set to
+        # `true`. If `false` or unset, this field contains information about the first
+        # tab in the document.
         # Corresponds to the JSON property `lists`
         # @return [Hash<String,Google::Apis::DocsV1::List>]
         attr_accessor :lists
       
-        # Output only. The named ranges in the document, keyed by name.
+        # Output only. The named ranges in the document, keyed by name. Legacy field:
+        # Instead, use Document.tabs.documentTab.namedRanges, which exposes the actual
+        # document content from all tabs when the includeTabsContent parameter is set to
+        # `true`. If `false` or unset, this field contains information about the first
+        # tab in the document.
         # Corresponds to the JSON property `namedRanges`
         # @return [Hash<String,Google::Apis::DocsV1::NamedRanges>]
         attr_accessor :named_ranges
@@ -982,6 +1006,10 @@ module Google
         attr_accessor :named_styles
       
         # Output only. The positioned objects in the document, keyed by object ID.
+        # Legacy field: Instead, use Document.tabs.documentTab.positionedObjects, which
+        # exposes the actual document content from all tabs when the includeTabsContent
+        # parameter is set to `true`. If `false` or unset, this field contains
+        # information about the first tab in the document.
         # Corresponds to the JSON property `positionedObjects`
         # @return [Hash<String,Google::Apis::DocsV1::PositionedObject>]
         attr_accessor :positioned_objects
@@ -1002,13 +1030,19 @@ module Google
         attr_accessor :revision_id
       
         # Output only. The suggested changes to the style of the document, keyed by
-        # suggestion ID.
+        # suggestion ID. Legacy field: Instead, use Document.tabs.documentTab.
+        # suggestedDocumentStyleChanges, which exposes the actual document content from
+        # all tabs when the includeTabsContent parameter is set to `true`. If `false` or
+        # unset, this field contains information about the first tab in the document.
         # Corresponds to the JSON property `suggestedDocumentStyleChanges`
         # @return [Hash<String,Google::Apis::DocsV1::SuggestedDocumentStyle>]
         attr_accessor :suggested_document_style_changes
       
         # Output only. The suggested changes to the named styles of the document, keyed
-        # by suggestion ID.
+        # by suggestion ID. Legacy field: Instead, use Document.tabs.documentTab.
+        # suggestedNamedStylesChanges, which exposes the actual document content from
+        # all tabs when the includeTabsContent parameter is set to `true`. If `false` or
+        # unset, this field contains information about the first tab in the document.
         # Corresponds to the JSON property `suggestedNamedStylesChanges`
         # @return [Hash<String,Google::Apis::DocsV1::SuggestedNamedStyles>]
         attr_accessor :suggested_named_styles_changes
@@ -1021,7 +1055,7 @@ module Google
         attr_accessor :suggestions_view_mode
       
         # Tabs that are part of a document. Tabs can contain child tabs, a tab nested
-        # within another tab. Child tabs are represented by the Tab.child_tabs field.
+        # within another tab. Child tabs are represented by the Tab.childTabs field.
         # Corresponds to the JSON property `tabs`
         # @return [Array<Google::Apis::DocsV1::Tab>]
         attr_accessor :tabs
@@ -2566,7 +2600,14 @@ module Google
         # @return [Google::Apis::DocsV1::BookmarkLink]
         attr_accessor :bookmark
       
-        # The ID of a bookmark in this document.
+        # The ID of a bookmark in this document. Legacy field: Instead, set
+        # includeTabsContent to `true` and use Link.bookmark for read and write
+        # operations. This field is only returned when includeTabsContent is set to `
+        # false` in documents containing a single tab and links to a bookmark within the
+        # singular tab. Otherwise, Link.bookmark is returned. If this field is used in a
+        # write request, the bookmark is considered to be from the tab ID specified in
+        # the request. If a tab ID is not specified in the request, it is considered to
+        # be from the first tab in the document.
         # Corresponds to the JSON property `bookmarkId`
         # @return [String]
         attr_accessor :bookmark_id
@@ -2576,7 +2617,14 @@ module Google
         # @return [Google::Apis::DocsV1::HeadingLink]
         attr_accessor :heading
       
-        # The ID of a heading in this document.
+        # The ID of a heading in this document. Legacy field: Instead, set
+        # includeTabsContent to `true` and use Link.heading for read and write
+        # operations. This field is only returned when includeTabsContent is set to `
+        # false` in documents containing a single tab and links to a heading within the
+        # singular tab. Otherwise, Link.heading is returned. If this field is used in a
+        # write request, the heading is considered to be from the tab ID specified in
+        # the request. If a tab ID is not specified in the request, it is considered to
+        # be from the first tab in the document.
         # Corresponds to the JSON property `headingId`
         # @return [String]
         attr_accessor :heading_id
@@ -5478,7 +5526,7 @@ module Google
       class TabProperties
         include Google::Apis::Core::Hashable
       
-        # The index of the tab within the parent.
+        # The zero-based index of the tab within the parent.
         # Corresponds to the JSON property `index`
         # @return [Fixnum]
         attr_accessor :index

data/lib/google/apis/docs_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DocsV1
       # Version of the google-apis-docs_v1 gem
-      GEM_VERSION = "0.28.0"
+      GEM_VERSION = "0.30.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.15.0"
+      GENERATOR_VERSION = "0.15.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240722"
+      REVISION = "20240730"
     end
   end
 end

data/lib/google/apis/docs_v1/service.rb

@@ -133,7 +133,7 @@ module Google
         #   The ID of the document to retrieve.
         # @param [Boolean] include_tabs_content
         #   Whether to populate the Document.tabs field instead of the text content fields
-        #   like body and documentStyle on Document. - When `True`: Document content
+        #   like `body` and `documentStyle` on Document. - When `True`: Document content
         #   populates in the Document.tabs field instead of the text content fields in
         #   Document. - When `False`: The content of the document's first tab populates
         #   the content fields in Document excluding Document.tabs. If a document has only

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-docs_v1
 version: !ruby/object:Gem::Version
-  version: 0.28.0
+  version: 0.30.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-07-25 00:00:00.000000000 Z
+date: 2024-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-docs_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-docs_v1/v0.28.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-docs_v1/v0.30.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-docs_v1
 post_install_message: 
 rdoc_options: []