google-cloud-dialogflow-v2 0.31.0 → 0.32.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.
Files changed (75) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +72 -101
  3. data/lib/google/cloud/dialogflow/v2/agents/client.rb +33 -8
  4. data/lib/google/cloud/dialogflow/v2/agents/operations.rb +28 -6
  5. data/lib/google/cloud/dialogflow/v2/agents/rest/client.rb +35 -7
  6. data/lib/google/cloud/dialogflow/v2/agents/rest/operations.rb +33 -8
  7. data/lib/google/cloud/dialogflow/v2/agents/rest/service_stub.rb +14 -2
  8. data/lib/google/cloud/dialogflow/v2/answer_records/client.rb +32 -8
  9. data/lib/google/cloud/dialogflow/v2/answer_records/rest/client.rb +34 -7
  10. data/lib/google/cloud/dialogflow/v2/answer_records/rest/service_stub.rb +14 -2
  11. data/lib/google/cloud/dialogflow/v2/contexts/client.rb +32 -8
  12. data/lib/google/cloud/dialogflow/v2/contexts/rest/client.rb +34 -7
  13. data/lib/google/cloud/dialogflow/v2/contexts/rest/service_stub.rb +14 -2
  14. data/lib/google/cloud/dialogflow/v2/conversation_datasets/client.rb +33 -8
  15. data/lib/google/cloud/dialogflow/v2/conversation_datasets/operations.rb +28 -6
  16. data/lib/google/cloud/dialogflow/v2/conversation_datasets/rest/client.rb +35 -7
  17. data/lib/google/cloud/dialogflow/v2/conversation_datasets/rest/operations.rb +33 -8
  18. data/lib/google/cloud/dialogflow/v2/conversation_datasets/rest/service_stub.rb +14 -2
  19. data/lib/google/cloud/dialogflow/v2/conversation_models/client.rb +33 -8
  20. data/lib/google/cloud/dialogflow/v2/conversation_models/operations.rb +28 -6
  21. data/lib/google/cloud/dialogflow/v2/conversation_models/rest/client.rb +35 -7
  22. data/lib/google/cloud/dialogflow/v2/conversation_models/rest/operations.rb +33 -8
  23. data/lib/google/cloud/dialogflow/v2/conversation_models/rest/service_stub.rb +14 -2
  24. data/lib/google/cloud/dialogflow/v2/conversation_profiles/client.rb +33 -8
  25. data/lib/google/cloud/dialogflow/v2/conversation_profiles/operations.rb +28 -6
  26. data/lib/google/cloud/dialogflow/v2/conversation_profiles/rest/client.rb +35 -7
  27. data/lib/google/cloud/dialogflow/v2/conversation_profiles/rest/operations.rb +33 -8
  28. data/lib/google/cloud/dialogflow/v2/conversation_profiles/rest/service_stub.rb +14 -2
  29. data/lib/google/cloud/dialogflow/v2/conversations/client.rb +32 -8
  30. data/lib/google/cloud/dialogflow/v2/conversations/rest/client.rb +34 -7
  31. data/lib/google/cloud/dialogflow/v2/conversations/rest/service_stub.rb +14 -2
  32. data/lib/google/cloud/dialogflow/v2/documents/client.rb +33 -8
  33. data/lib/google/cloud/dialogflow/v2/documents/operations.rb +28 -6
  34. data/lib/google/cloud/dialogflow/v2/documents/rest/client.rb +35 -7
  35. data/lib/google/cloud/dialogflow/v2/documents/rest/operations.rb +33 -8
  36. data/lib/google/cloud/dialogflow/v2/documents/rest/service_stub.rb +14 -2
  37. data/lib/google/cloud/dialogflow/v2/entity_types/client.rb +33 -8
  38. data/lib/google/cloud/dialogflow/v2/entity_types/operations.rb +28 -6
  39. data/lib/google/cloud/dialogflow/v2/entity_types/rest/client.rb +35 -7
  40. data/lib/google/cloud/dialogflow/v2/entity_types/rest/operations.rb +33 -8
  41. data/lib/google/cloud/dialogflow/v2/entity_types/rest/service_stub.rb +14 -2
  42. data/lib/google/cloud/dialogflow/v2/environments/client.rb +32 -8
  43. data/lib/google/cloud/dialogflow/v2/environments/rest/client.rb +34 -7
  44. data/lib/google/cloud/dialogflow/v2/environments/rest/service_stub.rb +14 -2
  45. data/lib/google/cloud/dialogflow/v2/fulfillments/client.rb +32 -8
  46. data/lib/google/cloud/dialogflow/v2/fulfillments/rest/client.rb +34 -7
  47. data/lib/google/cloud/dialogflow/v2/fulfillments/rest/service_stub.rb +14 -2
  48. data/lib/google/cloud/dialogflow/v2/intents/client.rb +33 -8
  49. data/lib/google/cloud/dialogflow/v2/intents/operations.rb +28 -6
  50. data/lib/google/cloud/dialogflow/v2/intents/rest/client.rb +35 -7
  51. data/lib/google/cloud/dialogflow/v2/intents/rest/operations.rb +33 -8
  52. data/lib/google/cloud/dialogflow/v2/intents/rest/service_stub.rb +14 -2
  53. data/lib/google/cloud/dialogflow/v2/knowledge_bases/client.rb +32 -8
  54. data/lib/google/cloud/dialogflow/v2/knowledge_bases/rest/client.rb +34 -7
  55. data/lib/google/cloud/dialogflow/v2/knowledge_bases/rest/service_stub.rb +14 -2
  56. data/lib/google/cloud/dialogflow/v2/participants/client.rb +32 -8
  57. data/lib/google/cloud/dialogflow/v2/participants/rest/client.rb +34 -7
  58. data/lib/google/cloud/dialogflow/v2/participants/rest/service_stub.rb +14 -2
  59. data/lib/google/cloud/dialogflow/v2/session_entity_types/client.rb +32 -8
  60. data/lib/google/cloud/dialogflow/v2/session_entity_types/rest/client.rb +34 -7
  61. data/lib/google/cloud/dialogflow/v2/session_entity_types/rest/service_stub.rb +14 -2
  62. data/lib/google/cloud/dialogflow/v2/sessions/client.rb +32 -8
  63. data/lib/google/cloud/dialogflow/v2/sessions/rest/client.rb +34 -7
  64. data/lib/google/cloud/dialogflow/v2/sessions/rest/service_stub.rb +14 -2
  65. data/lib/google/cloud/dialogflow/v2/version.rb +1 -1
  66. data/lib/google/cloud/dialogflow/v2/versions/client.rb +32 -8
  67. data/lib/google/cloud/dialogflow/v2/versions/rest/client.rb +34 -7
  68. data/lib/google/cloud/dialogflow/v2/versions/rest/service_stub.rb +14 -2
  69. data/proto_docs/google/api/client.rb +1 -0
  70. data/proto_docs/google/cloud/dialogflow/v2/agent.rb +1 -0
  71. data/proto_docs/google/cloud/dialogflow/v2/answer_record.rb +1 -0
  72. data/proto_docs/google/cloud/dialogflow/v2/audio_config.rb +1 -0
  73. data/proto_docs/google/cloud/dialogflow/v2/fulfillment.rb +1 -0
  74. data/proto_docs/google/cloud/dialogflow/v2/session.rb +1 -0
  75. metadata +6 -6
@@ -33,6 +33,9 @@ module Google
33
33
  # Service for managing {::Google::Cloud::Dialogflow::V2::Fulfillment Fulfillments}.
34
34
  #
35
35
  class Client
36
+ # @private
37
+ DEFAULT_ENDPOINT_TEMPLATE = "dialogflow.$UNIVERSE_DOMAIN$"
38
+
36
39
  include Paths
37
40
 
38
41
  # @private
@@ -98,6 +101,15 @@ module Google
98
101
  @config
99
102
  end
100
103
 
104
+ ##
105
+ # The effective universe domain
106
+ #
107
+ # @return [String]
108
+ #
109
+ def universe_domain
110
+ @fulfillments_stub.universe_domain
111
+ end
112
+
101
113
  ##
102
114
  # Create a new Fulfillments REST client object.
103
115
  #
@@ -125,8 +137,9 @@ module Google
125
137
  credentials = @config.credentials
126
138
  # Use self-signed JWT if the endpoint is unchanged from default,
127
139
  # but only if the default endpoint does not have a region prefix.
128
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
129
- !@config.endpoint.split(".").first.include?("-")
140
+ enable_self_signed_jwt = @config.endpoint.nil? ||
141
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
142
+ !@config.endpoint.split(".").first.include?("-"))
130
143
  credentials ||= Credentials.default scope: @config.scope,
131
144
  enable_self_signed_jwt: enable_self_signed_jwt
132
145
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -140,10 +153,16 @@ module Google
140
153
  config.credentials = credentials
141
154
  config.quota_project = @quota_project_id
142
155
  config.endpoint = @config.endpoint
156
+ config.universe_domain = @config.universe_domain
143
157
  config.bindings_override = @config.bindings_override
144
158
  end
145
159
 
146
- @fulfillments_stub = ::Google::Cloud::Dialogflow::V2::Fulfillments::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
160
+ @fulfillments_stub = ::Google::Cloud::Dialogflow::V2::Fulfillments::Rest::ServiceStub.new(
161
+ endpoint: @config.endpoint,
162
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
163
+ universe_domain: @config.universe_domain,
164
+ credentials: credentials
165
+ )
147
166
  end
148
167
 
149
168
  ##
@@ -345,9 +364,9 @@ module Google
345
364
  # end
346
365
  #
347
366
  # @!attribute [rw] endpoint
348
- # The hostname or hostname:port of the service endpoint.
349
- # Defaults to `"dialogflow.googleapis.com"`.
350
- # @return [::String]
367
+ # A custom service endpoint, as a hostname or hostname:port. The default is
368
+ # nil, indicating to use the default endpoint in the current universe domain.
369
+ # @return [::String,nil]
351
370
  # @!attribute [rw] credentials
352
371
  # Credentials to send with calls. You may provide any of the following types:
353
372
  # * (`String`) The path to a service account key file in JSON format
@@ -384,13 +403,20 @@ module Google
384
403
  # @!attribute [rw] quota_project
385
404
  # A separate project against which to charge quota.
386
405
  # @return [::String]
406
+ # @!attribute [rw] universe_domain
407
+ # The universe domain within which to make requests. This determines the
408
+ # default endpoint URL. The default value of nil uses the environment
409
+ # universe (usually the default "googleapis.com" universe).
410
+ # @return [::String,nil]
387
411
  #
388
412
  class Configuration
389
413
  extend ::Gapic::Config
390
414
 
415
+ # @private
416
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
391
417
  DEFAULT_ENDPOINT = "dialogflow.googleapis.com"
392
418
 
393
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
419
+ config_attr :endpoint, nil, ::String, nil
394
420
  config_attr :credentials, nil do |value|
395
421
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
396
422
  allowed.any? { |klass| klass === value }
@@ -402,6 +428,7 @@ module Google
402
428
  config_attr :metadata, nil, ::Hash, nil
403
429
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
404
430
  config_attr :quota_project, nil, ::String, nil
431
+ config_attr :universe_domain, nil, ::String, nil
405
432
 
406
433
  # @private
407
434
  # Overrides for http bindings for the RPCs of this service
@@ -30,16 +30,28 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, credentials:
33
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
34
34
  # These require statements are intentionally placed here to initialize
35
35
  # the REST modules only when it's required.
36
36
  require "gapic/rest"
37
37
 
38
- @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
38
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
39
+ endpoint_template: endpoint_template,
40
+ universe_domain: universe_domain,
41
+ credentials: credentials,
39
42
  numeric_enums: true,
40
43
  raise_faraday_errors: false
41
44
  end
42
45
 
46
+ ##
47
+ # The effective universe domain
48
+ #
49
+ # @return [String]
50
+ #
51
+ def universe_domain
52
+ @client_stub.universe_domain
53
+ end
54
+
43
55
  ##
44
56
  # Baseline implementation for the get_fulfillment REST call
45
57
  #
@@ -31,6 +31,9 @@ module Google
31
31
  # Service for managing {::Google::Cloud::Dialogflow::V2::Intent Intents}.
32
32
  #
33
33
  class Client
34
+ # @private
35
+ DEFAULT_ENDPOINT_TEMPLATE = "dialogflow.$UNIVERSE_DOMAIN$"
36
+
34
37
  include Paths
35
38
 
36
39
  # @private
@@ -96,6 +99,15 @@ module Google
96
99
  @config
97
100
  end
98
101
 
102
+ ##
103
+ # The effective universe domain
104
+ #
105
+ # @return [String]
106
+ #
107
+ def universe_domain
108
+ @intents_stub.universe_domain
109
+ end
110
+
99
111
  ##
100
112
  # Create a new Intents client object.
101
113
  #
@@ -129,8 +141,9 @@ module Google
129
141
  credentials = @config.credentials
130
142
  # Use self-signed JWT if the endpoint is unchanged from default,
131
143
  # but only if the default endpoint does not have a region prefix.
132
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
133
- !@config.endpoint.split(".").first.include?("-")
144
+ enable_self_signed_jwt = @config.endpoint.nil? ||
145
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
146
+ !@config.endpoint.split(".").first.include?("-"))
134
147
  credentials ||= Credentials.default scope: @config.scope,
135
148
  enable_self_signed_jwt: enable_self_signed_jwt
136
149
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -143,18 +156,22 @@ module Google
143
156
  config.credentials = credentials
144
157
  config.quota_project = @quota_project_id
145
158
  config.endpoint = @config.endpoint
159
+ config.universe_domain = @config.universe_domain
146
160
  end
147
161
 
148
162
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
149
163
  config.credentials = credentials
150
164
  config.quota_project = @quota_project_id
151
165
  config.endpoint = @config.endpoint
166
+ config.universe_domain = @config.universe_domain
152
167
  end
153
168
 
154
169
  @intents_stub = ::Gapic::ServiceStub.new(
155
170
  ::Google::Cloud::Dialogflow::V2::Intents::Stub,
156
- credentials: credentials,
157
- endpoint: @config.endpoint,
171
+ credentials: credentials,
172
+ endpoint: @config.endpoint,
173
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
174
+ universe_domain: @config.universe_domain,
158
175
  channel_args: @config.channel_args,
159
176
  interceptors: @config.interceptors,
160
177
  channel_pool_config: @config.channel_pool
@@ -936,9 +953,9 @@ module Google
936
953
  # end
937
954
  #
938
955
  # @!attribute [rw] endpoint
939
- # The hostname or hostname:port of the service endpoint.
940
- # Defaults to `"dialogflow.googleapis.com"`.
941
- # @return [::String]
956
+ # A custom service endpoint, as a hostname or hostname:port. The default is
957
+ # nil, indicating to use the default endpoint in the current universe domain.
958
+ # @return [::String,nil]
942
959
  # @!attribute [rw] credentials
943
960
  # Credentials to send with calls. You may provide any of the following types:
944
961
  # * (`String`) The path to a service account key file in JSON format
@@ -984,13 +1001,20 @@ module Google
984
1001
  # @!attribute [rw] quota_project
985
1002
  # A separate project against which to charge quota.
986
1003
  # @return [::String]
1004
+ # @!attribute [rw] universe_domain
1005
+ # The universe domain within which to make requests. This determines the
1006
+ # default endpoint URL. The default value of nil uses the environment
1007
+ # universe (usually the default "googleapis.com" universe).
1008
+ # @return [::String,nil]
987
1009
  #
988
1010
  class Configuration
989
1011
  extend ::Gapic::Config
990
1012
 
1013
+ # @private
1014
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
991
1015
  DEFAULT_ENDPOINT = "dialogflow.googleapis.com"
992
1016
 
993
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
1017
+ config_attr :endpoint, nil, ::String, nil
994
1018
  config_attr :credentials, nil do |value|
995
1019
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
996
1020
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -1005,6 +1029,7 @@ module Google
1005
1029
  config_attr :metadata, nil, ::Hash, nil
1006
1030
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1007
1031
  config_attr :quota_project, nil, ::String, nil
1032
+ config_attr :universe_domain, nil, ::String, nil
1008
1033
 
1009
1034
  # @private
1010
1035
  def initialize parent_config = nil
@@ -26,6 +26,9 @@ module Google
26
26
  module Intents
27
27
  # Service that implements Longrunning Operations API.
28
28
  class Operations
29
+ # @private
30
+ DEFAULT_ENDPOINT_TEMPLATE = "dialogflow.$UNIVERSE_DOMAIN$"
31
+
29
32
  # @private
30
33
  attr_reader :operations_stub
31
34
 
@@ -60,6 +63,15 @@ module Google
60
63
  @config
61
64
  end
62
65
 
66
+ ##
67
+ # The effective universe domain
68
+ #
69
+ # @return [String]
70
+ #
71
+ def universe_domain
72
+ @operations_stub.universe_domain
73
+ end
74
+
63
75
  ##
64
76
  # Create a new Operations client object.
65
77
  #
@@ -90,8 +102,10 @@ module Google
90
102
 
91
103
  @operations_stub = ::Gapic::ServiceStub.new(
92
104
  ::Google::Longrunning::Operations::Stub,
93
- credentials: credentials,
94
- endpoint: @config.endpoint,
105
+ credentials: credentials,
106
+ endpoint: @config.endpoint,
107
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
108
+ universe_domain: @config.universe_domain,
95
109
  channel_args: @config.channel_args,
96
110
  interceptors: @config.interceptors,
97
111
  channel_pool_config: @config.channel_pool
@@ -613,9 +627,9 @@ module Google
613
627
  # end
614
628
  #
615
629
  # @!attribute [rw] endpoint
616
- # The hostname or hostname:port of the service endpoint.
617
- # Defaults to `"dialogflow.googleapis.com"`.
618
- # @return [::String]
630
+ # A custom service endpoint, as a hostname or hostname:port. The default is
631
+ # nil, indicating to use the default endpoint in the current universe domain.
632
+ # @return [::String,nil]
619
633
  # @!attribute [rw] credentials
620
634
  # Credentials to send with calls. You may provide any of the following types:
621
635
  # * (`String`) The path to a service account key file in JSON format
@@ -661,13 +675,20 @@ module Google
661
675
  # @!attribute [rw] quota_project
662
676
  # A separate project against which to charge quota.
663
677
  # @return [::String]
678
+ # @!attribute [rw] universe_domain
679
+ # The universe domain within which to make requests. This determines the
680
+ # default endpoint URL. The default value of nil uses the environment
681
+ # universe (usually the default "googleapis.com" universe).
682
+ # @return [::String,nil]
664
683
  #
665
684
  class Configuration
666
685
  extend ::Gapic::Config
667
686
 
687
+ # @private
688
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
668
689
  DEFAULT_ENDPOINT = "dialogflow.googleapis.com"
669
690
 
670
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
691
+ config_attr :endpoint, nil, ::String, nil
671
692
  config_attr :credentials, nil do |value|
672
693
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
673
694
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -682,6 +703,7 @@ module Google
682
703
  config_attr :metadata, nil, ::Hash, nil
683
704
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
684
705
  config_attr :quota_project, nil, ::String, nil
706
+ config_attr :universe_domain, nil, ::String, nil
685
707
 
686
708
  # @private
687
709
  def initialize parent_config = nil
@@ -33,6 +33,9 @@ module Google
33
33
  # Service for managing {::Google::Cloud::Dialogflow::V2::Intent Intents}.
34
34
  #
35
35
  class Client
36
+ # @private
37
+ DEFAULT_ENDPOINT_TEMPLATE = "dialogflow.$UNIVERSE_DOMAIN$"
38
+
36
39
  include Paths
37
40
 
38
41
  # @private
@@ -98,6 +101,15 @@ module Google
98
101
  @config
99
102
  end
100
103
 
104
+ ##
105
+ # The effective universe domain
106
+ #
107
+ # @return [String]
108
+ #
109
+ def universe_domain
110
+ @intents_stub.universe_domain
111
+ end
112
+
101
113
  ##
102
114
  # Create a new Intents REST client object.
103
115
  #
@@ -125,8 +137,9 @@ module Google
125
137
  credentials = @config.credentials
126
138
  # Use self-signed JWT if the endpoint is unchanged from default,
127
139
  # but only if the default endpoint does not have a region prefix.
128
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
129
- !@config.endpoint.split(".").first.include?("-")
140
+ enable_self_signed_jwt = @config.endpoint.nil? ||
141
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
142
+ !@config.endpoint.split(".").first.include?("-"))
130
143
  credentials ||= Credentials.default scope: @config.scope,
131
144
  enable_self_signed_jwt: enable_self_signed_jwt
132
145
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -140,16 +153,23 @@ module Google
140
153
  config.credentials = credentials
141
154
  config.quota_project = @quota_project_id
142
155
  config.endpoint = @config.endpoint
156
+ config.universe_domain = @config.universe_domain
143
157
  end
144
158
 
145
159
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
146
160
  config.credentials = credentials
147
161
  config.quota_project = @quota_project_id
148
162
  config.endpoint = @config.endpoint
163
+ config.universe_domain = @config.universe_domain
149
164
  config.bindings_override = @config.bindings_override
150
165
  end
151
166
 
152
- @intents_stub = ::Google::Cloud::Dialogflow::V2::Intents::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
167
+ @intents_stub = ::Google::Cloud::Dialogflow::V2::Intents::Rest::ServiceStub.new(
168
+ endpoint: @config.endpoint,
169
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
170
+ universe_domain: @config.universe_domain,
171
+ credentials: credentials
172
+ )
153
173
  end
154
174
 
155
175
  ##
@@ -878,9 +898,9 @@ module Google
878
898
  # end
879
899
  #
880
900
  # @!attribute [rw] endpoint
881
- # The hostname or hostname:port of the service endpoint.
882
- # Defaults to `"dialogflow.googleapis.com"`.
883
- # @return [::String]
901
+ # A custom service endpoint, as a hostname or hostname:port. The default is
902
+ # nil, indicating to use the default endpoint in the current universe domain.
903
+ # @return [::String,nil]
884
904
  # @!attribute [rw] credentials
885
905
  # Credentials to send with calls. You may provide any of the following types:
886
906
  # * (`String`) The path to a service account key file in JSON format
@@ -917,13 +937,20 @@ module Google
917
937
  # @!attribute [rw] quota_project
918
938
  # A separate project against which to charge quota.
919
939
  # @return [::String]
940
+ # @!attribute [rw] universe_domain
941
+ # The universe domain within which to make requests. This determines the
942
+ # default endpoint URL. The default value of nil uses the environment
943
+ # universe (usually the default "googleapis.com" universe).
944
+ # @return [::String,nil]
920
945
  #
921
946
  class Configuration
922
947
  extend ::Gapic::Config
923
948
 
949
+ # @private
950
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
924
951
  DEFAULT_ENDPOINT = "dialogflow.googleapis.com"
925
952
 
926
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
953
+ config_attr :endpoint, nil, ::String, nil
927
954
  config_attr :credentials, nil do |value|
928
955
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
929
956
  allowed.any? { |klass| klass === value }
@@ -935,6 +962,7 @@ module Google
935
962
  config_attr :metadata, nil, ::Hash, nil
936
963
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
937
964
  config_attr :quota_project, nil, ::String, nil
965
+ config_attr :universe_domain, nil, ::String, nil
938
966
 
939
967
  # @private
940
968
  # Overrides for http bindings for the RPCs of this service
@@ -26,6 +26,9 @@ module Google
26
26
  module Rest
27
27
  # Service that implements Longrunning Operations API.
28
28
  class Operations
29
+ # @private
30
+ DEFAULT_ENDPOINT_TEMPLATE = "dialogflow.$UNIVERSE_DOMAIN$"
31
+
29
32
  # @private
30
33
  attr_reader :operations_stub
31
34
 
@@ -60,6 +63,15 @@ module Google
60
63
  @config
61
64
  end
62
65
 
66
+ ##
67
+ # The effective universe domain
68
+ #
69
+ # @return [String]
70
+ #
71
+ def universe_domain
72
+ @operations_stub.universe_domain
73
+ end
74
+
63
75
  ##
64
76
  # Create a new Operations client object.
65
77
  #
@@ -84,8 +96,10 @@ module Google
84
96
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
85
97
 
86
98
  @operations_stub = OperationsServiceStub.new(
87
- endpoint: @config.endpoint,
88
- credentials: credentials
99
+ endpoint: @config.endpoint,
100
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
101
+ universe_domain: @config.universe_domain,
102
+ credentials: credentials
89
103
  )
90
104
 
91
105
  # Used by an LRO wrapper for some methods of this service
@@ -478,9 +492,9 @@ module Google
478
492
  # end
479
493
  #
480
494
  # @!attribute [rw] endpoint
481
- # The hostname or hostname:port of the service endpoint.
482
- # Defaults to `"dialogflow.googleapis.com"`.
483
- # @return [::String]
495
+ # A custom service endpoint, as a hostname or hostname:port. The default is
496
+ # nil, indicating to use the default endpoint in the current universe domain.
497
+ # @return [::String,nil]
484
498
  # @!attribute [rw] credentials
485
499
  # Credentials to send with calls. You may provide any of the following types:
486
500
  # * (`String`) The path to a service account key file in JSON format
@@ -517,13 +531,20 @@ module Google
517
531
  # @!attribute [rw] quota_project
518
532
  # A separate project against which to charge quota.
519
533
  # @return [::String]
534
+ # @!attribute [rw] universe_domain
535
+ # The universe domain within which to make requests. This determines the
536
+ # default endpoint URL. The default value of nil uses the environment
537
+ # universe (usually the default "googleapis.com" universe).
538
+ # @return [::String,nil]
520
539
  #
521
540
  class Configuration
522
541
  extend ::Gapic::Config
523
542
 
543
+ # @private
544
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
524
545
  DEFAULT_ENDPOINT = "dialogflow.googleapis.com"
525
546
 
526
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
547
+ config_attr :endpoint, nil, ::String, nil
527
548
  config_attr :credentials, nil do |value|
528
549
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
529
550
  allowed.any? { |klass| klass === value }
@@ -535,6 +556,7 @@ module Google
535
556
  config_attr :metadata, nil, ::Hash, nil
536
557
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
537
558
  config_attr :quota_project, nil, ::String, nil
559
+ config_attr :universe_domain, nil, ::String, nil
538
560
 
539
561
  # @private
540
562
  def initialize parent_config = nil
@@ -617,12 +639,15 @@ module Google
617
639
  # Service stub contains baseline method implementations
618
640
  # including transcoding, making the REST call, and deserialing the response.
619
641
  class OperationsServiceStub
620
- def initialize endpoint:, credentials:
642
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
621
643
  # These require statements are intentionally placed here to initialize
622
644
  # the REST modules only when it's required.
623
645
  require "gapic/rest"
624
646
 
625
- @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials
647
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
648
+ endpoint_template: endpoint_template,
649
+ universe_domain: universe_domain,
650
+ credentials: credentials
626
651
  end
627
652
 
628
653
  ##
@@ -30,16 +30,28 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, credentials:
33
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
34
34
  # These require statements are intentionally placed here to initialize
35
35
  # the REST modules only when it's required.
36
36
  require "gapic/rest"
37
37
 
38
- @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
38
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
39
+ endpoint_template: endpoint_template,
40
+ universe_domain: universe_domain,
41
+ credentials: credentials,
39
42
  numeric_enums: true,
40
43
  raise_faraday_errors: false
41
44
  end
42
45
 
46
+ ##
47
+ # The effective universe domain
48
+ #
49
+ # @return [String]
50
+ #
51
+ def universe_domain
52
+ @client_stub.universe_domain
53
+ end
54
+
43
55
  ##
44
56
  # Baseline implementation for the list_intents REST call
45
57
  #
@@ -32,6 +32,9 @@ module Google
32
32
  # {::Google::Cloud::Dialogflow::V2::KnowledgeBase KnowledgeBases}.
33
33
  #
34
34
  class Client
35
+ # @private
36
+ DEFAULT_ENDPOINT_TEMPLATE = "dialogflow.$UNIVERSE_DOMAIN$"
37
+
35
38
  include Paths
36
39
 
37
40
  # @private
@@ -97,6 +100,15 @@ module Google
97
100
  @config
98
101
  end
99
102
 
103
+ ##
104
+ # The effective universe domain
105
+ #
106
+ # @return [String]
107
+ #
108
+ def universe_domain
109
+ @knowledge_bases_stub.universe_domain
110
+ end
111
+
100
112
  ##
101
113
  # Create a new KnowledgeBases client object.
102
114
  #
@@ -130,8 +142,9 @@ module Google
130
142
  credentials = @config.credentials
131
143
  # Use self-signed JWT if the endpoint is unchanged from default,
132
144
  # but only if the default endpoint does not have a region prefix.
133
- enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
134
- !@config.endpoint.split(".").first.include?("-")
145
+ enable_self_signed_jwt = @config.endpoint.nil? ||
146
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
147
+ !@config.endpoint.split(".").first.include?("-"))
135
148
  credentials ||= Credentials.default scope: @config.scope,
136
149
  enable_self_signed_jwt: enable_self_signed_jwt
137
150
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
@@ -144,12 +157,15 @@ module Google
144
157
  config.credentials = credentials
145
158
  config.quota_project = @quota_project_id
146
159
  config.endpoint = @config.endpoint
160
+ config.universe_domain = @config.universe_domain
147
161
  end
148
162
 
149
163
  @knowledge_bases_stub = ::Gapic::ServiceStub.new(
150
164
  ::Google::Cloud::Dialogflow::V2::KnowledgeBases::Stub,
151
- credentials: credentials,
152
- endpoint: @config.endpoint,
165
+ credentials: credentials,
166
+ endpoint: @config.endpoint,
167
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
168
+ universe_domain: @config.universe_domain,
153
169
  channel_args: @config.channel_args,
154
170
  interceptors: @config.interceptors,
155
171
  channel_pool_config: @config.channel_pool
@@ -672,9 +688,9 @@ module Google
672
688
  # end
673
689
  #
674
690
  # @!attribute [rw] endpoint
675
- # The hostname or hostname:port of the service endpoint.
676
- # Defaults to `"dialogflow.googleapis.com"`.
677
- # @return [::String]
691
+ # A custom service endpoint, as a hostname or hostname:port. The default is
692
+ # nil, indicating to use the default endpoint in the current universe domain.
693
+ # @return [::String,nil]
678
694
  # @!attribute [rw] credentials
679
695
  # Credentials to send with calls. You may provide any of the following types:
680
696
  # * (`String`) The path to a service account key file in JSON format
@@ -720,13 +736,20 @@ module Google
720
736
  # @!attribute [rw] quota_project
721
737
  # A separate project against which to charge quota.
722
738
  # @return [::String]
739
+ # @!attribute [rw] universe_domain
740
+ # The universe domain within which to make requests. This determines the
741
+ # default endpoint URL. The default value of nil uses the environment
742
+ # universe (usually the default "googleapis.com" universe).
743
+ # @return [::String,nil]
723
744
  #
724
745
  class Configuration
725
746
  extend ::Gapic::Config
726
747
 
748
+ # @private
749
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
727
750
  DEFAULT_ENDPOINT = "dialogflow.googleapis.com"
728
751
 
729
- config_attr :endpoint, DEFAULT_ENDPOINT, ::String
752
+ config_attr :endpoint, nil, ::String, nil
730
753
  config_attr :credentials, nil do |value|
731
754
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
732
755
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -741,6 +764,7 @@ module Google
741
764
  config_attr :metadata, nil, ::Hash, nil
742
765
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
743
766
  config_attr :quota_project, nil, ::String, nil
767
+ config_attr :universe_domain, nil, ::String, nil
744
768
 
745
769
  # @private
746
770
  def initialize parent_config = nil