google-developers-developer_knowledge-v1 0.4.0 → 0.6.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 8ad8cca7aaa334031193c8b77909834f2c5404ed76621c45a9ea4ee1a65248ac
4
- data.tar.gz: a70b840dcc90caf6a69643be1f58ca13e7cb18409af0fa13bc341f2bc2e92320
3
+ metadata.gz: e24893debdcedf59cad14a30a551f3ea9403c702aec424fc0715e6e748cf7d98
4
+ data.tar.gz: 88196a6f2cc9c55092adf83e616d81fbf6edec82bf94ed41d7535ccd265a5dbe
5
5
  SHA512:
6
- metadata.gz: 5abcfddb5429906b3b107b0c8b066bd1e7485cb80e466eb62014aabdadb9f7adb6d7227625c069719866bc71e12c463ae2cc8c282db6c49fdaefcb6a81cc8980
7
- data.tar.gz: 3e555a5e75575935eb22a5cf0ef7b4f9a91e80f00e2e2ce62e5b30997d2aac3b7ce9c4b49cd77ce1862b1d63d0f5b9f7983141a78d97251cd888c9182d8366c7
6
+ metadata.gz: 14e50fe2c277376530f7306772fbe8394d4d49959b67b748e5515e197dddb1b1cd379dd75348918393a60d1f266eca324428ecf6529c2129dadbe11bb51bc124
7
+ data.tar.gz: c5d9f4a58961b2df0cdb3c7cc1e3071d2dc9eac1945310c756d8a48f33bf09d7a58ea0f0f43c395c5db3a9bb68a3d67671fa2096565ba676de544c3fe3979ce3
@@ -85,6 +85,11 @@ module Google
85
85
  end
86
86
  default_config = Client::Configuration.new parent_config
87
87
 
88
+ default_config.rpcs.search_document_chunks.timeout = 60.0
89
+ default_config.rpcs.search_document_chunks.retry_policy = {
90
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
91
+ }
92
+
88
93
  default_config.rpcs.get_document.timeout = 60.0
89
94
  default_config.rpcs.get_document.retry_policy = {
90
95
  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
@@ -568,13 +573,59 @@ module Google
568
573
  # @param options [::Gapic::CallOptions, ::Hash]
569
574
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
570
575
  #
571
- # @overload answer_query(query: nil)
576
+ # @overload answer_query(query: nil, filter: nil)
572
577
  # Pass arguments to `answer_query` via keyword arguments. Note that at
573
578
  # least one keyword argument is required. To specify no parameters, or to keep all
574
579
  # the default parameter values, pass an empty Hash as a request object (see above).
575
580
  #
576
581
  # @param query [::String]
577
582
  # Required. The query to answer.
583
+ # @param filter [::String]
584
+ # Optional. Applies a strict filter to the search results used to ground the
585
+ # answer. The expression supports a subset of the syntax described at
586
+ # https://google.aip.dev/160.
587
+ #
588
+ # Supported fields for filtering:
589
+ #
590
+ # * `content_length_bytes` (INTEGER): The length of the `Document.content`
591
+ # field in bytes.
592
+ # * `data_source` (STRING): The source of the document, e.g.
593
+ # `docs.cloud.google.com`. See
594
+ # https://developers.google.com/knowledge/reference/corpus-reference for
595
+ # the complete list of data sources in the corpus.
596
+ # * `update_time` (TIMESTAMP): The timestamp of when the document was last
597
+ # meaningfully updated. A meaningful update is one that changes document's
598
+ # markdown content or metadata.
599
+ # * `uri` (STRING): The document URI, e.g.
600
+ # `https://docs.cloud.google.com/bigquery/docs/tables`.
601
+ #
602
+ # INTEGER fields support `=`, `<`, `<=`, `>`, and `>=` operators.
603
+ #
604
+ # STRING fields support `=` (equals) and `!=` (not equals) operators for
605
+ # **exact match** on the whole string. Partial match, prefix match, and
606
+ # regexp match are not supported.
607
+ #
608
+ # TIMESTAMP fields support `=`, `<`, `<=`, `>`, and `>=` operators.
609
+ # Timestamps must be in RFC-3339 format, e.g., `"2025-01-01T00:00:00Z"`.
610
+ #
611
+ # You can combine expressions using `AND`, `OR`, and `NOT` (or `-`) logical
612
+ # operators. `OR` has higher precedence than `AND`. Use parentheses for
613
+ # explicit precedence grouping.
614
+ #
615
+ # Examples:
616
+ #
617
+ # * Filter by `Document.content_length_bytes`:
618
+ # `content_length_bytes < 50000`
619
+ # * `data_source = "docs.cloud.google.com" OR data_source =
620
+ # "firebase.google.com"`
621
+ # * `data_source != "firebase.google.com"`
622
+ # * `update_time < "2024-01-01T00:00:00Z"`
623
+ # * `update_time >= "2025-01-22T00:00:00Z" AND (data_source =
624
+ # "developer.chrome.com" OR data_source = "web.dev")`
625
+ # * `uri = "https://docs.cloud.google.com/release-notes"`
626
+ #
627
+ # The `filter` string must not exceed 500 characters; values longer than 500
628
+ # characters will result in an `INVALID_ARGUMENT` error.
578
629
  #
579
630
  # @yield [response, operation] Access the result along with the RPC operation
580
631
  # @yieldparam response [::Google::Developers::DeveloperKnowledge::V1::AnswerQueryResponse]
@@ -87,6 +87,11 @@ module Google
87
87
  end
88
88
  default_config = Client::Configuration.new parent_config
89
89
 
90
+ default_config.rpcs.search_document_chunks.timeout = 60.0
91
+ default_config.rpcs.search_document_chunks.retry_policy = {
92
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
93
+ }
94
+
90
95
  default_config.rpcs.get_document.timeout = 60.0
91
96
  default_config.rpcs.get_document.retry_policy = {
92
97
  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
@@ -556,13 +561,59 @@ module Google
556
561
  # @param options [::Gapic::CallOptions, ::Hash]
557
562
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
558
563
  #
559
- # @overload answer_query(query: nil)
564
+ # @overload answer_query(query: nil, filter: nil)
560
565
  # Pass arguments to `answer_query` via keyword arguments. Note that at
561
566
  # least one keyword argument is required. To specify no parameters, or to keep all
562
567
  # the default parameter values, pass an empty Hash as a request object (see above).
563
568
  #
564
569
  # @param query [::String]
565
570
  # Required. The query to answer.
571
+ # @param filter [::String]
572
+ # Optional. Applies a strict filter to the search results used to ground the
573
+ # answer. The expression supports a subset of the syntax described at
574
+ # https://google.aip.dev/160.
575
+ #
576
+ # Supported fields for filtering:
577
+ #
578
+ # * `content_length_bytes` (INTEGER): The length of the `Document.content`
579
+ # field in bytes.
580
+ # * `data_source` (STRING): The source of the document, e.g.
581
+ # `docs.cloud.google.com`. See
582
+ # https://developers.google.com/knowledge/reference/corpus-reference for
583
+ # the complete list of data sources in the corpus.
584
+ # * `update_time` (TIMESTAMP): The timestamp of when the document was last
585
+ # meaningfully updated. A meaningful update is one that changes document's
586
+ # markdown content or metadata.
587
+ # * `uri` (STRING): The document URI, e.g.
588
+ # `https://docs.cloud.google.com/bigquery/docs/tables`.
589
+ #
590
+ # INTEGER fields support `=`, `<`, `<=`, `>`, and `>=` operators.
591
+ #
592
+ # STRING fields support `=` (equals) and `!=` (not equals) operators for
593
+ # **exact match** on the whole string. Partial match, prefix match, and
594
+ # regexp match are not supported.
595
+ #
596
+ # TIMESTAMP fields support `=`, `<`, `<=`, `>`, and `>=` operators.
597
+ # Timestamps must be in RFC-3339 format, e.g., `"2025-01-01T00:00:00Z"`.
598
+ #
599
+ # You can combine expressions using `AND`, `OR`, and `NOT` (or `-`) logical
600
+ # operators. `OR` has higher precedence than `AND`. Use parentheses for
601
+ # explicit precedence grouping.
602
+ #
603
+ # Examples:
604
+ #
605
+ # * Filter by `Document.content_length_bytes`:
606
+ # `content_length_bytes < 50000`
607
+ # * `data_source = "docs.cloud.google.com" OR data_source =
608
+ # "firebase.google.com"`
609
+ # * `data_source != "firebase.google.com"`
610
+ # * `update_time < "2024-01-01T00:00:00Z"`
611
+ # * `update_time >= "2025-01-22T00:00:00Z" AND (data_source =
612
+ # "developer.chrome.com" OR data_source = "web.dev")`
613
+ # * `uri = "https://docs.cloud.google.com/release-notes"`
614
+ #
615
+ # The `filter` string must not exceed 500 characters; values longer than 500
616
+ # characters will result in an `INVALID_ARGUMENT` error.
566
617
  # @yield [result, operation] Access the result along with the TransportOperation object
567
618
  # @yieldparam result [::Google::Developers::DeveloperKnowledge::V1::AnswerQueryResponse]
568
619
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -21,7 +21,7 @@ module Google
21
21
  module Developers
22
22
  module DeveloperKnowledge
23
23
  module V1
24
- VERSION = "0.4.0"
24
+ VERSION = "0.6.0"
25
25
  end
26
26
  end
27
27
  end
@@ -11,7 +11,7 @@ require 'google/api/resource_pb'
11
11
  require 'google/protobuf/timestamp_pb'
12
12
 
13
13
 
14
- descriptor_data = "\n7google/developers/knowledge/v1/developerknowledge.proto\x12\x1egoogle.developers.knowledge.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x83\x03\n\x08\x44ocument\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x08\x12\x10\n\x03uri\x18\x02 \x01(\tB\x03\xe0\x41\x03\x12\x14\n\x07\x63ontent\x18\x03 \x01(\tB\x03\xe0\x41\x03\x12\x18\n\x0b\x64\x65scription\x18\x04 \x01(\tB\x03\xe0\x41\x03\x12\x18\n\x0b\x64\x61ta_source\x18\x05 \x01(\tB\x03\xe0\x41\x03\x12\x12\n\x05title\x18\x06 \x01(\tB\x03\xe0\x41\x03\x12\x34\n\x0bupdate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12?\n\x04view\x18\x08 \x01(\x0e\x32,.google.developers.knowledge.v1.DocumentViewB\x03\xe0\x41\x03\x12!\n\x14\x63ontent_length_bytes\x18\t \x01(\x05\x42\x03\xe0\x41\x03:Z\xea\x41W\n*developerknowledge.googleapis.com/Document\x12\x14\x64ocuments/{document}*\tdocuments2\x08\x64ocument\"w\n\x1bSearchDocumentChunksRequest\x12\x12\n\x05query\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x13\n\x06\x66ilter\x18\x04 \x01(\tB\x03\xe0\x41\x01\"w\n\x1cSearchDocumentChunksResponse\x12>\n\x07results\x18\x01 \x03(\x0b\x32-.google.developers.knowledge.v1.DocumentChunk\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\x97\x01\n\x12GetDocumentRequest\x12@\n\x04name\x18\x01 \x01(\tB2\xe0\x41\x02\xfa\x41,\n*developerknowledge.googleapis.com/Document\x12?\n\x04view\x18\x02 \x01(\x0e\x32,.google.developers.knowledge.v1.DocumentViewB\x03\xe0\x41\x01\"\x9e\x01\n\x18\x42\x61tchGetDocumentsRequest\x12\x41\n\x05names\x18\x01 \x03(\tB2\xe0\x41\x02\xfa\x41,\n*developerknowledge.googleapis.com/Document\x12?\n\x04view\x18\x02 \x01(\x0e\x32,.google.developers.knowledge.v1.DocumentViewB\x03\xe0\x41\x01\"X\n\x19\x42\x61tchGetDocumentsResponse\x12;\n\tdocuments\x18\x01 \x03(\x0b\x32(.google.developers.knowledge.v1.Document\"(\n\x12\x41nswerQueryRequest\x12\x12\n\x05query\x18\x01 \x01(\tB\x03\xe0\x41\x02\"M\n\x13\x41nswerQueryResponse\x12\x36\n\x06\x61nswer\x18\x01 \x01(\x0b\x32&.google.developers.knowledge.v1.Answer\"\xdb\x04\n\x06\x41nswer\x12\x13\n\x0b\x61nswer_text\x18\x01 \x01(\t\x12M\n\tcitations\x18\x02 \x03(\x0b\x32\x35.google.developers.knowledge.v1.Answer.AnswerCitationB\x03\xe0\x41\x03\x12O\n\nreferences\x18\x03 \x03(\x0b\x32\x36.google.developers.knowledge.v1.Answer.AnswerReferenceB\x03\xe0\x41\x03\x1a\x8f\x01\n\x0e\x41nswerCitation\x12\x18\n\x0bstart_index\x18\x01 \x01(\x05\x42\x03\xe0\x41\x03\x12\x16\n\tend_index\x18\x02 \x01(\x05\x42\x03\xe0\x41\x03\x12K\n\x07sources\x18\x03 \x03(\x0b\x32\x35.google.developers.knowledge.v1.Answer.CitationSourceB\x03\xe0\x41\x03\x1a.\n\x0e\x43itationSource\x12\x1c\n\x0freference_index\x18\x01 \x01(\x05\x42\x03\xe0\x41\x03\x1ay\n\x0f\x41nswerReference\x12[\n\x12\x64ocument_reference\x18\x01 \x01(\x0b\x32\x38.google.developers.knowledge.v1.Answer.DocumentReferenceB\x03\xe0\x41\x03H\x00\x42\t\n\x07\x63ontent\x1a_\n\x11\x44ocumentReference\x12J\n\x0e\x64ocument_chunk\x18\x01 \x01(\x0b\x32-.google.developers.knowledge.v1.DocumentChunkB\x03\xe0\x41\x03\"\xf2\x01\n\rDocumentChunk\x12\x42\n\x06parent\x18\x01 \x01(\tB2\xe0\x41\x03\xfa\x41,\n*developerknowledge.googleapis.com/Document\x12\x0f\n\x02id\x18\x02 \x01(\tB\x03\xe0\x41\x03\x12\x14\n\x07\x63ontent\x18\x03 \x01(\tB\x03\xe0\x41\x03\x12?\n\x08\x64ocument\x18\x04 \x01(\x0b\x32(.google.developers.knowledge.v1.DocumentB\x03\xe0\x41\x03\x12!\n\x0frelevance_score\x18\x05 \x01(\x01\x42\x03\xe0\x41\x03H\x00\x88\x01\x01\x42\x12\n\x10_relevance_score*y\n\x0c\x44ocumentView\x12\x1d\n\x19\x44OCUMENT_VIEW_UNSPECIFIED\x10\x00\x12\x17\n\x13\x44OCUMENT_VIEW_BASIC\x10\x01\x12\x16\n\x12\x44OCUMENT_VIEW_FULL\x10\x02\x12\x19\n\x15\x44OCUMENT_VIEW_CONTENT\x10\x03\x32\x81\x06\n\x12\x44\x65veloperKnowledge\x12\xbd\x01\n\x14SearchDocumentChunks\x12;.google.developers.knowledge.v1.SearchDocumentChunksRequest\x1a<.google.developers.knowledge.v1.SearchDocumentChunksResponse\"*\x82\xd3\xe4\x93\x02$\x12\"/v1/documents:searchDocumentChunks\x12\x93\x01\n\x0bGetDocument\x12\x32.google.developers.knowledge.v1.GetDocumentRequest\x1a(.google.developers.knowledge.v1.Document\"&\xda\x41\x04name\x82\xd3\xe4\x93\x02\x19\x12\x17/v1/{name=documents/**}\x12\xa8\x01\n\x11\x42\x61tchGetDocuments\x12\x38.google.developers.knowledge.v1.BatchGetDocumentsRequest\x1a\x39.google.developers.knowledge.v1.BatchGetDocumentsResponse\"\x1e\x82\xd3\xe4\x93\x02\x18\x12\x16/v1/documents:batchGet\x12\x92\x01\n\x0b\x41nswerQuery\x12\x32.google.developers.knowledge.v1.AnswerQueryRequest\x1a\x33.google.developers.knowledge.v1.AnswerQueryResponse\"\x1a\x82\xd3\xe4\x93\x02\x14\"\x0f/v1:answerQuery:\x01*\x1aU\xca\x41!developerknowledge.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x83\x02\n\"com.google.developers.knowledge.v1B\x17\x44\x65veloperKnowledgeProtoP\x01ZAcloud.google.com/go/developerknowledge/apiv1/developerknowledgepb\xaa\x02\'Google.Developers.DeveloperKnowledge.V1\xca\x02\'Google\\Developers\\DeveloperKnowledge\\V1\xea\x02*Google::Developers::DeveloperKnowledge::V1b\x06proto3"
14
+ descriptor_data = "\n7google/developers/knowledge/v1/developerknowledge.proto\x12\x1egoogle.developers.knowledge.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x83\x03\n\x08\x44ocument\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x08\x12\x10\n\x03uri\x18\x02 \x01(\tB\x03\xe0\x41\x03\x12\x14\n\x07\x63ontent\x18\x03 \x01(\tB\x03\xe0\x41\x03\x12\x18\n\x0b\x64\x65scription\x18\x04 \x01(\tB\x03\xe0\x41\x03\x12\x18\n\x0b\x64\x61ta_source\x18\x05 \x01(\tB\x03\xe0\x41\x03\x12\x12\n\x05title\x18\x06 \x01(\tB\x03\xe0\x41\x03\x12\x34\n\x0bupdate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12?\n\x04view\x18\x08 \x01(\x0e\x32,.google.developers.knowledge.v1.DocumentViewB\x03\xe0\x41\x03\x12!\n\x14\x63ontent_length_bytes\x18\t \x01(\x05\x42\x03\xe0\x41\x03:Z\xea\x41W\n*developerknowledge.googleapis.com/Document\x12\x14\x64ocuments/{document}*\tdocuments2\x08\x64ocument\"w\n\x1bSearchDocumentChunksRequest\x12\x12\n\x05query\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x13\n\x06\x66ilter\x18\x04 \x01(\tB\x03\xe0\x41\x01\"w\n\x1cSearchDocumentChunksResponse\x12>\n\x07results\x18\x01 \x03(\x0b\x32-.google.developers.knowledge.v1.DocumentChunk\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"\x97\x01\n\x12GetDocumentRequest\x12@\n\x04name\x18\x01 \x01(\tB2\xe0\x41\x02\xfa\x41,\n*developerknowledge.googleapis.com/Document\x12?\n\x04view\x18\x02 \x01(\x0e\x32,.google.developers.knowledge.v1.DocumentViewB\x03\xe0\x41\x01\"\x9e\x01\n\x18\x42\x61tchGetDocumentsRequest\x12\x41\n\x05names\x18\x01 \x03(\tB2\xe0\x41\x02\xfa\x41,\n*developerknowledge.googleapis.com/Document\x12?\n\x04view\x18\x02 \x01(\x0e\x32,.google.developers.knowledge.v1.DocumentViewB\x03\xe0\x41\x01\"X\n\x19\x42\x61tchGetDocumentsResponse\x12;\n\tdocuments\x18\x01 \x03(\x0b\x32(.google.developers.knowledge.v1.Document\"=\n\x12\x41nswerQueryRequest\x12\x12\n\x05query\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x06\x66ilter\x18\x02 \x01(\tB\x03\xe0\x41\x01\"M\n\x13\x41nswerQueryResponse\x12\x36\n\x06\x61nswer\x18\x01 \x01(\x0b\x32&.google.developers.knowledge.v1.Answer\"\xdb\x04\n\x06\x41nswer\x12\x13\n\x0b\x61nswer_text\x18\x01 \x01(\t\x12M\n\tcitations\x18\x02 \x03(\x0b\x32\x35.google.developers.knowledge.v1.Answer.AnswerCitationB\x03\xe0\x41\x03\x12O\n\nreferences\x18\x03 \x03(\x0b\x32\x36.google.developers.knowledge.v1.Answer.AnswerReferenceB\x03\xe0\x41\x03\x1a\x8f\x01\n\x0e\x41nswerCitation\x12\x18\n\x0bstart_index\x18\x01 \x01(\x05\x42\x03\xe0\x41\x03\x12\x16\n\tend_index\x18\x02 \x01(\x05\x42\x03\xe0\x41\x03\x12K\n\x07sources\x18\x03 \x03(\x0b\x32\x35.google.developers.knowledge.v1.Answer.CitationSourceB\x03\xe0\x41\x03\x1a.\n\x0e\x43itationSource\x12\x1c\n\x0freference_index\x18\x01 \x01(\x05\x42\x03\xe0\x41\x03\x1ay\n\x0f\x41nswerReference\x12[\n\x12\x64ocument_reference\x18\x01 \x01(\x0b\x32\x38.google.developers.knowledge.v1.Answer.DocumentReferenceB\x03\xe0\x41\x03H\x00\x42\t\n\x07\x63ontent\x1a_\n\x11\x44ocumentReference\x12J\n\x0e\x64ocument_chunk\x18\x01 \x01(\x0b\x32-.google.developers.knowledge.v1.DocumentChunkB\x03\xe0\x41\x03\"\xf2\x01\n\rDocumentChunk\x12\x42\n\x06parent\x18\x01 \x01(\tB2\xe0\x41\x03\xfa\x41,\n*developerknowledge.googleapis.com/Document\x12\x0f\n\x02id\x18\x02 \x01(\tB\x03\xe0\x41\x03\x12\x14\n\x07\x63ontent\x18\x03 \x01(\tB\x03\xe0\x41\x03\x12?\n\x08\x64ocument\x18\x04 \x01(\x0b\x32(.google.developers.knowledge.v1.DocumentB\x03\xe0\x41\x03\x12!\n\x0frelevance_score\x18\x05 \x01(\x01\x42\x03\xe0\x41\x03H\x00\x88\x01\x01\x42\x12\n\x10_relevance_score*y\n\x0c\x44ocumentView\x12\x1d\n\x19\x44OCUMENT_VIEW_UNSPECIFIED\x10\x00\x12\x17\n\x13\x44OCUMENT_VIEW_BASIC\x10\x01\x12\x16\n\x12\x44OCUMENT_VIEW_FULL\x10\x02\x12\x19\n\x15\x44OCUMENT_VIEW_CONTENT\x10\x03\x32\x81\x06\n\x12\x44\x65veloperKnowledge\x12\xbd\x01\n\x14SearchDocumentChunks\x12;.google.developers.knowledge.v1.SearchDocumentChunksRequest\x1a<.google.developers.knowledge.v1.SearchDocumentChunksResponse\"*\x82\xd3\xe4\x93\x02$\x12\"/v1/documents:searchDocumentChunks\x12\x93\x01\n\x0bGetDocument\x12\x32.google.developers.knowledge.v1.GetDocumentRequest\x1a(.google.developers.knowledge.v1.Document\"&\xda\x41\x04name\x82\xd3\xe4\x93\x02\x19\x12\x17/v1/{name=documents/**}\x12\xa8\x01\n\x11\x42\x61tchGetDocuments\x12\x38.google.developers.knowledge.v1.BatchGetDocumentsRequest\x1a\x39.google.developers.knowledge.v1.BatchGetDocumentsResponse\"\x1e\x82\xd3\xe4\x93\x02\x18\x12\x16/v1/documents:batchGet\x12\x92\x01\n\x0b\x41nswerQuery\x12\x32.google.developers.knowledge.v1.AnswerQueryRequest\x1a\x33.google.developers.knowledge.v1.AnswerQueryResponse\"\x1a\x82\xd3\xe4\x93\x02\x14\"\x0f/v1:answerQuery:\x01*\x1aU\xca\x41!developerknowledge.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x83\x02\n\"com.google.developers.knowledge.v1B\x17\x44\x65veloperKnowledgeProtoP\x01ZAcloud.google.com/go/developerknowledge/apiv1/developerknowledgepb\xaa\x02\'Google.Developers.DeveloperKnowledge.V1\xca\x02\'Google\\Developers\\DeveloperKnowledge\\V1\xea\x02*Google::Developers::DeveloperKnowledge::V1b\x06proto3"
15
15
 
16
16
  pool = ::Google::Protobuf::DescriptorPool.generated_pool
17
17
  pool.add_serialized_file(descriptor_data)
@@ -227,6 +227,53 @@ module Google
227
227
  # @!attribute [rw] query
228
228
  # @return [::String]
229
229
  # Required. The query to answer.
230
+ # @!attribute [rw] filter
231
+ # @return [::String]
232
+ # Optional. Applies a strict filter to the search results used to ground the
233
+ # answer. The expression supports a subset of the syntax described at
234
+ # https://google.aip.dev/160.
235
+ #
236
+ # Supported fields for filtering:
237
+ #
238
+ # * `content_length_bytes` (INTEGER): The length of the `Document.content`
239
+ # field in bytes.
240
+ # * `data_source` (STRING): The source of the document, e.g.
241
+ # `docs.cloud.google.com`. See
242
+ # https://developers.google.com/knowledge/reference/corpus-reference for
243
+ # the complete list of data sources in the corpus.
244
+ # * `update_time` (TIMESTAMP): The timestamp of when the document was last
245
+ # meaningfully updated. A meaningful update is one that changes document's
246
+ # markdown content or metadata.
247
+ # * `uri` (STRING): The document URI, e.g.
248
+ # `https://docs.cloud.google.com/bigquery/docs/tables`.
249
+ #
250
+ # INTEGER fields support `=`, `<`, `<=`, `>`, and `>=` operators.
251
+ #
252
+ # STRING fields support `=` (equals) and `!=` (not equals) operators for
253
+ # **exact match** on the whole string. Partial match, prefix match, and
254
+ # regexp match are not supported.
255
+ #
256
+ # TIMESTAMP fields support `=`, `<`, `<=`, `>`, and `>=` operators.
257
+ # Timestamps must be in RFC-3339 format, e.g., `"2025-01-01T00:00:00Z"`.
258
+ #
259
+ # You can combine expressions using `AND`, `OR`, and `NOT` (or `-`) logical
260
+ # operators. `OR` has higher precedence than `AND`. Use parentheses for
261
+ # explicit precedence grouping.
262
+ #
263
+ # Examples:
264
+ #
265
+ # * Filter by `Document.content_length_bytes`:
266
+ # `content_length_bytes < 50000`
267
+ # * `data_source = "docs.cloud.google.com" OR data_source =
268
+ # "firebase.google.com"`
269
+ # * `data_source != "firebase.google.com"`
270
+ # * `update_time < "2024-01-01T00:00:00Z"`
271
+ # * `update_time >= "2025-01-22T00:00:00Z" AND (data_source =
272
+ # "developer.chrome.com" OR data_source = "web.dev")`
273
+ # * `uri = "https://docs.cloud.google.com/release-notes"`
274
+ #
275
+ # The `filter` string must not exceed 500 characters; values longer than 500
276
+ # characters will result in an `INVALID_ARGUMENT` error.
230
277
  class AnswerQueryRequest
231
278
  include ::Google::Protobuf::MessageExts
232
279
  extend ::Google::Protobuf::MessageExts::ClassMethods
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-developers-developer_knowledge-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.0
4
+ version: 0.6.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC