google-cloud-dialogflow 1.6.0 → 1.7.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 (6) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +72 -101
  3. data/README.md +1 -1
  4. data/lib/google/cloud/dialogflow/version.rb +1 -1
  5. data/lib/google/cloud/dialogflow.rb +47 -46
  6. metadata +5 -5
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: cff5672df633ba987c10483e7682ecfcf2489a5f3485c14fcae159dadbee0fc4
4
- data.tar.gz: 6c97360e64a828937fefeed70b55b9a5d5018f858bb861f08d1cafa504c9d064
3
+ metadata.gz: bf4b53c36df7d076b5eb5a7b5091af895a9a97c016ce158769d11c97237c9625
4
+ data.tar.gz: 3afb556a0d99260dde9a66ea7354ec31270522c4c4eb55b2119bac0e1a2c8f1e
5
5
  SHA512:
6
- metadata.gz: 04dd339fc9138dd20b92c319a985ab51c81d5bd436067ac0bd636ca07b1b44e6b1a7bad42c23c173fa6d857335ebc5898f3b6e0c43e18bcad8431fcc9da7544c
7
- data.tar.gz: 51d3d13cd91dd468691bf823c80bccfc835e5ae9aac782ea3566d7c129f75432b8904b97c03d0b0649178edafdfc27b60e528e0b9cfc253a20ed414fb2025c58
6
+ metadata.gz: fb658838595955b3866dd97bee873723e168adb55bfc503ef6ea324aea240ecde6dd9406e4e287992b6c8e163faea69eaeadd0d0a610f058c5e2164a0fab11a6
7
+ data.tar.gz: 3864ebb69100d1898a8e87301aa51560c470b738ad39ff9e27e50d7c957fc2178fc8c0bb0b80f34cc2b0620cdc10ca0080512804645f390ccce7bb1240c186d1
data/AUTHENTICATION.md CHANGED
@@ -1,151 +1,122 @@
1
1
  # Authentication
2
2
 
3
- In general, the google-cloud-dialogflow library uses
4
- [Service Account](https://cloud.google.com/iam/docs/creating-managing-service-accounts)
5
- credentials to connect to Google Cloud services. When running within
6
- [Google Cloud Platform environments](#google-cloud-platform-environments) the
7
- credentials will be discovered automatically. When running on other
8
- environments, the Service Account credentials can be specified by providing the
9
- path to the
10
- [JSON keyfile](https://cloud.google.com/iam/docs/managing-service-account-keys)
11
- for the account (or the JSON itself) in
12
- [environment variables](#environment-variables). Additionally, Cloud SDK
13
- credentials can also be discovered automatically, but this is only recommended
14
- during development.
3
+ The recommended way to authenticate to the google-cloud-dialogflow library is to use
4
+ [Application Default Credentials (ADC)](https://cloud.google.com/docs/authentication/application-default-credentials).
5
+ To review all of your authentication options, see [Credentials lookup](#credential-lookup).
15
6
 
16
7
  ## Quickstart
17
8
 
18
- 1. [Create a service account and credentials](#creating-a-service-account).
19
- 2. Set the [environment variable](#environment-variables).
9
+ The following example shows how to set up authentication for a local development
10
+ environment with your user credentials.
20
11
 
21
- ```sh
22
- export DIALOGFLOW_CREDENTIALS=path/to/keyfile.json
23
- ```
24
-
25
- 3. Initialize the client.
12
+ **NOTE:** This method is _not_ recommended for running in production. User credentials
13
+ should be used only during development.
26
14
 
27
- ```ruby
28
- require "google/cloud/dialogflow"
15
+ 1. [Download and install the Google Cloud CLI](https://cloud.google.com/sdk).
16
+ 2. Set up a local ADC file with your user credentials:
29
17
 
30
- client = Google::Cloud::Dialogflow.agents
18
+ ```sh
19
+ gcloud auth application-default login
31
20
  ```
32
21
 
33
- ## Credential Lookup
34
-
35
- The google-cloud-dialogflow library aims to make authentication
36
- as simple as possible, and provides several mechanisms to configure your system
37
- without requiring **Service Account Credentials** directly in code.
38
-
39
- **Credentials** are discovered in the following order:
40
-
41
- 1. Specify credentials in method arguments
42
- 2. Specify credentials in configuration
43
- 3. Discover credentials path in environment variables
44
- 4. Discover credentials JSON in environment variables
45
- 5. Discover credentials file in the Cloud SDK's path
46
- 6. Discover GCP credentials
47
-
48
- ### Google Cloud Platform environments
22
+ 3. Write code as if already authenticated.
49
23
 
50
- When running on Google Cloud Platform (GCP), including Google Compute Engine
51
- (GCE), Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud
52
- Functions (GCF) and Cloud Run, **Credentials** are discovered automatically.
53
- Code should be written as if already authenticated.
24
+ For more information about setting up authentication for a local development environment, see
25
+ [Set up Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-dev).
54
26
 
55
- ### Environment Variables
27
+ ## Credential Lookup
56
28
 
57
- The **Credentials JSON** can be placed in environment variables instead of
58
- declaring them directly in code. Each service has its own environment variable,
59
- allowing for different service accounts to be used for different services. (See
60
- the READMEs for the individual service gems for details.) The path to the
61
- **Credentials JSON** file can be stored in the environment variable, or the
62
- **Credentials JSON** itself can be stored for environments such as Docker
63
- containers where writing files is difficult or not encouraged.
29
+ The google-cloud-dialogflow library provides several mechanisms to configure your system.
30
+ Generally, using Application Default Credentials to facilitate automatic
31
+ credentials discovery is the easist method. But if you need to explicitly specify
32
+ credentials, there are several methods available to you.
64
33
 
65
- The environment variables that google-cloud-dialogflow
66
- checks for credentials are configured on the service Credentials class (such as
67
- `::Google::Cloud::Dialogflow::V2::Agents::Credentials`):
34
+ Credentials are accepted in the following ways, in the following order or precedence:
68
35
 
69
- * `DIALOGFLOW_CREDENTIALS` - Path to JSON file, or JSON contents
70
- * `DIALOGFLOW_KEYFILE` - Path to JSON file, or JSON contents
71
- * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
- * `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
- * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
36
+ 1. Credentials specified in method arguments
37
+ 2. Credentials specified in configuration
38
+ 3. Credentials pointed to or included in environment variables
39
+ 4. Credentials found in local ADC file
40
+ 5. Credentials returned by the metadata server for the attached service account (GCP)
74
41
 
75
- ```ruby
76
- require "google/cloud/dialogflow"
77
-
78
- ENV["DIALOGFLOW_CREDENTIALS"] = "path/to/keyfile.json"
42
+ ### Configuration
79
43
 
80
- client = Google::Cloud::Dialogflow.agents
81
- ```
44
+ You can configure a path to a JSON credentials file, either for an individual client object or
45
+ globally, for all client objects. The JSON file can contain credentials created for
46
+ [workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
47
+ [workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
48
+ [service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
82
49
 
83
- ### Configuration
50
+ Note: Service account keys are a security risk if not managed correctly. You should
51
+ [choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
52
+ whenever possible.
84
53
 
85
- The path to the **Credentials JSON** file can be configured instead of storing
86
- it in an environment variable. Either on an individual client initialization:
54
+ To configure a credentials file for an individual client initialization:
87
55
 
88
56
  ```ruby
89
57
  require "google/cloud/dialogflow"
90
58
 
91
59
  client = Google::Cloud::Dialogflow.agents do |config|
92
- config.credentials = "path/to/keyfile.json"
60
+ config.credentials = "path/to/credentialfile.json"
93
61
  end
94
62
  ```
95
63
 
96
- Or globally for all clients:
64
+ To configure a credentials file globally for all clients:
97
65
 
98
66
  ```ruby
99
67
  require "google/cloud/dialogflow"
100
68
 
101
69
  Google::Cloud::Dialogflow.configure do |config|
102
- config.credentials = "path/to/keyfile.json"
70
+ config.credentials = "path/to/credentialfile.json"
103
71
  end
104
72
 
105
73
  client = Google::Cloud::Dialogflow.agents
106
74
  ```
107
75
 
108
- ### Cloud SDK
76
+ ### Environment Variables
109
77
 
110
- This option allows for an easy way to authenticate during development. If
111
- credentials are not provided in code or in environment variables, then Cloud SDK
112
- credentials are discovered.
78
+ You can also use an environment variable to provide a JSON credentials file.
79
+ The environment variable can contain a path to the credentials file or, for
80
+ environments such as Docker containers where writing files is not encouraged,
81
+ you can include the credentials file itself.
113
82
 
114
- To configure your system for this, simply:
83
+ The JSON file can contain credentials created for
84
+ [workload identity federation](https://cloud.google.com/iam/docs/workload-identity-federation),
85
+ [workforce identity federation](https://cloud.google.com/iam/docs/workforce-identity-federation), or a
86
+ [service account key](https://cloud.google.com/docs/authentication/provide-credentials-adc#local-key).
115
87
 
116
- 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
117
- 2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
118
- 3. Write code as if already authenticated.
88
+ Note: Service account keys are a security risk if not managed correctly. You should
89
+ [choose a more secure alternative to service account keys](https://cloud.google.com/docs/authentication#auth-decision-tree)
90
+ whenever possible.
91
+
92
+ The environment variables that google-cloud-dialogflow
93
+ checks for credentials are:
119
94
 
120
- **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
121
- *should* only be used during development.
95
+ * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
96
+ * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
122
97
 
123
- ## Creating a Service Account
98
+ ```ruby
99
+ require "google/cloud/dialogflow"
124
100
 
125
- Google Cloud requires **Service Account Credentials** to
126
- connect to the APIs. You will use the **JSON key file** to
127
- connect to most services with google-cloud-dialogflow.
101
+ ENV["GOOGLE_APPLICATION_CREDENTIALS"] = "path/to/credentialfile.json"
128
102
 
129
- If you are not running this client within
130
- [Google Cloud Platform environments](#google-cloud-platform-environments), you
131
- need a Google Developers service account.
103
+ client = Google::Cloud::Dialogflow.agents
104
+ ```
132
105
 
133
- 1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
134
- 2. Create a new project or click on an existing project.
135
- 3. Activate the menu in the upper left and select **APIs & Services**. From
136
- here, you will enable the APIs that your application requires.
106
+ ### Local ADC file
137
107
 
138
- *Note: You may need to enable billing in order to use these services.*
108
+ You can set up a local ADC file with your user credentials for authentication during
109
+ development. If credentials are not provided in code or in environment variables,
110
+ then the local ADC credentials are discovered.
139
111
 
140
- 4. Select **Credentials** from the side navigation.
112
+ Follow the steps in [Quickstart](#quickstart) to set up a local ADC file.
141
113
 
142
- Find the "Create credentials" drop down near the top of the page, and select
143
- "Service account" to be guided through downloading a new JSON key file.
114
+ ### Google Cloud Platform environments
144
115
 
145
- If you want to re-use an existing service account, you can easily generate a
146
- new key file. Just select the account you wish to re-use, click the pencil
147
- tool on the right side to edit the service account, select the **Keys** tab,
148
- and then select **Add Key**.
116
+ When running on Google Cloud Platform (GCP), including Google Compute Engine
117
+ (GCE), Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud
118
+ Functions (GCF) and Cloud Run, credentials are retrieved from the attached
119
+ service account automatically. Code should be written as if already authenticated.
149
120
 
150
- The key file you download will be used by this library to authenticate API
151
- requests and should be stored in a secure location.
121
+ For more information, see
122
+ [Set up ADC for Google Cloud services](https://cloud.google.com/docs/authentication/provide-credentials-adc#attached-sa).
data/README.md CHANGED
@@ -16,7 +16,7 @@ for this library, google-cloud-dialogflow, to see the convenience methods for
16
16
  constructing client objects. Reference documentation for the client objects
17
17
  themselves can be found in the client library documentation for the versioned
18
18
  client gems:
19
- [google-cloud-dialogflow-v2](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest).
19
+ [google-cloud-dialogflow-v2](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest).
20
20
 
21
21
  See also the [Product Documentation](https://cloud.google.com/dialogflow)
22
22
  for more usage information.
data/lib/google/cloud/dialogflow/version.rb CHANGED
@@ -16,7 +16,7 @@
16
16
  module Google
17
17
  module Cloud
18
18
  module Dialogflow
19
- VERSION = "1.6.0".freeze
19
+ VERSION = "1.7.0".freeze
20
20
  end
21
21
  end
22
22
  end
data/lib/google/cloud/dialogflow.rb CHANGED
@@ -29,7 +29,7 @@ require "google/cloud/config"
29
29
 
30
30
  # Set the default configuration
31
31
  ::Google::Cloud.configure.add_config! :dialogflow do |config|
32
- config.add_field! :endpoint, "dialogflow.googleapis.com", match: ::String
32
+ config.add_field! :endpoint, nil, match: ::String
33
33
  config.add_field! :credentials, nil, match: [::String, ::Hash, ::Google::Auth::Credentials]
34
34
  config.add_field! :scope, nil, match: [::Array, ::String]
35
35
  config.add_field! :lib_name, nil, match: ::String
@@ -39,6 +39,7 @@ require "google/cloud/config"
39
39
  config.add_field! :metadata, nil, match: ::Hash
40
40
  config.add_field! :retry_policy, nil, match: [::Hash, ::Proc]
41
41
  config.add_field! :quota_project, nil, match: ::String
42
+ config.add_field! :universe_domain, nil, match: ::String
42
43
  end
43
44
 
44
45
  module Google
@@ -48,7 +49,7 @@ module Google
48
49
  # Create a new client object for Agents.
49
50
  #
50
51
  # By default, this returns an instance of
51
- # [Google::Cloud::Dialogflow::V2::Agents::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/Agents/Client.html)
52
+ # [Google::Cloud::Dialogflow::V2::Agents::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-Agents-Client)
52
53
  # for a gRPC client for version V2 of the API.
53
54
  # However, you can specify a different API version by passing it in the
54
55
  # `version` parameter. If the Agents service is
@@ -82,7 +83,7 @@ module Google
82
83
  # Create a new client object for Contexts.
83
84
  #
84
85
  # By default, this returns an instance of
85
- # [Google::Cloud::Dialogflow::V2::Contexts::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/Contexts/Client.html)
86
+ # [Google::Cloud::Dialogflow::V2::Contexts::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-Contexts-Client)
86
87
  # for a gRPC client for version V2 of the API.
87
88
  # However, you can specify a different API version by passing it in the
88
89
  # `version` parameter. If the Contexts service is
@@ -116,7 +117,7 @@ module Google
116
117
  # Create a new client object for Intents.
117
118
  #
118
119
  # By default, this returns an instance of
119
- # [Google::Cloud::Dialogflow::V2::Intents::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/Intents/Client.html)
120
+ # [Google::Cloud::Dialogflow::V2::Intents::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-Intents-Client)
120
121
  # for a gRPC client for version V2 of the API.
121
122
  # However, you can specify a different API version by passing it in the
122
123
  # `version` parameter. If the Intents service is
@@ -150,7 +151,7 @@ module Google
150
151
  # Create a new client object for EntityTypes.
151
152
  #
152
153
  # By default, this returns an instance of
153
- # [Google::Cloud::Dialogflow::V2::EntityTypes::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/EntityTypes/Client.html)
154
+ # [Google::Cloud::Dialogflow::V2::EntityTypes::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-EntityTypes-Client)
154
155
  # for a gRPC client for version V2 of the API.
155
156
  # However, you can specify a different API version by passing it in the
156
157
  # `version` parameter. If the EntityTypes service is
@@ -184,7 +185,7 @@ module Google
184
185
  # Create a new client object for SessionEntityTypes.
185
186
  #
186
187
  # By default, this returns an instance of
187
- # [Google::Cloud::Dialogflow::V2::SessionEntityTypes::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/SessionEntityTypes/Client.html)
188
+ # [Google::Cloud::Dialogflow::V2::SessionEntityTypes::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-SessionEntityTypes-Client)
188
189
  # for a gRPC client for version V2 of the API.
189
190
  # However, you can specify a different API version by passing it in the
190
191
  # `version` parameter. If the SessionEntityTypes service is
@@ -219,7 +220,7 @@ module Google
219
220
  # Create a new client object for Sessions.
220
221
  #
221
222
  # By default, this returns an instance of
222
- # [Google::Cloud::Dialogflow::V2::Sessions::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/Sessions/Client.html)
223
+ # [Google::Cloud::Dialogflow::V2::Sessions::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-Sessions-Client)
223
224
  # for a gRPC client for version V2 of the API.
224
225
  # However, you can specify a different API version by passing it in the
225
226
  # `version` parameter. If the Sessions service is
@@ -256,7 +257,7 @@ module Google
256
257
  # Create a new client object for Participants.
257
258
  #
258
259
  # By default, this returns an instance of
259
- # [Google::Cloud::Dialogflow::V2::Participants::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/Participants/Client.html)
260
+ # [Google::Cloud::Dialogflow::V2::Participants::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-Participants-Client)
260
261
  # for a gRPC client for version V2 of the API.
261
262
  # However, you can specify a different API version by passing it in the
262
263
  # `version` parameter. If the Participants service is
@@ -290,7 +291,7 @@ module Google
290
291
  # Create a new client object for AnswerRecords.
291
292
  #
292
293
  # By default, this returns an instance of
293
- # [Google::Cloud::Dialogflow::V2::AnswerRecords::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/AnswerRecords/Client.html)
294
+ # [Google::Cloud::Dialogflow::V2::AnswerRecords::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-AnswerRecords-Client)
294
295
  # for a gRPC client for version V2 of the API.
295
296
  # However, you can specify a different API version by passing it in the
296
297
  # `version` parameter. If the AnswerRecords service is
@@ -322,142 +323,142 @@ module Google
322
323
  end
323
324
 
324
325
  ##
325
- # Create a new client object for Conversations.
326
+ # Create a new client object for ConversationProfiles.
326
327
  #
327
328
  # By default, this returns an instance of
328
- # [Google::Cloud::Dialogflow::V2::Conversations::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/Conversations/Client.html)
329
+ # [Google::Cloud::Dialogflow::V2::ConversationProfiles::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-ConversationProfiles-Client)
329
330
  # for a gRPC client for version V2 of the API.
330
331
  # However, you can specify a different API version by passing it in the
331
- # `version` parameter. If the Conversations service is
332
+ # `version` parameter. If the ConversationProfiles service is
332
333
  # supported by that API version, and the corresponding gem is available, the
333
334
  # appropriate versioned client will be returned.
334
335
  # You can also specify a different transport by passing `:rest` or `:grpc` in
335
336
  # the `transport` parameter.
336
337
  #
337
- # ## About Conversations
338
+ # ## About ConversationProfiles
338
339
  #
339
340
  # Service for managing
340
- # Conversations.
341
+ # ConversationProfiles.
341
342
  #
342
343
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
343
344
  # Defaults to `:v2`.
344
345
  # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
345
346
  # @return [::Object] A client object for the specified version.
346
347
  #
347
- def self.conversations version: :v2, transport: :grpc, &block
348
+ def self.conversation_profiles version: :v2, transport: :grpc, &block
348
349
  require "google/cloud/dialogflow/#{version.to_s.downcase}"
349
350
 
350
351
  package_name = Google::Cloud::Dialogflow
351
352
  .constants
352
353
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
353
354
  .first
354
- service_module = Google::Cloud::Dialogflow.const_get(package_name).const_get(:Conversations)
355
+ service_module = Google::Cloud::Dialogflow.const_get(package_name).const_get(:ConversationProfiles)
355
356
  service_module = service_module.const_get(:Rest) if transport == :rest
356
357
  service_module.const_get(:Client).new(&block)
357
358
  end
358
359
 
359
360
  ##
360
- # Create a new client object for ConversationDatasets.
361
+ # Create a new client object for Conversations.
361
362
  #
362
363
  # By default, this returns an instance of
363
- # [Google::Cloud::Dialogflow::V2::ConversationDatasets::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/ConversationDatasets/Client.html)
364
+ # [Google::Cloud::Dialogflow::V2::Conversations::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-Conversations-Client)
364
365
  # for a gRPC client for version V2 of the API.
365
366
  # However, you can specify a different API version by passing it in the
366
- # `version` parameter. If the ConversationDatasets service is
367
+ # `version` parameter. If the Conversations service is
367
368
  # supported by that API version, and the corresponding gem is available, the
368
369
  # appropriate versioned client will be returned.
369
370
  # You can also specify a different transport by passing `:rest` or `:grpc` in
370
371
  # the `transport` parameter.
371
372
  #
372
- # ## About ConversationDatasets
373
- #
374
- # Conversation datasets.
373
+ # ## About Conversations
375
374
  #
376
- # Conversation datasets contain raw conversation files and their
377
- # customizable metadata that can be used for model training.
375
+ # Service for managing
376
+ # Conversations.
378
377
  #
379
378
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
380
379
  # Defaults to `:v2`.
381
380
  # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
382
381
  # @return [::Object] A client object for the specified version.
383
382
  #
384
- def self.conversation_datasets version: :v2, transport: :grpc, &block
383
+ def self.conversations version: :v2, transport: :grpc, &block
385
384
  require "google/cloud/dialogflow/#{version.to_s.downcase}"
386
385
 
387
386
  package_name = Google::Cloud::Dialogflow
388
387
  .constants
389
388
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
390
389
  .first
391
- service_module = Google::Cloud::Dialogflow.const_get(package_name).const_get(:ConversationDatasets)
390
+ service_module = Google::Cloud::Dialogflow.const_get(package_name).const_get(:Conversations)
392
391
  service_module = service_module.const_get(:Rest) if transport == :rest
393
392
  service_module.const_get(:Client).new(&block)
394
393
  end
395
394
 
396
395
  ##
397
- # Create a new client object for ConversationModels.
396
+ # Create a new client object for ConversationDatasets.
398
397
  #
399
398
  # By default, this returns an instance of
400
- # [Google::Cloud::Dialogflow::V2::ConversationModels::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/ConversationModels/Client.html)
399
+ # [Google::Cloud::Dialogflow::V2::ConversationDatasets::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-ConversationDatasets-Client)
401
400
  # for a gRPC client for version V2 of the API.
402
401
  # However, you can specify a different API version by passing it in the
403
- # `version` parameter. If the ConversationModels service is
402
+ # `version` parameter. If the ConversationDatasets service is
404
403
  # supported by that API version, and the corresponding gem is available, the
405
404
  # appropriate versioned client will be returned.
406
405
  # You can also specify a different transport by passing `:rest` or `:grpc` in
407
406
  # the `transport` parameter.
408
407
  #
409
- # ## About ConversationModels
408
+ # ## About ConversationDatasets
410
409
  #
411
- # Manages a collection of models for human agent assistant.
410
+ # Conversation datasets.
411
+ #
412
+ # Conversation datasets contain raw conversation files and their
413
+ # customizable metadata that can be used for model training.
412
414
  #
413
415
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
414
416
  # Defaults to `:v2`.
415
417
  # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
416
418
  # @return [::Object] A client object for the specified version.
417
419
  #
418
- def self.conversation_models version: :v2, transport: :grpc, &block
420
+ def self.conversation_datasets version: :v2, transport: :grpc, &block
419
421
  require "google/cloud/dialogflow/#{version.to_s.downcase}"
420
422
 
421
423
  package_name = Google::Cloud::Dialogflow
422
424
  .constants
423
425
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
424
426
  .first
425
- service_module = Google::Cloud::Dialogflow.const_get(package_name).const_get(:ConversationModels)
427
+ service_module = Google::Cloud::Dialogflow.const_get(package_name).const_get(:ConversationDatasets)
426
428
  service_module = service_module.const_get(:Rest) if transport == :rest
427
429
  service_module.const_get(:Client).new(&block)
428
430
  end
429
431
 
430
432
  ##
431
- # Create a new client object for ConversationProfiles.
433
+ # Create a new client object for ConversationModels.
432
434
  #
433
435
  # By default, this returns an instance of
434
- # [Google::Cloud::Dialogflow::V2::ConversationProfiles::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/ConversationProfiles/Client.html)
436
+ # [Google::Cloud::Dialogflow::V2::ConversationModels::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-ConversationModels-Client)
435
437
  # for a gRPC client for version V2 of the API.
436
438
  # However, you can specify a different API version by passing it in the
437
- # `version` parameter. If the ConversationProfiles service is
439
+ # `version` parameter. If the ConversationModels service is
438
440
  # supported by that API version, and the corresponding gem is available, the
439
441
  # appropriate versioned client will be returned.
440
442
  # You can also specify a different transport by passing `:rest` or `:grpc` in
441
443
  # the `transport` parameter.
442
444
  #
443
- # ## About ConversationProfiles
445
+ # ## About ConversationModels
444
446
  #
445
- # Service for managing
446
- # ConversationProfiles.
447
+ # Manages a collection of models for human agent assistant.
447
448
  #
448
449
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
449
450
  # Defaults to `:v2`.
450
451
  # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
451
452
  # @return [::Object] A client object for the specified version.
452
453
  #
453
- def self.conversation_profiles version: :v2, transport: :grpc, &block
454
+ def self.conversation_models version: :v2, transport: :grpc, &block
454
455
  require "google/cloud/dialogflow/#{version.to_s.downcase}"
455
456
 
456
457
  package_name = Google::Cloud::Dialogflow
457
458
  .constants
458
459
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
459
460
  .first
460
- service_module = Google::Cloud::Dialogflow.const_get(package_name).const_get(:ConversationProfiles)
461
+ service_module = Google::Cloud::Dialogflow.const_get(package_name).const_get(:ConversationModels)
461
462
  service_module = service_module.const_get(:Rest) if transport == :rest
462
463
  service_module.const_get(:Client).new(&block)
463
464
  end
@@ -466,7 +467,7 @@ module Google
466
467
  # Create a new client object for Documents.
467
468
  #
468
469
  # By default, this returns an instance of
469
- # [Google::Cloud::Dialogflow::V2::Documents::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/Documents/Client.html)
470
+ # [Google::Cloud::Dialogflow::V2::Documents::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-Documents-Client)
470
471
  # for a gRPC client for version V2 of the API.
471
472
  # However, you can specify a different API version by passing it in the
472
473
  # `version` parameter. If the Documents service is
@@ -501,7 +502,7 @@ module Google
501
502
  # Create a new client object for Fulfillments.
502
503
  #
503
504
  # By default, this returns an instance of
504
- # [Google::Cloud::Dialogflow::V2::Fulfillments::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/Fulfillments/Client.html)
505
+ # [Google::Cloud::Dialogflow::V2::Fulfillments::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-Fulfillments-Client)
505
506
  # for a gRPC client for version V2 of the API.
506
507
  # However, you can specify a different API version by passing it in the
507
508
  # `version` parameter. If the Fulfillments service is
@@ -535,7 +536,7 @@ module Google
535
536
  # Create a new client object for Environments.
536
537
  #
537
538
  # By default, this returns an instance of
538
- # [Google::Cloud::Dialogflow::V2::Environments::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/Environments/Client.html)
539
+ # [Google::Cloud::Dialogflow::V2::Environments::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-Environments-Client)
539
540
  # for a gRPC client for version V2 of the API.
540
541
  # However, you can specify a different API version by passing it in the
541
542
  # `version` parameter. If the Environments service is
@@ -569,7 +570,7 @@ module Google
569
570
  # Create a new client object for KnowledgeBases.
570
571
  #
571
572
  # By default, this returns an instance of
572
- # [Google::Cloud::Dialogflow::V2::KnowledgeBases::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/KnowledgeBases/Client.html)
573
+ # [Google::Cloud::Dialogflow::V2::KnowledgeBases::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-KnowledgeBases-Client)
573
574
  # for a gRPC client for version V2 of the API.
574
575
  # However, you can specify a different API version by passing it in the
575
576
  # `version` parameter. If the KnowledgeBases service is
@@ -604,7 +605,7 @@ module Google
604
605
  # Create a new client object for Versions.
605
606
  #
606
607
  # By default, this returns an instance of
607
- # [Google::Cloud::Dialogflow::V2::Versions::Client](https://googleapis.dev/ruby/google-cloud-dialogflow-v2/latest/Google/Cloud/Dialogflow/V2/Versions/Client.html)
608
+ # [Google::Cloud::Dialogflow::V2::Versions::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-dialogflow-v2/latest/Google-Cloud-Dialogflow-V2-Versions-Client)
608
609
  # for a gRPC client for version V2 of the API.
609
610
  # However, you can specify a different API version by passing it in the
610
611
  # `version` parameter. If the Versions service is
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-dialogflow
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.6.0
4
+ version: 1.7.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-03-09 00:00:00.000000000 Z
11
+ date: 2024-01-15 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-cloud-core
@@ -30,7 +30,7 @@ dependencies:
30
30
  requirements:
31
31
  - - ">="
32
32
  - !ruby/object:Gem::Version
33
- version: '0.23'
33
+ version: '0.32'
34
34
  - - "<"
35
35
  - !ruby/object:Gem::Version
36
36
  version: 2.a
@@ -40,7 +40,7 @@ dependencies:
40
40
  requirements:
41
41
  - - ">="
42
42
  - !ruby/object:Gem::Version
43
- version: '0.23'
43
+ version: '0.32'
44
44
  - - "<"
45
45
  - !ruby/object:Gem::Version
46
46
  version: 2.a
@@ -194,7 +194,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
194
194
  - !ruby/object:Gem::Version
195
195
  version: '0'
196
196
  requirements: []
197
- rubygems_version: 3.4.2
197
+ rubygems_version: 3.5.3
198
198
  signing_key:
199
199
  specification_version: 4
200
200
  summary: API Client library for the Dialogflow API