google-cloud-dialogflow-v2 1.11.0 → 1.12.1

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 (39) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/dialogflow/v2/agents/client.rb +20 -3
  3. data/lib/google/cloud/dialogflow/v2/agents/operations.rb +32 -4
  4. data/lib/google/cloud/dialogflow/v2/agents/rest/operations.rb +12 -1
  5. data/lib/google/cloud/dialogflow/v2/answer_records/client.rb +20 -3
  6. data/lib/google/cloud/dialogflow/v2/contexts/client.rb +20 -3
  7. data/lib/google/cloud/dialogflow/v2/conversation_datasets/client.rb +20 -3
  8. data/lib/google/cloud/dialogflow/v2/conversation_datasets/operations.rb +32 -4
  9. data/lib/google/cloud/dialogflow/v2/conversation_datasets/rest/operations.rb +12 -1
  10. data/lib/google/cloud/dialogflow/v2/conversation_models/client.rb +20 -3
  11. data/lib/google/cloud/dialogflow/v2/conversation_models/operations.rb +32 -4
  12. data/lib/google/cloud/dialogflow/v2/conversation_models/rest/operations.rb +12 -1
  13. data/lib/google/cloud/dialogflow/v2/conversation_profiles/client.rb +20 -3
  14. data/lib/google/cloud/dialogflow/v2/conversation_profiles/operations.rb +32 -4
  15. data/lib/google/cloud/dialogflow/v2/conversation_profiles/rest/operations.rb +12 -1
  16. data/lib/google/cloud/dialogflow/v2/conversations/client.rb +20 -3
  17. data/lib/google/cloud/dialogflow/v2/documents/client.rb +20 -3
  18. data/lib/google/cloud/dialogflow/v2/documents/operations.rb +32 -4
  19. data/lib/google/cloud/dialogflow/v2/documents/rest/operations.rb +12 -1
  20. data/lib/google/cloud/dialogflow/v2/encryption_spec_service/client.rb +20 -3
  21. data/lib/google/cloud/dialogflow/v2/encryption_spec_service/operations.rb +32 -4
  22. data/lib/google/cloud/dialogflow/v2/encryption_spec_service/rest/operations.rb +12 -1
  23. data/lib/google/cloud/dialogflow/v2/entity_types/client.rb +20 -3
  24. data/lib/google/cloud/dialogflow/v2/entity_types/operations.rb +32 -4
  25. data/lib/google/cloud/dialogflow/v2/entity_types/rest/operations.rb +12 -1
  26. data/lib/google/cloud/dialogflow/v2/environments/client.rb +20 -3
  27. data/lib/google/cloud/dialogflow/v2/fulfillments/client.rb +20 -3
  28. data/lib/google/cloud/dialogflow/v2/generators/client.rb +20 -3
  29. data/lib/google/cloud/dialogflow/v2/intents/client.rb +20 -3
  30. data/lib/google/cloud/dialogflow/v2/intents/operations.rb +32 -4
  31. data/lib/google/cloud/dialogflow/v2/intents/rest/operations.rb +12 -1
  32. data/lib/google/cloud/dialogflow/v2/knowledge_bases/client.rb +20 -3
  33. data/lib/google/cloud/dialogflow/v2/participants/client.rb +20 -3
  34. data/lib/google/cloud/dialogflow/v2/session_entity_types/client.rb +20 -3
  35. data/lib/google/cloud/dialogflow/v2/sessions/client.rb +20 -3
  36. data/lib/google/cloud/dialogflow/v2/version.rb +1 -1
  37. data/lib/google/cloud/dialogflow/v2/versions/client.rb +20 -3
  38. data/proto_docs/google/longrunning/operations.rb +18 -0
  39. metadata +1 -1
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 05c07b6d81de81c80e81ed54ea5b1e939003c71dfbf84329e35b6a2349374ce4
4
- data.tar.gz: 34ccb83e1f45d9897e795f2761b02e816dc500780ec0fb4b13e4c252b873b494
3
+ metadata.gz: 151d9f7d525fe68088a3253568acdfc36ba54d3ccc93f6a4a46e7d4c422ce795
4
+ data.tar.gz: 27aa1b3cc4abfa520fe098251e958ddd0c0ab3e512586efea8efb6222bc92f48
5
5
  SHA512:
6
- metadata.gz: 33eaf316fb8621f5d1e4cbbbd00b8a94ead95ec8321a97cdaf874a7583f4d17cd877fe9a05509cbf0705ab52d2b874db667194d775961bcfff95dec84bbcda85
7
- data.tar.gz: 1ef7c5743ab1372024fe543f7ea9214d163f10e4c35b17294fe91fd75ef1389455f94dd23aec6ae23a9e67fac5d353c2e0b65d3484cd9562bb99fc247cb6781c
6
+ metadata.gz: 793d377e58e641dd985f5f89626f45279850c69279b3dfc74f39042d6c4247f8de737d49cc5cd48a4d176a08ba70be12486111e89fd89b55d39cb2607fb1ff18
7
+ data.tar.gz: a7091855a2703ca6f3afda3e6ff380ed115601becc43a2d59efd840999d9aecdd76248c181d79c47b33f43b6f1446d018b8660e1cbbb69089ec65a0eda6c02de
@@ -1205,8 +1205,6 @@ module Google
1205
1205
  # @return [::String,nil]
1206
1206
  # @!attribute [rw] credentials
1207
1207
  # Credentials to send with calls. You may provide any of the following types:
1208
- # * (`String`) The path to a service account key file in JSON format
1209
- # * (`Hash`) A service account key as a Hash
1210
1208
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1211
1209
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1212
1210
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -1215,7 +1213,26 @@ module Google
1215
1213
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1216
1214
  # * (`nil`) indicating no credentials
1217
1215
  #
1218
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
1216
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
1217
+ # is deprecated. Providing an unvalidated credential configuration to
1218
+ # Google APIs can compromise the security of your systems and data.
1219
+ #
1220
+ # @example
1221
+ #
1222
+ # # The recommended way to provide credentials is to use the `make_creds` method
1223
+ # # on the appropriate credentials class for your environment.
1224
+ #
1225
+ # require "googleauth"
1226
+ #
1227
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
1228
+ # json_key_io: ::File.open("/path/to/keyfile.json")
1229
+ # )
1230
+ #
1231
+ # client = ::Google::Cloud::Dialogflow::V2::Agents::Client.new do |config|
1232
+ # config.credentials = credentials
1233
+ # end
1234
+ #
1235
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
1219
1236
  # external source for authentication to Google Cloud, you must validate it before
1220
1237
  # providing it to a Google API client library. Providing an unvalidated credential
1221
1238
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -134,7 +134,7 @@ module Google
134
134
  # @param options [::Gapic::CallOptions, ::Hash]
135
135
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
136
136
  #
137
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
137
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
138
138
  # Pass arguments to `list_operations` via keyword arguments. Note that at
139
139
  # least one keyword argument is required. To specify no parameters, or to keep all
140
140
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -147,6 +147,17 @@ module Google
147
147
  # The standard list page size.
148
148
  # @param page_token [::String]
149
149
  # The standard list page token.
150
+ # @param return_partial_success [::Boolean]
151
+ # When set to `true`, operations that are reachable are returned as normal,
152
+ # and those that are unreachable are returned in the
153
+ # [ListOperationsResponse.unreachable] field.
154
+ #
155
+ # This can only be `true` when reading across collections e.g. when `parent`
156
+ # is set to `"projects/example/locations/-"`.
157
+ #
158
+ # This field is not by default supported and will result in an
159
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
160
+ # service or product specific documentation.
150
161
  #
151
162
  # @yield [response, operation] Access the result along with the RPC operation
152
163
  # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]
@@ -631,8 +642,6 @@ module Google
631
642
  # @return [::String,nil]
632
643
  # @!attribute [rw] credentials
633
644
  # Credentials to send with calls. You may provide any of the following types:
634
- # * (`String`) The path to a service account key file in JSON format
635
- # * (`Hash`) A service account key as a Hash
636
645
  # * (`Google::Auth::Credentials`) A googleauth credentials object
637
646
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
638
647
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -641,7 +650,26 @@ module Google
641
650
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
642
651
  # * (`nil`) indicating no credentials
643
652
  #
644
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
653
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
654
+ # is deprecated. Providing an unvalidated credential configuration to
655
+ # Google APIs can compromise the security of your systems and data.
656
+ #
657
+ # @example
658
+ #
659
+ # # The recommended way to provide credentials is to use the `make_creds` method
660
+ # # on the appropriate credentials class for your environment.
661
+ #
662
+ # require "googleauth"
663
+ #
664
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
665
+ # json_key_io: ::File.open("/path/to/keyfile.json")
666
+ # )
667
+ #
668
+ # client = ::Google::Longrunning::Operations::Client.new do |config|
669
+ # config.credentials = credentials
670
+ # end
671
+ #
672
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
645
673
  # external source for authentication to Google Cloud, you must validate it before
646
674
  # providing it to a Google API client library. Providing an unvalidated credential
647
675
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -125,7 +125,7 @@ module Google
125
125
  # @param options [::Gapic::CallOptions, ::Hash]
126
126
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
127
127
  #
128
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
128
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
129
129
  # Pass arguments to `list_operations` via keyword arguments. Note that at
130
130
  # least one keyword argument is required. To specify no parameters, or to keep all
131
131
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -138,6 +138,17 @@ module Google
138
138
  # The standard list page size.
139
139
  # @param page_token [::String]
140
140
  # The standard list page token.
141
+ # @param return_partial_success [::Boolean]
142
+ # When set to `true`, operations that are reachable are returned as normal,
143
+ # and those that are unreachable are returned in the
144
+ # [ListOperationsResponse.unreachable] field.
145
+ #
146
+ # This can only be `true` when reading across collections e.g. when `parent`
147
+ # is set to `"projects/example/locations/-"`.
148
+ #
149
+ # This field is not by default supported and will result in an
150
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
151
+ # service or product specific documentation.
141
152
  # @yield [result, operation] Access the result along with the TransportOperation object
142
153
  # @yieldparam result [::Gapic::Operation]
143
154
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -447,8 +447,6 @@ module Google
447
447
  # @return [::String,nil]
448
448
  # @!attribute [rw] credentials
449
449
  # Credentials to send with calls. You may provide any of the following types:
450
- # * (`String`) The path to a service account key file in JSON format
451
- # * (`Hash`) A service account key as a Hash
452
450
  # * (`Google::Auth::Credentials`) A googleauth credentials object
453
451
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
454
452
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -457,7 +455,26 @@ module Google
457
455
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
458
456
  # * (`nil`) indicating no credentials
459
457
  #
460
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
458
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
459
+ # is deprecated. Providing an unvalidated credential configuration to
460
+ # Google APIs can compromise the security of your systems and data.
461
+ #
462
+ # @example
463
+ #
464
+ # # The recommended way to provide credentials is to use the `make_creds` method
465
+ # # on the appropriate credentials class for your environment.
466
+ #
467
+ # require "googleauth"
468
+ #
469
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
470
+ # json_key_io: ::File.open("/path/to/keyfile.json")
471
+ # )
472
+ #
473
+ # client = ::Google::Cloud::Dialogflow::V2::AnswerRecords::Client.new do |config|
474
+ # config.credentials = credentials
475
+ # end
476
+ #
477
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
461
478
  # external source for authentication to Google Cloud, you must validate it before
462
479
  # providing it to a Google API client library. Providing an unvalidated credential
463
480
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -791,8 +791,6 @@ module Google
791
791
  # @return [::String,nil]
792
792
  # @!attribute [rw] credentials
793
793
  # Credentials to send with calls. You may provide any of the following types:
794
- # * (`String`) The path to a service account key file in JSON format
795
- # * (`Hash`) A service account key as a Hash
796
794
  # * (`Google::Auth::Credentials`) A googleauth credentials object
797
795
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
798
796
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -801,7 +799,26 @@ module Google
801
799
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
802
800
  # * (`nil`) indicating no credentials
803
801
  #
804
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
802
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
803
+ # is deprecated. Providing an unvalidated credential configuration to
804
+ # Google APIs can compromise the security of your systems and data.
805
+ #
806
+ # @example
807
+ #
808
+ # # The recommended way to provide credentials is to use the `make_creds` method
809
+ # # on the appropriate credentials class for your environment.
810
+ #
811
+ # require "googleauth"
812
+ #
813
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
814
+ # json_key_io: ::File.open("/path/to/keyfile.json")
815
+ # )
816
+ #
817
+ # client = ::Google::Cloud::Dialogflow::V2::Contexts::Client.new do |config|
818
+ # config.credentials = credentials
819
+ # end
820
+ #
821
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
805
822
  # external source for authentication to Google Cloud, you must validate it before
806
823
  # providing it to a Google API client library. Providing an unvalidated credential
807
824
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -761,8 +761,6 @@ module Google
761
761
  # @return [::String,nil]
762
762
  # @!attribute [rw] credentials
763
763
  # Credentials to send with calls. You may provide any of the following types:
764
- # * (`String`) The path to a service account key file in JSON format
765
- # * (`Hash`) A service account key as a Hash
766
764
  # * (`Google::Auth::Credentials`) A googleauth credentials object
767
765
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
768
766
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -771,7 +769,26 @@ module Google
771
769
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
772
770
  # * (`nil`) indicating no credentials
773
771
  #
774
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
772
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
773
+ # is deprecated. Providing an unvalidated credential configuration to
774
+ # Google APIs can compromise the security of your systems and data.
775
+ #
776
+ # @example
777
+ #
778
+ # # The recommended way to provide credentials is to use the `make_creds` method
779
+ # # on the appropriate credentials class for your environment.
780
+ #
781
+ # require "googleauth"
782
+ #
783
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
784
+ # json_key_io: ::File.open("/path/to/keyfile.json")
785
+ # )
786
+ #
787
+ # client = ::Google::Cloud::Dialogflow::V2::ConversationDatasets::Client.new do |config|
788
+ # config.credentials = credentials
789
+ # end
790
+ #
791
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
775
792
  # external source for authentication to Google Cloud, you must validate it before
776
793
  # providing it to a Google API client library. Providing an unvalidated credential
777
794
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -134,7 +134,7 @@ module Google
134
134
  # @param options [::Gapic::CallOptions, ::Hash]
135
135
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
136
136
  #
137
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
137
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
138
138
  # Pass arguments to `list_operations` via keyword arguments. Note that at
139
139
  # least one keyword argument is required. To specify no parameters, or to keep all
140
140
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -147,6 +147,17 @@ module Google
147
147
  # The standard list page size.
148
148
  # @param page_token [::String]
149
149
  # The standard list page token.
150
+ # @param return_partial_success [::Boolean]
151
+ # When set to `true`, operations that are reachable are returned as normal,
152
+ # and those that are unreachable are returned in the
153
+ # [ListOperationsResponse.unreachable] field.
154
+ #
155
+ # This can only be `true` when reading across collections e.g. when `parent`
156
+ # is set to `"projects/example/locations/-"`.
157
+ #
158
+ # This field is not by default supported and will result in an
159
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
160
+ # service or product specific documentation.
150
161
  #
151
162
  # @yield [response, operation] Access the result along with the RPC operation
152
163
  # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]
@@ -631,8 +642,6 @@ module Google
631
642
  # @return [::String,nil]
632
643
  # @!attribute [rw] credentials
633
644
  # Credentials to send with calls. You may provide any of the following types:
634
- # * (`String`) The path to a service account key file in JSON format
635
- # * (`Hash`) A service account key as a Hash
636
645
  # * (`Google::Auth::Credentials`) A googleauth credentials object
637
646
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
638
647
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -641,7 +650,26 @@ module Google
641
650
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
642
651
  # * (`nil`) indicating no credentials
643
652
  #
644
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
653
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
654
+ # is deprecated. Providing an unvalidated credential configuration to
655
+ # Google APIs can compromise the security of your systems and data.
656
+ #
657
+ # @example
658
+ #
659
+ # # The recommended way to provide credentials is to use the `make_creds` method
660
+ # # on the appropriate credentials class for your environment.
661
+ #
662
+ # require "googleauth"
663
+ #
664
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
665
+ # json_key_io: ::File.open("/path/to/keyfile.json")
666
+ # )
667
+ #
668
+ # client = ::Google::Longrunning::Operations::Client.new do |config|
669
+ # config.credentials = credentials
670
+ # end
671
+ #
672
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
645
673
  # external source for authentication to Google Cloud, you must validate it before
646
674
  # providing it to a Google API client library. Providing an unvalidated credential
647
675
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -125,7 +125,7 @@ module Google
125
125
  # @param options [::Gapic::CallOptions, ::Hash]
126
126
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
127
127
  #
128
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
128
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
129
129
  # Pass arguments to `list_operations` via keyword arguments. Note that at
130
130
  # least one keyword argument is required. To specify no parameters, or to keep all
131
131
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -138,6 +138,17 @@ module Google
138
138
  # The standard list page size.
139
139
  # @param page_token [::String]
140
140
  # The standard list page token.
141
+ # @param return_partial_success [::Boolean]
142
+ # When set to `true`, operations that are reachable are returned as normal,
143
+ # and those that are unreachable are returned in the
144
+ # [ListOperationsResponse.unreachable] field.
145
+ #
146
+ # This can only be `true` when reading across collections e.g. when `parent`
147
+ # is set to `"projects/example/locations/-"`.
148
+ #
149
+ # This field is not by default supported and will result in an
150
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
151
+ # service or product specific documentation.
141
152
  # @yield [result, operation] Access the result along with the TransportOperation object
142
153
  # @yieldparam result [::Gapic::Operation]
143
154
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1142,8 +1142,6 @@ module Google
1142
1142
  # @return [::String,nil]
1143
1143
  # @!attribute [rw] credentials
1144
1144
  # Credentials to send with calls. You may provide any of the following types:
1145
- # * (`String`) The path to a service account key file in JSON format
1146
- # * (`Hash`) A service account key as a Hash
1147
1145
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1148
1146
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1149
1147
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -1152,7 +1150,26 @@ module Google
1152
1150
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1153
1151
  # * (`nil`) indicating no credentials
1154
1152
  #
1155
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
1153
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
1154
+ # is deprecated. Providing an unvalidated credential configuration to
1155
+ # Google APIs can compromise the security of your systems and data.
1156
+ #
1157
+ # @example
1158
+ #
1159
+ # # The recommended way to provide credentials is to use the `make_creds` method
1160
+ # # on the appropriate credentials class for your environment.
1161
+ #
1162
+ # require "googleauth"
1163
+ #
1164
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
1165
+ # json_key_io: ::File.open("/path/to/keyfile.json")
1166
+ # )
1167
+ #
1168
+ # client = ::Google::Cloud::Dialogflow::V2::ConversationModels::Client.new do |config|
1169
+ # config.credentials = credentials
1170
+ # end
1171
+ #
1172
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
1156
1173
  # external source for authentication to Google Cloud, you must validate it before
1157
1174
  # providing it to a Google API client library. Providing an unvalidated credential
1158
1175
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -134,7 +134,7 @@ module Google
134
134
  # @param options [::Gapic::CallOptions, ::Hash]
135
135
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
136
136
  #
137
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
137
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
138
138
  # Pass arguments to `list_operations` via keyword arguments. Note that at
139
139
  # least one keyword argument is required. To specify no parameters, or to keep all
140
140
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -147,6 +147,17 @@ module Google
147
147
  # The standard list page size.
148
148
  # @param page_token [::String]
149
149
  # The standard list page token.
150
+ # @param return_partial_success [::Boolean]
151
+ # When set to `true`, operations that are reachable are returned as normal,
152
+ # and those that are unreachable are returned in the
153
+ # [ListOperationsResponse.unreachable] field.
154
+ #
155
+ # This can only be `true` when reading across collections e.g. when `parent`
156
+ # is set to `"projects/example/locations/-"`.
157
+ #
158
+ # This field is not by default supported and will result in an
159
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
160
+ # service or product specific documentation.
150
161
  #
151
162
  # @yield [response, operation] Access the result along with the RPC operation
152
163
  # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]
@@ -631,8 +642,6 @@ module Google
631
642
  # @return [::String,nil]
632
643
  # @!attribute [rw] credentials
633
644
  # Credentials to send with calls. You may provide any of the following types:
634
- # * (`String`) The path to a service account key file in JSON format
635
- # * (`Hash`) A service account key as a Hash
636
645
  # * (`Google::Auth::Credentials`) A googleauth credentials object
637
646
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
638
647
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -641,7 +650,26 @@ module Google
641
650
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
642
651
  # * (`nil`) indicating no credentials
643
652
  #
644
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
653
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
654
+ # is deprecated. Providing an unvalidated credential configuration to
655
+ # Google APIs can compromise the security of your systems and data.
656
+ #
657
+ # @example
658
+ #
659
+ # # The recommended way to provide credentials is to use the `make_creds` method
660
+ # # on the appropriate credentials class for your environment.
661
+ #
662
+ # require "googleauth"
663
+ #
664
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
665
+ # json_key_io: ::File.open("/path/to/keyfile.json")
666
+ # )
667
+ #
668
+ # client = ::Google::Longrunning::Operations::Client.new do |config|
669
+ # config.credentials = credentials
670
+ # end
671
+ #
672
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
645
673
  # external source for authentication to Google Cloud, you must validate it before
646
674
  # providing it to a Google API client library. Providing an unvalidated credential
647
675
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -125,7 +125,7 @@ module Google
125
125
  # @param options [::Gapic::CallOptions, ::Hash]
126
126
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
127
127
  #
128
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
128
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
129
129
  # Pass arguments to `list_operations` via keyword arguments. Note that at
130
130
  # least one keyword argument is required. To specify no parameters, or to keep all
131
131
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -138,6 +138,17 @@ module Google
138
138
  # The standard list page size.
139
139
  # @param page_token [::String]
140
140
  # The standard list page token.
141
+ # @param return_partial_success [::Boolean]
142
+ # When set to `true`, operations that are reachable are returned as normal,
143
+ # and those that are unreachable are returned in the
144
+ # [ListOperationsResponse.unreachable] field.
145
+ #
146
+ # This can only be `true` when reading across collections e.g. when `parent`
147
+ # is set to `"projects/example/locations/-"`.
148
+ #
149
+ # This field is not by default supported and will result in an
150
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
151
+ # service or product specific documentation.
141
152
  # @yield [result, operation] Access the result along with the TransportOperation object
142
153
  # @yieldparam result [::Gapic::Operation]
143
154
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -943,8 +943,6 @@ module Google
943
943
  # @return [::String,nil]
944
944
  # @!attribute [rw] credentials
945
945
  # Credentials to send with calls. You may provide any of the following types:
946
- # * (`String`) The path to a service account key file in JSON format
947
- # * (`Hash`) A service account key as a Hash
948
946
  # * (`Google::Auth::Credentials`) A googleauth credentials object
949
947
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
950
948
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -953,7 +951,26 @@ module Google
953
951
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
954
952
  # * (`nil`) indicating no credentials
955
953
  #
956
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
954
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
955
+ # is deprecated. Providing an unvalidated credential configuration to
956
+ # Google APIs can compromise the security of your systems and data.
957
+ #
958
+ # @example
959
+ #
960
+ # # The recommended way to provide credentials is to use the `make_creds` method
961
+ # # on the appropriate credentials class for your environment.
962
+ #
963
+ # require "googleauth"
964
+ #
965
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
966
+ # json_key_io: ::File.open("/path/to/keyfile.json")
967
+ # )
968
+ #
969
+ # client = ::Google::Cloud::Dialogflow::V2::ConversationProfiles::Client.new do |config|
970
+ # config.credentials = credentials
971
+ # end
972
+ #
973
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
957
974
  # external source for authentication to Google Cloud, you must validate it before
958
975
  # providing it to a Google API client library. Providing an unvalidated credential
959
976
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -134,7 +134,7 @@ module Google
134
134
  # @param options [::Gapic::CallOptions, ::Hash]
135
135
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
136
136
  #
137
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
137
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
138
138
  # Pass arguments to `list_operations` via keyword arguments. Note that at
139
139
  # least one keyword argument is required. To specify no parameters, or to keep all
140
140
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -147,6 +147,17 @@ module Google
147
147
  # The standard list page size.
148
148
  # @param page_token [::String]
149
149
  # The standard list page token.
150
+ # @param return_partial_success [::Boolean]
151
+ # When set to `true`, operations that are reachable are returned as normal,
152
+ # and those that are unreachable are returned in the
153
+ # [ListOperationsResponse.unreachable] field.
154
+ #
155
+ # This can only be `true` when reading across collections e.g. when `parent`
156
+ # is set to `"projects/example/locations/-"`.
157
+ #
158
+ # This field is not by default supported and will result in an
159
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
160
+ # service or product specific documentation.
150
161
  #
151
162
  # @yield [response, operation] Access the result along with the RPC operation
152
163
  # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]
@@ -631,8 +642,6 @@ module Google
631
642
  # @return [::String,nil]
632
643
  # @!attribute [rw] credentials
633
644
  # Credentials to send with calls. You may provide any of the following types:
634
- # * (`String`) The path to a service account key file in JSON format
635
- # * (`Hash`) A service account key as a Hash
636
645
  # * (`Google::Auth::Credentials`) A googleauth credentials object
637
646
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
638
647
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -641,7 +650,26 @@ module Google
641
650
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
642
651
  # * (`nil`) indicating no credentials
643
652
  #
644
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
653
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
654
+ # is deprecated. Providing an unvalidated credential configuration to
655
+ # Google APIs can compromise the security of your systems and data.
656
+ #
657
+ # @example
658
+ #
659
+ # # The recommended way to provide credentials is to use the `make_creds` method
660
+ # # on the appropriate credentials class for your environment.
661
+ #
662
+ # require "googleauth"
663
+ #
664
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
665
+ # json_key_io: ::File.open("/path/to/keyfile.json")
666
+ # )
667
+ #
668
+ # client = ::Google::Longrunning::Operations::Client.new do |config|
669
+ # config.credentials = credentials
670
+ # end
671
+ #
672
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
645
673
  # external source for authentication to Google Cloud, you must validate it before
646
674
  # providing it to a Google API client library. Providing an unvalidated credential
647
675
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -125,7 +125,7 @@ module Google
125
125
  # @param options [::Gapic::CallOptions, ::Hash]
126
126
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
127
127
  #
128
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
128
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
129
129
  # Pass arguments to `list_operations` via keyword arguments. Note that at
130
130
  # least one keyword argument is required. To specify no parameters, or to keep all
131
131
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -138,6 +138,17 @@ module Google
138
138
  # The standard list page size.
139
139
  # @param page_token [::String]
140
140
  # The standard list page token.
141
+ # @param return_partial_success [::Boolean]
142
+ # When set to `true`, operations that are reachable are returned as normal,
143
+ # and those that are unreachable are returned in the
144
+ # [ListOperationsResponse.unreachable] field.
145
+ #
146
+ # This can only be `true` when reading across collections e.g. when `parent`
147
+ # is set to `"projects/example/locations/-"`.
148
+ #
149
+ # This field is not by default supported and will result in an
150
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
151
+ # service or product specific documentation.
141
152
  # @yield [result, operation] Access the result along with the TransportOperation object
142
153
  # @yieldparam result [::Gapic::Operation]
143
154
  # @yieldparam operation [::Gapic::Rest::TransportOperation]