google-apis-developerknowledge_v1 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '09c7934b521cb507226acc8da25163437cebc4990f9a9fff215b82bb9a3d66df'
-  data.tar.gz: 9c562926f90c0df9ad88edde054d2a0c22b527bcfbe9816e0cb6dd944bdc9a38
+  metadata.gz: 37bc4906110952047945b2baa45960b47c40659678b12a1c6961c46d413d9969
+  data.tar.gz: 0d0a93d1b78b6311913eea4c490ef04d0069090330f9fdbe5ad513b82c26bdee
 SHA512:
-  metadata.gz: acbfa320263a37921b9cdb06a843d90b005d2bdc38fbeb2dc5440f8b3ab939567e66f42c05cb4de3d0ac36478eb72474152e6947f8a7cd2d0ce83b60ef223e23
-  data.tar.gz: d5feddddbffe7668cb327ad8007a4edce79196b9b419a4d8aa60ee147601d1d54c5206d557c1132e350e4bbd93ee15a3d15204a5d330fac6d9a70d51a8137cd7
+  metadata.gz: e4ad6e0d16d7c7524735e1576a9f21e9e733f43b004cbb54dfdd7ee7d8b89d16a945b9916e98dddd1da4151742d206663610afd2643569b19715d090e90f0017
+  data.tar.gz: 2183021ec491db6e8baea4a76f9ff128f277b6fc6708e3a5c55506550daeb8c4b279cb11e453a6d7c5498a6806edfee8a897eab11c04e79754dc022b35d3670e

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-developerknowledge_v1
 
+### v0.7.0 (2026-08-09)
+
+* Regenerated from discovery document revision 20260802
+
+### v0.6.0 (2026-07-26)
+
+* Regenerated from discovery document revision 20260719
+
 ### v0.5.0 (2026-07-12)
 
 * Regenerated from discovery document revision 20260705

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

@@ -22,6 +22,129 @@ module Google
   module Apis
     module DeveloperknowledgeV1
       
+      # An answer to a query.
+      class Answer
+        include Google::Apis::Core::Hashable
+      
+        # Contains the text of the answer.
+        # Corresponds to the JSON property `answerText`
+        # @return [String]
+        attr_accessor :answer_text
+      
+        # Output only. Contains citations for the answer.
+        # Corresponds to the JSON property `citations`
+        # @return [Array<Google::Apis::DeveloperknowledgeV1::AnswerCitation>]
+        attr_accessor :citations
+      
+        # Output only. Contains references for the answer.
+        # Corresponds to the JSON property `references`
+        # @return [Array<Google::Apis::DeveloperknowledgeV1::AnswerReference>]
+        attr_accessor :references
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @answer_text = args[:answer_text] if args.key?(:answer_text)
+          @citations = args[:citations] if args.key?(:citations)
+          @references = args[:references] if args.key?(:references)
+        end
+      end
+      
+      # Citation info for a segment.
+      class AnswerCitation
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Indicates the end of the segment, measured in bytes (UTF-8
+        # unicode), exclusive. If there are multi-byte characters, such as non-ASCII
+        # characters, the index measurement is longer than the string length.
+        # Corresponds to the JSON property `endIndex`
+        # @return [Fixnum]
+        attr_accessor :end_index
+      
+        # Output only. Contains citation sources for the attributed segment.
+        # Corresponds to the JSON property `sources`
+        # @return [Array<Google::Apis::DeveloperknowledgeV1::CitationSource>]
+        attr_accessor :sources
+      
+        # Output only. Indicates the start of the segment, measured in bytes (UTF-8
+        # unicode), inclusive. If there are multi-byte characters, such as non-ASCII
+        # characters, the index measurement is longer than the string length.
+        # Corresponds to the JSON property `startIndex`
+        # @return [Fixnum]
+        attr_accessor :start_index
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_index = args[:end_index] if args.key?(:end_index)
+          @sources = args[:sources] if args.key?(:sources)
+          @start_index = args[:start_index] if args.key?(:start_index)
+        end
+      end
+      
+      # Request message for DeveloperKnowledge.AnswerQuery.
+      class AnswerQueryRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The query to answer.
+        # Corresponds to the JSON property `query`
+        # @return [String]
+        attr_accessor :query
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @query = args[:query] if args.key?(:query)
+        end
+      end
+      
+      # Response message for DeveloperKnowledge.AnswerQuery.
+      class AnswerQueryResponse
+        include Google::Apis::Core::Hashable
+      
+        # An answer to a query.
+        # Corresponds to the JSON property `answer`
+        # @return [Google::Apis::DeveloperknowledgeV1::Answer]
+        attr_accessor :answer
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @answer = args[:answer] if args.key?(:answer)
+        end
+      end
+      
+      # Represents a reference to a source.
+      class AnswerReference
+        include Google::Apis::Core::Hashable
+      
+        # Represents a reference to a document.
+        # Corresponds to the JSON property `documentReference`
+        # @return [Google::Apis::DeveloperknowledgeV1::DocumentReference]
+        attr_accessor :document_reference
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @document_reference = args[:document_reference] if args.key?(:document_reference)
+        end
+      end
+      
       # Response message for DeveloperKnowledge.BatchGetDocuments.
       class BatchGetDocumentsResponse
         include Google::Apis::Core::Hashable
@@ -41,7 +164,29 @@ module Google
         end
       end
       
-      # A Document represents a piece of content from the Developer Knowledge corpus.
+      # Citation source.
+      class CitationSource
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Contains the index of the Answer.AnswerReference in the `
+        # references` repeated field.
+        # Corresponds to the JSON property `referenceIndex`
+        # @return [Fixnum]
+        attr_accessor :reference_index
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @reference_index = args[:reference_index] if args.key?(:reference_index)
+        end
+      end
+      
+      # A Document represents a page of documentation in the Developer Knowledge
+      # corpus, like the page at https://docs.cloud.google.com/storage/docs/creating-
+      # buckets.
       class Document
         include Google::Apis::Core::Hashable
       
@@ -125,7 +270,9 @@ module Google
         # @return [String]
         attr_accessor :content
       
-        # A Document represents a piece of content from the Developer Knowledge corpus.
+        # A Document represents a page of documentation in the Developer Knowledge
+        # corpus, like the page at https://docs.cloud.google.com/storage/docs/creating-
+        # buckets.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::DeveloperknowledgeV1::Document]
         attr_accessor :document
@@ -157,12 +304,34 @@ module Google
         end
       end
       
+      # Represents a reference to a document.
+      class DocumentReference
+        include Google::Apis::Core::Hashable
+      
+        # A DocumentChunk represents a piece of content from a Document in the
+        # DeveloperKnowledge corpus. To fetch the entire document content, pass the `
+        # parent` to DeveloperKnowledge.GetDocument or DeveloperKnowledge.
+        # BatchGetDocuments.
+        # Corresponds to the JSON property `documentChunk`
+        # @return [Google::Apis::DeveloperknowledgeV1::DocumentChunk]
+        attr_accessor :document_chunk
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @document_chunk = args[:document_chunk] if args.key?(:document_chunk)
+        end
+      end
+      
       # Response message for DeveloperKnowledge.SearchDocumentChunks.
       class SearchDocumentChunksResponse
         include Google::Apis::Core::Hashable
       
-        # Optional. Provides a token that can be sent as `page_token` to retrieve the
-        # next page. If this field is omitted, there are no subsequent pages.
+        # Provides a token that can be sent as `page_token` to retrieve the next page.
+        # If this field is omitted, there are no subsequent pages.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DeveloperknowledgeV1
       # Version of the google-apis-developerknowledge_v1 gem
-      GEM_VERSION = "0.5.0"
+      GEM_VERSION = "0.7.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.19.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20260705"
+      REVISION = "20260802"
     end
   end
 end

data/lib/google/apis/developerknowledge_v1/representations.rb

@@ -22,12 +22,48 @@ module Google
   module Apis
     module DeveloperknowledgeV1
       
+      class Answer
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AnswerCitation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AnswerQueryRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AnswerQueryResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AnswerReference
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class BatchGetDocumentsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CitationSource
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Document
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -40,12 +76,62 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DocumentReference
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class SearchDocumentChunksResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Answer
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :answer_text, as: 'answerText'
+          collection :citations, as: 'citations', class: Google::Apis::DeveloperknowledgeV1::AnswerCitation, decorator: Google::Apis::DeveloperknowledgeV1::AnswerCitation::Representation
+      
+          collection :references, as: 'references', class: Google::Apis::DeveloperknowledgeV1::AnswerReference, decorator: Google::Apis::DeveloperknowledgeV1::AnswerReference::Representation
+      
+        end
+      end
+      
+      class AnswerCitation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :end_index, as: 'endIndex'
+          collection :sources, as: 'sources', class: Google::Apis::DeveloperknowledgeV1::CitationSource, decorator: Google::Apis::DeveloperknowledgeV1::CitationSource::Representation
+      
+          property :start_index, as: 'startIndex'
+        end
+      end
+      
+      class AnswerQueryRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :query, as: 'query'
+        end
+      end
+      
+      class AnswerQueryResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :answer, as: 'answer', class: Google::Apis::DeveloperknowledgeV1::Answer, decorator: Google::Apis::DeveloperknowledgeV1::Answer::Representation
+      
+        end
+      end
+      
+      class AnswerReference
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :document_reference, as: 'documentReference', class: Google::Apis::DeveloperknowledgeV1::DocumentReference, decorator: Google::Apis::DeveloperknowledgeV1::DocumentReference::Representation
+      
+        end
+      end
+      
       class BatchGetDocumentsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -54,6 +140,13 @@ module Google
         end
       end
       
+      class CitationSource
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :reference_index, as: 'referenceIndex'
+        end
+      end
+      
       class Document
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -80,6 +173,14 @@ module Google
         end
       end
       
+      class DocumentReference
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :document_chunk, as: 'documentChunk', class: Google::Apis::DeveloperknowledgeV1::DocumentChunk, decorator: Google::Apis::DeveloperknowledgeV1::DocumentChunk::Representation
+      
+        end
+      end
+      
       class SearchDocumentChunksResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -56,7 +56,9 @@ module Google
         #   Required. Specifies the names of the documents to retrieve. A maximum of 20
         #   documents can be retrieved in a batch. The documents are returned in the same
         #   order as the `names` in the request. Format: `documents/`uri_without_scheme``
-        #   Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets`
+        #   Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets` Each
+        #   name must not exceed 500 characters; values longer than 500 characters will
+        #   result in an `INVALID_ARGUMENT` error.
         # @param [String] view
         #   Optional. Specifies the DocumentView of the document. If unspecified,
         #   DeveloperKnowledge.BatchGetDocuments defaults to `DOCUMENT_VIEW_CONTENT`.
@@ -92,7 +94,8 @@ module Google
         # @param [String] name
         #   Required. Specifies the name of the document to retrieve. Format: `documents/`
         #   uri_without_scheme`` Example: `documents/docs.cloud.google.com/storage/docs/
-        #   creating-buckets`
+        #   creating-buckets` The name must not exceed 500 characters; values longer than
+        #   500 characters will result in an `INVALID_ARGUMENT` error.
         # @param [String] view
         #   Optional. Specifies the DocumentView of the document. If unspecified,
         #   DeveloperKnowledge.GetDocument defaults to `DOCUMENT_VIEW_CONTENT`.
@@ -133,29 +136,29 @@ module Google
         #   Optional. Applies a strict filter to the search results. The expression
         #   supports a subset of the syntax described at https://google.aip.dev/160. While
         #   `SearchDocumentChunks` returns DocumentChunks, the filter is applied to `
-        #   DocumentChunk.document` fields. Supported fields for filtering: * `
-        #   content_length_bytes` (INTEGER): The length of the `Document.content` field in
-        #   bytes. * `data_source` (STRING): The source of the document, e.g. `docs.cloud.
-        #   google.com`. See https://developers.google.com/knowledge/reference/corpus-
-        #   reference for the complete list of data sources in the corpus. * `update_time`
-        #   (TIMESTAMP): The timestamp of when the document was last meaningfully updated.
-        #   A meaningful update is one that changes document's markdown content or
-        #   metadata. * `uri` (STRING): The document URI, e.g. `https://docs.cloud.google.
-        #   com/bigquery/docs/tables`. INTEGER fields support `=`, `<`, `<=`, `>`, and `>=`
-        #   operators. STRING fields support `=` (equals) and `!=` (not equals) operators
-        #   for **exact match** on the whole string. Partial match, prefix match, and
-        #   regexp match are not supported. TIMESTAMP fields support `=`, `<`, `<=`, `>`,
-        #   and `>=` operators. Timestamps must be in RFC-3339 format, e.g., `"2025-01-
-        #   01T00:00:00Z"`. You can combine expressions using `AND`, `OR`, and `NOT` (or `-
-        #   `) logical operators. `OR` has higher precedence than `AND`. Use parentheses
-        #   for explicit precedence grouping. Examples: * Filter by `Document.
-        #   content_length_bytes`: `content_length_bytes < 50000` * `data_source = "docs.
-        #   cloud.google.com" OR data_source = "firebase.google.com"` * `data_source != "
-        #   firebase.google.com"` * `update_time < "2024-01-01T00:00:00Z"` * `update_time >
-        #   = "2025-01-22T00:00:00Z" AND (data_source = "developer.chrome.com" OR
-        #   data_source = "web.dev")` * `uri = "https://docs.cloud.google.com/release-
-        #   notes"` The `filter` string must not exceed 500 characters; values longer than
-        #   500 characters will result in an `INVALID_ARGUMENT` error.
+        #   DocumentChunk.document` fields. Supported fields for filtering: * `data_source`
+        #   (STRING): The source of the document, e.g. `docs.cloud.google.com`. See https:
+        #   //developers.google.com/knowledge/reference/corpus-reference for the complete
+        #   list of data sources in the corpus. * `update_time` (TIMESTAMP): The timestamp
+        #   of when the document was last meaningfully updated. A meaningful update is one
+        #   that changes document's markdown content or metadata. * `uri` (STRING): The
+        #   document URI, e.g. `https://docs.cloud.google.com/bigquery/docs/tables`.
+        #   STRING fields support `=` (equals) and `!=` (not equals) operators for **exact
+        #   match** on the whole string. Partial match, prefix match, and regexp match are
+        #   not supported. TIMESTAMP fields support `=`, `<`, `<=`, `>`, and `>=`
+        #   operators. Timestamps must be in RFC-3339 format, e.g., `"2025-01-01T00:00:00Z"
+        #   `. Note: Field names must be in `snake_case` (e.g., `data_source`). Values on
+        #   the right-hand side of filtering expressions must be string literals enclosed
+        #   in double quotes (e.g., `"docs.cloud.google.com"`). You can combine
+        #   expressions using `AND`, `OR`, and `NOT` (or `-`) logical operators. `OR` has
+        #   higher precedence than `AND`. Use parentheses for explicit precedence grouping.
+        #   Examples: * `data_source = "docs.cloud.google.com" OR data_source = "firebase.
+        #   google.com"` * `data_source != "firebase.google.com"` * `update_time < "2024-
+        #   01-01T00:00:00Z"` * `update_time >= "2025-01-22T00:00:00Z" AND (data_source = "
+        #   developer.chrome.com" OR data_source = "web.dev")` * `uri = "https://docs.
+        #   cloud.google.com/release-notes"` The `filter` string must not exceed 500
+        #   characters; values longer than 500 characters will result in an `
+        #   INVALID_ARGUMENT` error.
         # @param [Fixnum] page_size
         #   Optional. Specifies the maximum number of results to return. The service may
         #   return fewer than this value. If unspecified, at most 5 results will be
@@ -165,7 +168,8 @@ module Google
         #   SearchDocumentChunks` call. Provide this to retrieve the subsequent page.
         # @param [String] query
         #   Required. Provides the raw query string provided by the user, such as "How to
-        #   create a Cloud Storage bucket?".
+        #   create a Cloud Storage bucket?". The query must not exceed 500 characters;
+        #   values longer than 500 characters will result in an `INVALID_ARGUMENT` error.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -195,6 +199,36 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Answers a query using grounded generation.
+        # @param [Google::Apis::DeveloperknowledgeV1::AnswerQueryRequest] answer_query_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DeveloperknowledgeV1::AnswerQueryResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DeveloperknowledgeV1::AnswerQueryResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def answer_query(answer_query_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1:answerQuery', options)
+          command.request_representation = Google::Apis::DeveloperknowledgeV1::AnswerQueryRequest::Representation
+          command.request_object = answer_query_request_object
+          command.response_representation = Google::Apis::DeveloperknowledgeV1::AnswerQueryResponse::Representation
+          command.response_class = Google::Apis::DeveloperknowledgeV1::AnswerQueryResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-developerknowledge_v1
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,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-developerknowledge_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-developerknowledge_v1/v0.5.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-developerknowledge_v1/v0.7.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-developerknowledge_v1
 rdoc_options: []
 require_paths: