google-cloud-dialogflow-v2 0.10.0 → 0.11.2

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.
Files changed (47) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +8 -8
  3. data/README.md +2 -2
  4. data/lib/google/cloud/dialogflow/v2/agent_services_pb.rb +39 -5
  5. data/lib/google/cloud/dialogflow/v2/agents/client.rb +96 -54
  6. data/lib/google/cloud/dialogflow/v2/agents/operations.rb +34 -25
  7. data/lib/google/cloud/dialogflow/v2/answer_record_services_pb.rb +1 -1
  8. data/lib/google/cloud/dialogflow/v2/answer_records/client.rb +37 -43
  9. data/lib/google/cloud/dialogflow/v2/audio_config_pb.rb +1 -0
  10. data/lib/google/cloud/dialogflow/v2/context_services_pb.rb +1 -1
  11. data/lib/google/cloud/dialogflow/v2/contexts/client.rb +49 -47
  12. data/lib/google/cloud/dialogflow/v2/conversation_profile_services_pb.rb +1 -1
  13. data/lib/google/cloud/dialogflow/v2/conversation_profiles/client.rb +46 -46
  14. data/lib/google/cloud/dialogflow/v2/conversation_services_pb.rb +1 -1
  15. data/lib/google/cloud/dialogflow/v2/conversations/client.rb +46 -46
  16. data/lib/google/cloud/dialogflow/v2/document_services_pb.rb +27 -10
  17. data/lib/google/cloud/dialogflow/v2/documents/client.rb +75 -56
  18. data/lib/google/cloud/dialogflow/v2/documents/operations.rb +34 -25
  19. data/lib/google/cloud/dialogflow/v2/entity_type_services_pb.rb +45 -1
  20. data/lib/google/cloud/dialogflow/v2/entity_types/client.rb +104 -51
  21. data/lib/google/cloud/dialogflow/v2/entity_types/operations.rb +34 -25
  22. data/lib/google/cloud/dialogflow/v2/environment_services_pb.rb +7 -7
  23. data/lib/google/cloud/dialogflow/v2/environments/client.rb +69 -56
  24. data/lib/google/cloud/dialogflow/v2/fulfillment_services_pb.rb +1 -1
  25. data/lib/google/cloud/dialogflow/v2/fulfillments/client.rb +37 -43
  26. data/lib/google/cloud/dialogflow/v2/intent_services_pb.rb +16 -1
  27. data/lib/google/cloud/dialogflow/v2/intents/client.rb +67 -48
  28. data/lib/google/cloud/dialogflow/v2/intents/operations.rb +34 -25
  29. data/lib/google/cloud/dialogflow/v2/knowledge_base_services_pb.rb +1 -1
  30. data/lib/google/cloud/dialogflow/v2/knowledge_bases/client.rb +46 -46
  31. data/lib/google/cloud/dialogflow/v2/participant_services_pb.rb +1 -1
  32. data/lib/google/cloud/dialogflow/v2/participants/client.rb +53 -52
  33. data/lib/google/cloud/dialogflow/v2/session_entity_type_services_pb.rb +1 -1
  34. data/lib/google/cloud/dialogflow/v2/session_entity_types/client.rb +46 -46
  35. data/lib/google/cloud/dialogflow/v2/session_pb.rb +1 -0
  36. data/lib/google/cloud/dialogflow/v2/session_services_pb.rb +1 -1
  37. data/lib/google/cloud/dialogflow/v2/sessions/client.rb +38 -47
  38. data/lib/google/cloud/dialogflow/v2/version.rb +1 -1
  39. data/lib/google/cloud/dialogflow/v2/version_services_pb.rb +1 -1
  40. data/lib/google/cloud/dialogflow/v2/versions/client.rb +51 -46
  41. data/proto_docs/google/api/field_behavior.rb +7 -1
  42. data/proto_docs/google/cloud/dialogflow/v2/environment.rb +22 -4
  43. data/proto_docs/google/cloud/dialogflow/v2/intent.rb +4 -3
  44. data/proto_docs/google/cloud/dialogflow/v2/session.rb +3 -0
  45. data/proto_docs/google/cloud/dialogflow/v2/validation_result.rb +1 -1
  46. data/proto_docs/google/cloud/dialogflow/v2/version.rb +6 -0
  47. metadata +8 -7
data/lib/google/cloud/dialogflow/v2/conversation_services_pb.rb CHANGED
@@ -27,7 +27,7 @@ module Google
27
27
  # Service for managing [Conversations][google.cloud.dialogflow.v2.Conversation].
28
28
  class Service
29
29
 
30
- include ::GRPC::GenericService
30
+ include GRPC::GenericService
31
31
 
32
32
  self.marshal_class_method = :encode
33
33
  self.unmarshal_class_method = :decode
data/lib/google/cloud/dialogflow/v2/conversations/client.rb CHANGED
@@ -41,13 +41,12 @@ module Google
41
41
  # See {::Google::Cloud::Dialogflow::V2::Conversations::Client::Configuration}
42
42
  # for a description of the configuration fields.
43
43
  #
44
- # ## Example
44
+ # @example
45
45
  #
46
- # To modify the configuration for all Conversations clients:
47
- #
48
- # ::Google::Cloud::Dialogflow::V2::Conversations::Client.configure do |config|
49
- # config.timeout = 10.0
50
- # end
46
+ # # Modify the configuration for all Conversations clients
47
+ # ::Google::Cloud::Dialogflow::V2::Conversations::Client.configure do |config|
48
+ # config.timeout = 10.0
49
+ # end
51
50
  #
52
51
  # @yield [config] Configure the Client client.
53
52
  # @yieldparam config [Client::Configuration]
@@ -67,10 +66,7 @@ module Google
67
66
 
68
67
  default_config.timeout = 60.0
69
68
  default_config.retry_policy = {
70
- initial_delay: 0.1,
71
- max_delay: 60.0,
72
- multiplier: 1.3,
73
- retry_codes: [14]
69
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
74
70
  }
75
71
 
76
72
  default_config
@@ -102,19 +98,15 @@ module Google
102
98
  ##
103
99
  # Create a new Conversations client object.
104
100
  #
105
- # ## Examples
106
- #
107
- # To create a new Conversations client with the default
108
- # configuration:
109
- #
110
- # client = ::Google::Cloud::Dialogflow::V2::Conversations::Client.new
101
+ # @example
111
102
  #
112
- # To create a new Conversations client with a custom
113
- # configuration:
103
+ # # Create a client using the default configuration
104
+ # client = ::Google::Cloud::Dialogflow::V2::Conversations::Client.new
114
105
  #
115
- # client = ::Google::Cloud::Dialogflow::V2::Conversations::Client.new do |config|
116
- # config.timeout = 10.0
117
- # end
106
+ # # Create a client using a custom configuration
107
+ # client = ::Google::Cloud::Dialogflow::V2::Conversations::Client.new do |config|
108
+ # config.timeout = 10.0
109
+ # end
118
110
  #
119
111
  # @yield [config] Configure the Conversations client.
120
112
  # @yieldparam config [Client::Configuration]
@@ -134,14 +126,13 @@ module Google
134
126
 
135
127
  # Create credentials
136
128
  credentials = @config.credentials
137
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
129
+ # Use self-signed JWT if the endpoint is unchanged from default,
138
130
  # but only if the default endpoint does not have a region prefix.
139
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
140
- @config.endpoint == Client.configure.endpoint &&
131
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
141
132
  !@config.endpoint.split(".").first.include?("-")
142
133
  credentials ||= Credentials.default scope: @config.scope,
143
134
  enable_self_signed_jwt: enable_self_signed_jwt
144
- if credentials.is_a?(String) || credentials.is_a?(Hash)
135
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
145
136
  credentials = Credentials.new credentials, scope: @config.scope
146
137
  end
147
138
  @quota_project_id = @config.quota_project
@@ -244,7 +235,9 @@ module Google
244
235
  options.apply_defaults timeout: @config.rpcs.create_conversation.timeout,
245
236
  metadata: metadata,
246
237
  retry_policy: @config.rpcs.create_conversation.retry_policy
247
- options.apply_defaults metadata: @config.metadata,
238
+
239
+ options.apply_defaults timeout: @config.timeout,
240
+ metadata: @config.metadata,
248
241
  retry_policy: @config.retry_policy
249
242
 
250
243
  @conversations_stub.call_rpc :create_conversation, request, options: options do |response, operation|
@@ -334,7 +327,9 @@ module Google
334
327
  options.apply_defaults timeout: @config.rpcs.list_conversations.timeout,
335
328
  metadata: metadata,
336
329
  retry_policy: @config.rpcs.list_conversations.retry_policy
337
- options.apply_defaults metadata: @config.metadata,
330
+
331
+ options.apply_defaults timeout: @config.timeout,
332
+ metadata: @config.metadata,
338
333
  retry_policy: @config.retry_policy
339
334
 
340
335
  @conversations_stub.call_rpc :list_conversations, request, options: options do |response, operation|
@@ -403,7 +398,9 @@ module Google
403
398
  options.apply_defaults timeout: @config.rpcs.get_conversation.timeout,
404
399
  metadata: metadata,
405
400
  retry_policy: @config.rpcs.get_conversation.retry_policy
406
- options.apply_defaults metadata: @config.metadata,
401
+
402
+ options.apply_defaults timeout: @config.timeout,
403
+ metadata: @config.metadata,
407
404
  retry_policy: @config.retry_policy
408
405
 
409
406
  @conversations_stub.call_rpc :get_conversation, request, options: options do |response, operation|
@@ -472,7 +469,9 @@ module Google
472
469
  options.apply_defaults timeout: @config.rpcs.complete_conversation.timeout,
473
470
  metadata: metadata,
474
471
  retry_policy: @config.rpcs.complete_conversation.retry_policy
475
- options.apply_defaults metadata: @config.metadata,
472
+
473
+ options.apply_defaults timeout: @config.timeout,
474
+ metadata: @config.metadata,
476
475
  retry_policy: @config.retry_policy
477
476
 
478
477
  @conversations_stub.call_rpc :complete_conversation, request, options: options do |response, operation|
@@ -558,7 +557,9 @@ module Google
558
557
  options.apply_defaults timeout: @config.rpcs.list_messages.timeout,
559
558
  metadata: metadata,
560
559
  retry_policy: @config.rpcs.list_messages.retry_policy
561
- options.apply_defaults metadata: @config.metadata,
560
+
561
+ options.apply_defaults timeout: @config.timeout,
562
+ metadata: @config.metadata,
562
563
  retry_policy: @config.retry_policy
563
564
 
564
565
  @conversations_stub.call_rpc :list_messages, request, options: options do |response, operation|
@@ -583,22 +584,21 @@ module Google
583
584
  # Configuration can be applied globally to all clients, or to a single client
584
585
  # on construction.
585
586
  #
586
- # # Examples
587
- #
588
- # To modify the global config, setting the timeout for create_conversation
589
- # to 20 seconds, and all remaining timeouts to 10 seconds:
590
- #
591
- # ::Google::Cloud::Dialogflow::V2::Conversations::Client.configure do |config|
592
- # config.timeout = 10.0
593
- # config.rpcs.create_conversation.timeout = 20.0
594
- # end
595
- #
596
- # To apply the above configuration only to a new client:
597
- #
598
- # client = ::Google::Cloud::Dialogflow::V2::Conversations::Client.new do |config|
599
- # config.timeout = 10.0
600
- # config.rpcs.create_conversation.timeout = 20.0
601
- # end
587
+ # @example
588
+ #
589
+ # # Modify the global config, setting the timeout for
590
+ # # create_conversation to 20 seconds,
591
+ # # and all remaining timeouts to 10 seconds.
592
+ # ::Google::Cloud::Dialogflow::V2::Conversations::Client.configure do |config|
593
+ # config.timeout = 10.0
594
+ # config.rpcs.create_conversation.timeout = 20.0
595
+ # end
596
+ #
597
+ # # Apply the above configuration only to a new client.
598
+ # client = ::Google::Cloud::Dialogflow::V2::Conversations::Client.new do |config|
599
+ # config.timeout = 10.0
600
+ # config.rpcs.create_conversation.timeout = 20.0
601
+ # end
602
602
  #
603
603
  # @!attribute [rw] endpoint
604
604
  # The hostname or hostname:port of the service endpoint.
data/lib/google/cloud/dialogflow/v2/document_services_pb.rb CHANGED
@@ -27,7 +27,7 @@ module Google
27
27
  # Service for managing knowledge [Documents][google.cloud.dialogflow.v2.Document].
28
28
  class Service
29
29
 
30
- include ::GRPC::GenericService
30
+ include GRPC::GenericService
31
31
 
32
32
  self.marshal_class_method = :encode
33
33
  self.unmarshal_class_method = :decode
@@ -39,29 +39,46 @@ module Google
39
39
  rpc :GetDocument, ::Google::Cloud::Dialogflow::V2::GetDocumentRequest, ::Google::Cloud::Dialogflow::V2::Document
40
40
  # Creates a new document.
41
41
  #
42
- # Operation <response: [Document][google.cloud.dialogflow.v2.Document],
43
- # metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]>
42
+ # This method is a [long-running
43
+ # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
44
+ # The returned `Operation` type has the following method-specific fields:
45
+ #
46
+ # - `metadata`: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
47
+ # - `response`: [Document][google.cloud.dialogflow.v2.Document]
44
48
  rpc :CreateDocument, ::Google::Cloud::Dialogflow::V2::CreateDocumentRequest, ::Google::Longrunning::Operation
45
49
  # Deletes the specified document.
46
50
  #
47
- # Operation <response: [google.protobuf.Empty][google.protobuf.Empty],
48
- # metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]>
51
+ # This method is a [long-running
52
+ # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
53
+ # The returned `Operation` type has the following method-specific fields:
54
+ #
55
+ # - `metadata`: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
56
+ # - `response`: An [Empty
57
+ # message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
49
58
  rpc :DeleteDocument, ::Google::Cloud::Dialogflow::V2::DeleteDocumentRequest, ::Google::Longrunning::Operation
50
59
  # Updates the specified document.
51
60
  #
52
- # Operation <response: [Document][google.cloud.dialogflow.v2.Document],
53
- # metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]>
61
+ # This method is a [long-running
62
+ # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
63
+ # The returned `Operation` type has the following method-specific fields:
64
+ #
65
+ # - `metadata`: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
66
+ # - `response`: [Document][google.cloud.dialogflow.v2.Document]
54
67
  rpc :UpdateDocument, ::Google::Cloud::Dialogflow::V2::UpdateDocumentRequest, ::Google::Longrunning::Operation
55
68
  # Reloads the specified document from its specified source, content_uri or
56
69
  # content. The previously loaded content of the document will be deleted.
57
70
  # Note: Even when the content of the document has not changed, there still
58
71
  # may be side effects because of internal implementation changes.
59
72
  #
73
+ # This method is a [long-running
74
+ # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
75
+ # The returned `Operation` type has the following method-specific fields:
76
+ #
77
+ # - `metadata`: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
78
+ # - `response`: [Document][google.cloud.dialogflow.v2.Document]
79
+ #
60
80
  # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
61
81
  # only use `projects.knowledgeBases.documents`.
62
- #
63
- # Operation <response: [Document][google.cloud.dialogflow.v2.Document],
64
- # metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]>
65
82
  rpc :ReloadDocument, ::Google::Cloud::Dialogflow::V2::ReloadDocumentRequest, ::Google::Longrunning::Operation
66
83
  end
67
84
 
data/lib/google/cloud/dialogflow/v2/documents/client.rb CHANGED
@@ -41,13 +41,12 @@ module Google
41
41
  # See {::Google::Cloud::Dialogflow::V2::Documents::Client::Configuration}
42
42
  # for a description of the configuration fields.
43
43
  #
44
- # ## Example
44
+ # @example
45
45
  #
46
- # To modify the configuration for all Documents clients:
47
- #
48
- # ::Google::Cloud::Dialogflow::V2::Documents::Client.configure do |config|
49
- # config.timeout = 10.0
50
- # end
46
+ # # Modify the configuration for all Documents clients
47
+ # ::Google::Cloud::Dialogflow::V2::Documents::Client.configure do |config|
48
+ # config.timeout = 10.0
49
+ # end
51
50
  #
52
51
  # @yield [config] Configure the Client client.
53
52
  # @yieldparam config [Client::Configuration]
@@ -67,10 +66,7 @@ module Google
67
66
 
68
67
  default_config.timeout = 60.0
69
68
  default_config.retry_policy = {
70
- initial_delay: 0.1,
71
- max_delay: 60.0,
72
- multiplier: 1.3,
73
- retry_codes: [14]
69
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
74
70
  }
75
71
 
76
72
  default_config
@@ -102,19 +98,15 @@ module Google
102
98
  ##
103
99
  # Create a new Documents client object.
104
100
  #
105
- # ## Examples
106
- #
107
- # To create a new Documents client with the default
108
- # configuration:
109
- #
110
- # client = ::Google::Cloud::Dialogflow::V2::Documents::Client.new
101
+ # @example
111
102
  #
112
- # To create a new Documents client with a custom
113
- # configuration:
103
+ # # Create a client using the default configuration
104
+ # client = ::Google::Cloud::Dialogflow::V2::Documents::Client.new
114
105
  #
115
- # client = ::Google::Cloud::Dialogflow::V2::Documents::Client.new do |config|
116
- # config.timeout = 10.0
117
- # end
106
+ # # Create a client using a custom configuration
107
+ # client = ::Google::Cloud::Dialogflow::V2::Documents::Client.new do |config|
108
+ # config.timeout = 10.0
109
+ # end
118
110
  #
119
111
  # @yield [config] Configure the Documents client.
120
112
  # @yieldparam config [Client::Configuration]
@@ -134,14 +126,13 @@ module Google
134
126
 
135
127
  # Create credentials
136
128
  credentials = @config.credentials
137
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
129
+ # Use self-signed JWT if the endpoint is unchanged from default,
138
130
  # but only if the default endpoint does not have a region prefix.
139
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
140
- @config.endpoint == Client.configure.endpoint &&
131
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
141
132
  !@config.endpoint.split(".").first.include?("-")
142
133
  credentials ||= Credentials.default scope: @config.scope,
143
134
  enable_self_signed_jwt: enable_self_signed_jwt
144
- if credentials.is_a?(String) || credentials.is_a?(Hash)
135
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
145
136
  credentials = Credentials.new credentials, scope: @config.scope
146
137
  end
147
138
  @quota_project_id = @config.quota_project
@@ -232,7 +223,9 @@ module Google
232
223
  options.apply_defaults timeout: @config.rpcs.list_documents.timeout,
233
224
  metadata: metadata,
234
225
  retry_policy: @config.rpcs.list_documents.retry_policy
235
- options.apply_defaults metadata: @config.metadata,
226
+
227
+ options.apply_defaults timeout: @config.timeout,
228
+ metadata: @config.metadata,
236
229
  retry_policy: @config.retry_policy
237
230
 
238
231
  @documents_stub.call_rpc :list_documents, request, options: options do |response, operation|
@@ -301,7 +294,9 @@ module Google
301
294
  options.apply_defaults timeout: @config.rpcs.get_document.timeout,
302
295
  metadata: metadata,
303
296
  retry_policy: @config.rpcs.get_document.retry_policy
304
- options.apply_defaults metadata: @config.metadata,
297
+
298
+ options.apply_defaults timeout: @config.timeout,
299
+ metadata: @config.metadata,
305
300
  retry_policy: @config.retry_policy
306
301
 
307
302
  @documents_stub.call_rpc :get_document, request, options: options do |response, operation|
@@ -315,8 +310,12 @@ module Google
315
310
  ##
316
311
  # Creates a new document.
317
312
  #
318
- # Operation <response: {::Google::Cloud::Dialogflow::V2::Document Document},
319
- # metadata: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}>
313
+ # This method is a [long-running
314
+ # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
315
+ # The returned `Operation` type has the following method-specific fields:
316
+ #
317
+ # - `metadata`: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
318
+ # - `response`: {::Google::Cloud::Dialogflow::V2::Document Document}
320
319
  #
321
320
  # @overload create_document(request, options = nil)
322
321
  # Pass arguments to `create_document` via a request object, either of type
@@ -374,7 +373,9 @@ module Google
374
373
  options.apply_defaults timeout: @config.rpcs.create_document.timeout,
375
374
  metadata: metadata,
376
375
  retry_policy: @config.rpcs.create_document.retry_policy
377
- options.apply_defaults metadata: @config.metadata,
376
+
377
+ options.apply_defaults timeout: @config.timeout,
378
+ metadata: @config.metadata,
378
379
  retry_policy: @config.retry_policy
379
380
 
380
381
  @documents_stub.call_rpc :create_document, request, options: options do |response, operation|
@@ -389,8 +390,13 @@ module Google
389
390
  ##
390
391
  # Deletes the specified document.
391
392
  #
392
- # Operation <response: {::Google::Protobuf::Empty google.protobuf.Empty},
393
- # metadata: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}>
393
+ # This method is a [long-running
394
+ # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
395
+ # The returned `Operation` type has the following method-specific fields:
396
+ #
397
+ # - `metadata`: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
398
+ # - `response`: An [Empty
399
+ # message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
394
400
  #
395
401
  # @overload delete_document(request, options = nil)
396
402
  # Pass arguments to `delete_document` via a request object, either of type
@@ -446,7 +452,9 @@ module Google
446
452
  options.apply_defaults timeout: @config.rpcs.delete_document.timeout,
447
453
  metadata: metadata,
448
454
  retry_policy: @config.rpcs.delete_document.retry_policy
449
- options.apply_defaults metadata: @config.metadata,
455
+
456
+ options.apply_defaults timeout: @config.timeout,
457
+ metadata: @config.metadata,
450
458
  retry_policy: @config.retry_policy
451
459
 
452
460
  @documents_stub.call_rpc :delete_document, request, options: options do |response, operation|
@@ -461,8 +469,12 @@ module Google
461
469
  ##
462
470
  # Updates the specified document.
463
471
  #
464
- # Operation <response: {::Google::Cloud::Dialogflow::V2::Document Document},
465
- # metadata: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}>
472
+ # This method is a [long-running
473
+ # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
474
+ # The returned `Operation` type has the following method-specific fields:
475
+ #
476
+ # - `metadata`: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
477
+ # - `response`: {::Google::Cloud::Dialogflow::V2::Document Document}
466
478
  #
467
479
  # @overload update_document(request, options = nil)
468
480
  # Pass arguments to `update_document` via a request object, either of type
@@ -520,7 +532,9 @@ module Google
520
532
  options.apply_defaults timeout: @config.rpcs.update_document.timeout,
521
533
  metadata: metadata,
522
534
  retry_policy: @config.rpcs.update_document.retry_policy
523
- options.apply_defaults metadata: @config.metadata,
535
+
536
+ options.apply_defaults timeout: @config.timeout,
537
+ metadata: @config.metadata,
524
538
  retry_policy: @config.retry_policy
525
539
 
526
540
  @documents_stub.call_rpc :update_document, request, options: options do |response, operation|
@@ -538,12 +552,16 @@ module Google
538
552
  # Note: Even when the content of the document has not changed, there still
539
553
  # may be side effects because of internal implementation changes.
540
554
  #
555
+ # This method is a [long-running
556
+ # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
557
+ # The returned `Operation` type has the following method-specific fields:
558
+ #
559
+ # - `metadata`: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
560
+ # - `response`: {::Google::Cloud::Dialogflow::V2::Document Document}
561
+ #
541
562
  # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
542
563
  # only use `projects.knowledgeBases.documents`.
543
564
  #
544
- # Operation <response: {::Google::Cloud::Dialogflow::V2::Document Document},
545
- # metadata: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}>
546
- #
547
565
  # @overload reload_document(request, options = nil)
548
566
  # Pass arguments to `reload_document` via a request object, either of type
549
567
  # {::Google::Cloud::Dialogflow::V2::ReloadDocumentRequest} or an equivalent Hash.
@@ -604,7 +622,9 @@ module Google
604
622
  options.apply_defaults timeout: @config.rpcs.reload_document.timeout,
605
623
  metadata: metadata,
606
624
  retry_policy: @config.rpcs.reload_document.retry_policy
607
- options.apply_defaults metadata: @config.metadata,
625
+
626
+ options.apply_defaults timeout: @config.timeout,
627
+ metadata: @config.metadata,
608
628
  retry_policy: @config.retry_policy
609
629
 
610
630
  @documents_stub.call_rpc :reload_document, request, options: options do |response, operation|
@@ -629,22 +649,21 @@ module Google
629
649
  # Configuration can be applied globally to all clients, or to a single client
630
650
  # on construction.
631
651
  #
632
- # # Examples
633
- #
634
- # To modify the global config, setting the timeout for list_documents
635
- # to 20 seconds, and all remaining timeouts to 10 seconds:
636
- #
637
- # ::Google::Cloud::Dialogflow::V2::Documents::Client.configure do |config|
638
- # config.timeout = 10.0
639
- # config.rpcs.list_documents.timeout = 20.0
640
- # end
641
- #
642
- # To apply the above configuration only to a new client:
643
- #
644
- # client = ::Google::Cloud::Dialogflow::V2::Documents::Client.new do |config|
645
- # config.timeout = 10.0
646
- # config.rpcs.list_documents.timeout = 20.0
647
- # end
652
+ # @example
653
+ #
654
+ # # Modify the global config, setting the timeout for
655
+ # # list_documents to 20 seconds,
656
+ # # and all remaining timeouts to 10 seconds.
657
+ # ::Google::Cloud::Dialogflow::V2::Documents::Client.configure do |config|
658
+ # config.timeout = 10.0
659
+ # config.rpcs.list_documents.timeout = 20.0
660
+ # end
661
+ #
662
+ # # Apply the above configuration only to a new client.
663
+ # client = ::Google::Cloud::Dialogflow::V2::Documents::Client.new do |config|
664
+ # config.timeout = 10.0
665
+ # config.rpcs.list_documents.timeout = 20.0
666
+ # end
648
667
  #
649
668
  # @!attribute [rw] endpoint
650
669
  # The hostname or hostname:port of the service endpoint.