google-developers-developer_knowledge-v1 0.2.1 → 0.3.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: ee4729b01d4e0fcdf8e649be0b2147f1eeaa90cd147b7af4427c88e38fab4ad3
4
- data.tar.gz: 103d3fbf909989b6aff8c06ec4fcad3cf836be5e2d7d1c90a7654b4d76eada82
3
+ metadata.gz: e39d28858a3725dd67dfe8d7aea0c4ce8a1dbc2aeafec5f273e1360d1bf069cc
4
+ data.tar.gz: 9702a2a00a4fd8cd8f6ccca5ef8aefa4bcd3ce2ad50ab6c13b2b4bb98b777c30
5
5
  SHA512:
6
- metadata.gz: c75b827aa790cc49f5b00cf58a5b535992f211c6fa12f91b0fe4903574d9549ac032620e29508672056b4518d4b2226e8d71fb9b1c810ba31051158735595fc8
7
- data.tar.gz: cada3ca87b2faca794a7a5583c24495c6f55baf9420547a26e7327dad1993730287ce53cabeba4003a0cdcc26b48887f85514360bd6c8579341dfbf129543e27
6
+ metadata.gz: 4eaecdd5395b3257afec673ff1240184b44010d7dee8930ca4a00cf859305b8fc8594cc03594146e16e65a41624825d7ce43065a4c84b6b5c9e8c62e23de88e9
7
+ data.tar.gz: dac4247564d53215b6fb1ed812da60f443d4f9516005bf1dd0a7fe66bd68b8f00d38f7e07efebfa69900437f97e1fa8cbd96f2ecb043dc4559311a9516bce911
@@ -212,7 +212,7 @@ module Google
212
212
  # Searches for developer knowledge across Google's developer documentation.
213
213
  # Returns {::Google::Developers::DeveloperKnowledge::V1::DocumentChunk DocumentChunk}s
214
214
  # based on the user's query. There may be many chunks from the same
215
- # {::Google::Developers::DeveloperKnowledge::V1::Document Document}. To retrieve full
215
+ # {::Google::Developers::DeveloperKnowledge::V1::Document Document}. To retrieve full
216
216
  # documents, use
217
217
  # {::Google::Developers::DeveloperKnowledge::V1::DeveloperKnowledge::Client#get_document DeveloperKnowledge.GetDocument}
218
218
  # or
@@ -239,7 +239,9 @@ module Google
239
239
  #
240
240
  # @param query [::String]
241
241
  # Required. Provides the raw query string provided by the user, such as "How
242
- # to create a Cloud Storage bucket?".
242
+ # to create a Cloud Storage bucket?". The query must not exceed 500
243
+ # characters; values longer than 500 characters will result in an
244
+ # `INVALID_ARGUMENT` error.
243
245
  # @param page_size [::Integer]
244
246
  # Optional. Specifies the maximum number of results to return. The service
245
247
  # may return fewer than this value.
@@ -260,6 +262,8 @@ module Google
260
262
  #
261
263
  # Supported fields for filtering:
262
264
  #
265
+ # * `content_length_bytes` (INTEGER): The length of the `Document.content`
266
+ # field in bytes.
263
267
  # * `data_source` (STRING): The source of the document, e.g.
264
268
  # `docs.cloud.google.com`. See
265
269
  # https://developers.google.com/knowledge/reference/corpus-reference for
@@ -270,6 +274,8 @@ module Google
270
274
  # * `uri` (STRING): The document URI, e.g.
271
275
  # `https://docs.cloud.google.com/bigquery/docs/tables`.
272
276
  #
277
+ # INTEGER fields support `=`, `<`, `<=`, `>`, and `>=` operators.
278
+ #
273
279
  # STRING fields support `=` (equals) and `!=` (not equals) operators for
274
280
  # **exact match** on the whole string. Partial match, prefix match, and
275
281
  # regexp match are not supported.
@@ -287,6 +293,8 @@ module Google
287
293
  #
288
294
  # Examples:
289
295
  #
296
+ # * Filter by `Document.content_length_bytes`:
297
+ # `content_length_bytes < 50000`
290
298
  # * `data_source = "docs.cloud.google.com" OR data_source =
291
299
  # "firebase.google.com"`
292
300
  # * `data_source != "firebase.google.com"`
@@ -382,6 +390,9 @@ module Google
382
390
  # Required. Specifies the name of the document to retrieve.
383
391
  # Format: `documents/{uri_without_scheme}`
384
392
  # Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets`
393
+ #
394
+ # The name must not exceed 500 characters; values longer than 500 characters
395
+ # will result in an `INVALID_ARGUMENT` error.
385
396
  # @param view [::Google::Developers::DeveloperKnowledge::V1::DocumentView]
386
397
  # Optional. Specifies the
387
398
  # {::Google::Developers::DeveloperKnowledge::V1::DocumentView DocumentView} of the
@@ -478,6 +489,9 @@ module Google
478
489
  #
479
490
  # Format: `documents/{uri_without_scheme}`
480
491
  # Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets`
492
+ #
493
+ # Each name must not exceed 500 characters; values longer than 500 characters
494
+ # will result in an `INVALID_ARGUMENT` error.
481
495
  # @param view [::Google::Developers::DeveloperKnowledge::V1::DocumentView]
482
496
  # Optional. Specifies the
483
497
  # {::Google::Developers::DeveloperKnowledge::V1::DocumentView DocumentView} of the
@@ -205,7 +205,7 @@ module Google
205
205
  # Searches for developer knowledge across Google's developer documentation.
206
206
  # Returns {::Google::Developers::DeveloperKnowledge::V1::DocumentChunk DocumentChunk}s
207
207
  # based on the user's query. There may be many chunks from the same
208
- # {::Google::Developers::DeveloperKnowledge::V1::Document Document}. To retrieve full
208
+ # {::Google::Developers::DeveloperKnowledge::V1::Document Document}. To retrieve full
209
209
  # documents, use
210
210
  # {::Google::Developers::DeveloperKnowledge::V1::DeveloperKnowledge::Rest::Client#get_document DeveloperKnowledge.GetDocument}
211
211
  # or
@@ -232,7 +232,9 @@ module Google
232
232
  #
233
233
  # @param query [::String]
234
234
  # Required. Provides the raw query string provided by the user, such as "How
235
- # to create a Cloud Storage bucket?".
235
+ # to create a Cloud Storage bucket?". The query must not exceed 500
236
+ # characters; values longer than 500 characters will result in an
237
+ # `INVALID_ARGUMENT` error.
236
238
  # @param page_size [::Integer]
237
239
  # Optional. Specifies the maximum number of results to return. The service
238
240
  # may return fewer than this value.
@@ -253,6 +255,8 @@ module Google
253
255
  #
254
256
  # Supported fields for filtering:
255
257
  #
258
+ # * `content_length_bytes` (INTEGER): The length of the `Document.content`
259
+ # field in bytes.
256
260
  # * `data_source` (STRING): The source of the document, e.g.
257
261
  # `docs.cloud.google.com`. See
258
262
  # https://developers.google.com/knowledge/reference/corpus-reference for
@@ -263,6 +267,8 @@ module Google
263
267
  # * `uri` (STRING): The document URI, e.g.
264
268
  # `https://docs.cloud.google.com/bigquery/docs/tables`.
265
269
  #
270
+ # INTEGER fields support `=`, `<`, `<=`, `>`, and `>=` operators.
271
+ #
266
272
  # STRING fields support `=` (equals) and `!=` (not equals) operators for
267
273
  # **exact match** on the whole string. Partial match, prefix match, and
268
274
  # regexp match are not supported.
@@ -280,6 +286,8 @@ module Google
280
286
  #
281
287
  # Examples:
282
288
  #
289
+ # * Filter by `Document.content_length_bytes`:
290
+ # `content_length_bytes < 50000`
283
291
  # * `data_source = "docs.cloud.google.com" OR data_source =
284
292
  # "firebase.google.com"`
285
293
  # * `data_source != "firebase.google.com"`
@@ -376,6 +384,9 @@ module Google
376
384
  # Required. Specifies the name of the document to retrieve.
377
385
  # Format: `documents/{uri_without_scheme}`
378
386
  # Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets`
387
+ #
388
+ # The name must not exceed 500 characters; values longer than 500 characters
389
+ # will result in an `INVALID_ARGUMENT` error.
379
390
  # @param view [::Google::Developers::DeveloperKnowledge::V1::DocumentView]
380
391
  # Optional. Specifies the
381
392
  # {::Google::Developers::DeveloperKnowledge::V1::DocumentView DocumentView} of the
@@ -465,6 +476,9 @@ module Google
465
476
  #
466
477
  # Format: `documents/{uri_without_scheme}`
467
478
  # Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets`
479
+ #
480
+ # Each name must not exceed 500 characters; values longer than 500 characters
481
+ # will result in an `INVALID_ARGUMENT` error.
468
482
  # @param view [::Google::Developers::DeveloperKnowledge::V1::DocumentView]
469
483
  # Optional. Specifies the
470
484
  # {::Google::Developers::DeveloperKnowledge::V1::DocumentView DocumentView} of the
@@ -267,7 +267,7 @@ module Google
267
267
  uri_method: :get,
268
268
  uri_template: "/v1/{name}",
269
269
  matches: [
270
- ["name", %r{^documents(?:/.*)?$}, true]
270
+ ["name", %r{^documents(?:/(?<__wildcard__>.*))?$}, true]
271
271
  ]
272
272
  )
273
273
  transcoder.transcode request_pb
@@ -21,7 +21,7 @@ module Google
21
21
  module Developers
22
22
  module DeveloperKnowledge
23
23
  module V1
24
- VERSION = "0.2.1"
24
+ VERSION = "0.3.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\"|\n\x1cSearchDocumentChunksResponse\x12>\n\x07results\x18\x01 \x03(\x0b\x32-.google.developers.knowledge.v1.DocumentChunk\x12\x1c\n\x0fnext_page_token\x18\x02 \x01(\tB\x03\xe0\x41\x01\"\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\"\xbb\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*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\x89\x02\n\"com.google.developers.knowledge.v1B\x17\x44\x65veloperKnowledgeProtoP\x01ZGgoogle.golang.org/genproto/googleapis/developers/knowledge/v1;knowledge\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\"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\"\xbb\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*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)
@@ -51,7 +51,7 @@ module Google
51
51
  # Searches for developer knowledge across Google's developer documentation.
52
52
  # Returns [DocumentChunk][google.developers.knowledge.v1.DocumentChunk]s
53
53
  # based on the user's query. There may be many chunks from the same
54
- # [Document][google.developers.knowledge.v1.Document]. To retrieve full
54
+ # [Document][google.developers.knowledge.v1.Document]. To retrieve full
55
55
  # documents, use
56
56
  # [DeveloperKnowledge.GetDocument][google.developers.knowledge.v1.DeveloperKnowledge.GetDocument]
57
57
  # or
@@ -21,7 +21,9 @@ module Google
21
21
  module Developers
22
22
  module DeveloperKnowledge
23
23
  module V1
24
- # A Document represents a piece of content from the Developer Knowledge corpus.
24
+ # A Document represents a page of documentation in the Developer Knowledge
25
+ # corpus, like the page at
26
+ # https://docs.cloud.google.com/storage/docs/creating-buckets.
25
27
  # @!attribute [rw] name
26
28
  # @return [::String]
27
29
  # Identifier. Contains the resource name of the document.
@@ -66,7 +68,9 @@ module Google
66
68
  # @!attribute [rw] query
67
69
  # @return [::String]
68
70
  # Required. Provides the raw query string provided by the user, such as "How
69
- # to create a Cloud Storage bucket?".
71
+ # to create a Cloud Storage bucket?". The query must not exceed 500
72
+ # characters; values longer than 500 characters will result in an
73
+ # `INVALID_ARGUMENT` error.
70
74
  # @!attribute [rw] page_size
71
75
  # @return [::Integer]
72
76
  # Optional. Specifies the maximum number of results to return. The service
@@ -90,6 +94,8 @@ module Google
90
94
  #
91
95
  # Supported fields for filtering:
92
96
  #
97
+ # * `content_length_bytes` (INTEGER): The length of the `Document.content`
98
+ # field in bytes.
93
99
  # * `data_source` (STRING): The source of the document, e.g.
94
100
  # `docs.cloud.google.com`. See
95
101
  # https://developers.google.com/knowledge/reference/corpus-reference for
@@ -100,6 +106,8 @@ module Google
100
106
  # * `uri` (STRING): The document URI, e.g.
101
107
  # `https://docs.cloud.google.com/bigquery/docs/tables`.
102
108
  #
109
+ # INTEGER fields support `=`, `<`, `<=`, `>`, and `>=` operators.
110
+ #
103
111
  # STRING fields support `=` (equals) and `!=` (not equals) operators for
104
112
  # **exact match** on the whole string. Partial match, prefix match, and
105
113
  # regexp match are not supported.
@@ -117,6 +125,8 @@ module Google
117
125
  #
118
126
  # Examples:
119
127
  #
128
+ # * Filter by `Document.content_length_bytes`:
129
+ # `content_length_bytes < 50000`
120
130
  # * `data_source = "docs.cloud.google.com" OR data_source =
121
131
  # "firebase.google.com"`
122
132
  # * `data_source != "firebase.google.com"`
@@ -147,8 +157,9 @@ module Google
147
157
  # to retrieve the full document content.
148
158
  # @!attribute [rw] next_page_token
149
159
  # @return [::String]
150
- # Optional. Provides a token that can be sent as `page_token` to retrieve the
151
- # next page. If this field is omitted, there are no subsequent pages.
160
+ # Provides a token that can be sent as `page_token` to retrieve the next
161
+ # page.
162
+ # If this field is omitted, there are no subsequent pages.
152
163
  class SearchDocumentChunksResponse
153
164
  include ::Google::Protobuf::MessageExts
154
165
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -161,6 +172,9 @@ module Google
161
172
  # Required. Specifies the name of the document to retrieve.
162
173
  # Format: `documents/{uri_without_scheme}`
163
174
  # Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets`
175
+ #
176
+ # The name must not exceed 500 characters; values longer than 500 characters
177
+ # will result in an `INVALID_ARGUMENT` error.
164
178
  # @!attribute [rw] view
165
179
  # @return [::Google::Developers::DeveloperKnowledge::V1::DocumentView]
166
180
  # Optional. Specifies the
@@ -183,6 +197,9 @@ module Google
183
197
  #
184
198
  # Format: `documents/{uri_without_scheme}`
185
199
  # Example: `documents/docs.cloud.google.com/storage/docs/creating-buckets`
200
+ #
201
+ # Each name must not exceed 500 characters; values longer than 500 characters
202
+ # will result in an `INVALID_ARGUMENT` error.
186
203
  # @!attribute [rw] view
187
204
  # @return [::Google::Developers::DeveloperKnowledge::V1::DocumentView]
188
205
  # Optional. Specifies the
@@ -110,14 +110,15 @@ module Google
110
110
  # ) to obtain a formatter capable of generating timestamps in this format.
111
111
  # @!attribute [rw] seconds
112
112
  # @return [::Integer]
113
- # Represents seconds of UTC time since Unix epoch
114
- # 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
115
- # 9999-12-31T23:59:59Z inclusive.
113
+ # Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must
114
+ # be between -315576000000 and 315576000000 inclusive (which corresponds to
115
+ # 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).
116
116
  # @!attribute [rw] nanos
117
117
  # @return [::Integer]
118
- # Non-negative fractions of a second at nanosecond resolution. Negative
119
- # second values with fractions must still have non-negative nanos values
120
- # that count forward in time. Must be from 0 to 999,999,999
118
+ # Non-negative fractions of a second at nanosecond resolution. This field is
119
+ # the nanosecond portion of the duration, not an alternative to seconds.
120
+ # Negative second values with fractions must still have non-negative nanos
121
+ # values that count forward in time. Must be between 0 and 999,999,999
121
122
  # inclusive.
122
123
  class Timestamp
123
124
  include ::Google::Protobuf::MessageExts
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.2.1
4
+ version: 0.3.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC