google-cloud-discovery_engine-v1 2.6.1 → 2.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/discovery_engine/v1/assistant_service/client.rb +20 -3
  3. data/lib/google/cloud/discovery_engine/v1/cmek_config_service/client.rb +20 -3
  4. data/lib/google/cloud/discovery_engine/v1/cmek_config_service/operations.rb +20 -3
  5. data/lib/google/cloud/discovery_engine/v1/completion_service/client.rb +20 -3
  6. data/lib/google/cloud/discovery_engine/v1/completion_service/operations.rb +20 -3
  7. data/lib/google/cloud/discovery_engine/v1/control_service/client.rb +20 -3
  8. data/lib/google/cloud/discovery_engine/v1/conversational_search_service/client.rb +20 -3
  9. data/lib/google/cloud/discovery_engine/v1/data_store_service/client.rb +20 -3
  10. data/lib/google/cloud/discovery_engine/v1/data_store_service/operations.rb +20 -3
  11. data/lib/google/cloud/discovery_engine/v1/document_service/client.rb +20 -3
  12. data/lib/google/cloud/discovery_engine/v1/document_service/operations.rb +20 -3
  13. data/lib/google/cloud/discovery_engine/v1/engine_service/client.rb +20 -3
  14. data/lib/google/cloud/discovery_engine/v1/engine_service/operations.rb +20 -3
  15. data/lib/google/cloud/discovery_engine/v1/grounded_generation_service/client.rb +20 -3
  16. data/lib/google/cloud/discovery_engine/v1/identity_mapping_store_service/client.rb +20 -3
  17. data/lib/google/cloud/discovery_engine/v1/identity_mapping_store_service/operations.rb +20 -3
  18. data/lib/google/cloud/discovery_engine/v1/project_service/client.rb +20 -3
  19. data/lib/google/cloud/discovery_engine/v1/project_service/operations.rb +20 -3
  20. data/lib/google/cloud/discovery_engine/v1/rank_service/client.rb +20 -3
  21. data/lib/google/cloud/discovery_engine/v1/recommendation_service/client.rb +20 -3
  22. data/lib/google/cloud/discovery_engine/v1/schema_service/client.rb +20 -3
  23. data/lib/google/cloud/discovery_engine/v1/schema_service/operations.rb +20 -3
  24. data/lib/google/cloud/discovery_engine/v1/search_service/client.rb +20 -3
  25. data/lib/google/cloud/discovery_engine/v1/search_tuning_service/client.rb +20 -3
  26. data/lib/google/cloud/discovery_engine/v1/search_tuning_service/operations.rb +20 -3
  27. data/lib/google/cloud/discovery_engine/v1/serving_config_service/client.rb +20 -3
  28. data/lib/google/cloud/discovery_engine/v1/session_service/client.rb +20 -3
  29. data/lib/google/cloud/discovery_engine/v1/site_search_engine_service/client.rb +20 -3
  30. data/lib/google/cloud/discovery_engine/v1/site_search_engine_service/operations.rb +20 -3
  31. data/lib/google/cloud/discovery_engine/v1/user_event_service/client.rb +20 -3
  32. data/lib/google/cloud/discovery_engine/v1/user_event_service/operations.rb +20 -3
  33. data/lib/google/cloud/discovery_engine/v1/user_license_service/client.rb +20 -3
  34. data/lib/google/cloud/discovery_engine/v1/user_license_service/operations.rb +20 -3
  35. data/lib/google/cloud/discovery_engine/v1/version.rb +1 -1
  36. metadata +1 -1
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a94bd80ab21530985f92aaf3a66161cb3665ea6ab507f99f88faa383a5130f16
4
- data.tar.gz: f42f1f3cd56da3b59e06ff3dec591400d27d30c48824547508c22aa832e83bd0
3
+ metadata.gz: 1cff355c07def441638d9c5d6e5828f9d3a5955ef169ada5bc2b0ccc22200fcf
4
+ data.tar.gz: ab5867d29095e36728322830de2b722fa6976b3f362b2ad35b6e6235bd431f5e
5
5
  SHA512:
6
- metadata.gz: 51135d102a02235ddb90a880e8b2bb6f6b160e4de4b77a39fbddd6e6a02f8f0285130896cdd45b89deb84240fceac27ea7a865f17001cd4542e7e4b80cea6164
7
- data.tar.gz: 1a413584a65d533e6e7e06d0f474979bd7f6d33cdd05469a37ae4d5994bd5848d23986051827a450e53f9f4cef79a4e1bacd81ba9b16b16e700bac135fe95940
6
+ metadata.gz: aba346f42718d3ef92b26c7e51a00aaf365acff82813b695320ada77565dba130a1b2805578ebb42998c2057f54d6ee8274ca1a9b8bfdd7d858f90b6992a35cb
7
+ data.tar.gz: 93c4f3116718b4c08efa1160d63f3d575a93013edc6b281e1433e4f98c3d9155f4e6f74a046da250558a669951d1964a1945790255d322dcf45e6bb42d3a622e
@@ -355,8 +355,6 @@ module Google
355
355
  # @return [::String,nil]
356
356
  # @!attribute [rw] credentials
357
357
  # Credentials to send with calls. You may provide any of the following types:
358
- # * (`String`) The path to a service account key file in JSON format
359
- # * (`Hash`) A service account key as a Hash
360
358
  # * (`Google::Auth::Credentials`) A googleauth credentials object
361
359
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
362
360
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -365,7 +363,26 @@ module Google
365
363
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
366
364
  # * (`nil`) indicating no credentials
367
365
  #
368
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
366
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
367
+ # is deprecated. Providing an unvalidated credential configuration to
368
+ # Google APIs can compromise the security of your systems and data.
369
+ #
370
+ # @example
371
+ #
372
+ # # The recommended way to provide credentials is to use the `make_creds` method
373
+ # # on the appropriate credentials class for your environment.
374
+ #
375
+ # require "googleauth"
376
+ #
377
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
378
+ # json_key_io: ::File.open("/path/to/keyfile.json")
379
+ # )
380
+ #
381
+ # client = ::Google::Cloud::DiscoveryEngine::V1::AssistantService::Client.new do |config|
382
+ # config.credentials = credentials
383
+ # end
384
+ #
385
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
369
386
  # external source for authentication to Google Cloud, you must validate it before
370
387
  # providing it to a Google API client library. Providing an unvalidated credential
371
388
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -628,8 +628,6 @@ module Google
628
628
  # @return [::String,nil]
629
629
  # @!attribute [rw] credentials
630
630
  # Credentials to send with calls. You may provide any of the following types:
631
- # * (`String`) The path to a service account key file in JSON format
632
- # * (`Hash`) A service account key as a Hash
633
631
  # * (`Google::Auth::Credentials`) A googleauth credentials object
634
632
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
635
633
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -638,7 +636,26 @@ module Google
638
636
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
639
637
  # * (`nil`) indicating no credentials
640
638
  #
641
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
639
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
640
+ # is deprecated. Providing an unvalidated credential configuration to
641
+ # Google APIs can compromise the security of your systems and data.
642
+ #
643
+ # @example
644
+ #
645
+ # # The recommended way to provide credentials is to use the `make_creds` method
646
+ # # on the appropriate credentials class for your environment.
647
+ #
648
+ # require "googleauth"
649
+ #
650
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
651
+ # json_key_io: ::File.open("/path/to/keyfile.json")
652
+ # )
653
+ #
654
+ # client = ::Google::Cloud::DiscoveryEngine::V1::CmekConfigService::Client.new do |config|
655
+ # config.credentials = credentials
656
+ # end
657
+ #
658
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
642
659
  # external source for authentication to Google Cloud, you must validate it before
643
660
  # providing it to a Google API client library. Providing an unvalidated credential
644
661
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -642,8 +642,6 @@ module Google
642
642
  # @return [::String,nil]
643
643
  # @!attribute [rw] credentials
644
644
  # Credentials to send with calls. You may provide any of the following types:
645
- # * (`String`) The path to a service account key file in JSON format
646
- # * (`Hash`) A service account key as a Hash
647
645
  # * (`Google::Auth::Credentials`) A googleauth credentials object
648
646
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
649
647
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -652,7 +650,26 @@ module Google
652
650
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
653
651
  # * (`nil`) indicating no credentials
654
652
  #
655
- # 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
656
673
  # external source for authentication to Google Cloud, you must validate it before
657
674
  # providing it to a Google API client library. Providing an unvalidated credential
658
675
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -801,8 +801,6 @@ module Google
801
801
  # @return [::String,nil]
802
802
  # @!attribute [rw] credentials
803
803
  # Credentials to send with calls. You may provide any of the following types:
804
- # * (`String`) The path to a service account key file in JSON format
805
- # * (`Hash`) A service account key as a Hash
806
804
  # * (`Google::Auth::Credentials`) A googleauth credentials object
807
805
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
808
806
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -811,7 +809,26 @@ module Google
811
809
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
812
810
  # * (`nil`) indicating no credentials
813
811
  #
814
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
812
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
813
+ # is deprecated. Providing an unvalidated credential configuration to
814
+ # Google APIs can compromise the security of your systems and data.
815
+ #
816
+ # @example
817
+ #
818
+ # # The recommended way to provide credentials is to use the `make_creds` method
819
+ # # on the appropriate credentials class for your environment.
820
+ #
821
+ # require "googleauth"
822
+ #
823
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
824
+ # json_key_io: ::File.open("/path/to/keyfile.json")
825
+ # )
826
+ #
827
+ # client = ::Google::Cloud::DiscoveryEngine::V1::CompletionService::Client.new do |config|
828
+ # config.credentials = credentials
829
+ # end
830
+ #
831
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
815
832
  # external source for authentication to Google Cloud, you must validate it before
816
833
  # providing it to a Google API client library. Providing an unvalidated credential
817
834
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -642,8 +642,6 @@ module Google
642
642
  # @return [::String,nil]
643
643
  # @!attribute [rw] credentials
644
644
  # Credentials to send with calls. You may provide any of the following types:
645
- # * (`String`) The path to a service account key file in JSON format
646
- # * (`Hash`) A service account key as a Hash
647
645
  # * (`Google::Auth::Credentials`) A googleauth credentials object
648
646
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
649
647
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -652,7 +650,26 @@ module Google
652
650
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
653
651
  # * (`nil`) indicating no credentials
654
652
  #
655
- # 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
656
673
  # external source for authentication to Google Cloud, you must validate it before
657
674
  # providing it to a Google API client library. Providing an unvalidated credential
658
675
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -723,8 +723,6 @@ module Google
723
723
  # @return [::String,nil]
724
724
  # @!attribute [rw] credentials
725
725
  # Credentials to send with calls. You may provide any of the following types:
726
- # * (`String`) The path to a service account key file in JSON format
727
- # * (`Hash`) A service account key as a Hash
728
726
  # * (`Google::Auth::Credentials`) A googleauth credentials object
729
727
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
730
728
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -733,7 +731,26 @@ module Google
733
731
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
734
732
  # * (`nil`) indicating no credentials
735
733
  #
736
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
734
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
735
+ # is deprecated. Providing an unvalidated credential configuration to
736
+ # Google APIs can compromise the security of your systems and data.
737
+ #
738
+ # @example
739
+ #
740
+ # # The recommended way to provide credentials is to use the `make_creds` method
741
+ # # on the appropriate credentials class for your environment.
742
+ #
743
+ # require "googleauth"
744
+ #
745
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
746
+ # json_key_io: ::File.open("/path/to/keyfile.json")
747
+ # )
748
+ #
749
+ # client = ::Google::Cloud::DiscoveryEngine::V1::ControlService::Client.new do |config|
750
+ # config.credentials = credentials
751
+ # end
752
+ #
753
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
737
754
  # external source for authentication to Google Cloud, you must validate it before
738
755
  # providing it to a Google API client library. Providing an unvalidated credential
739
756
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -1764,8 +1764,6 @@ module Google
1764
1764
  # @return [::String,nil]
1765
1765
  # @!attribute [rw] credentials
1766
1766
  # Credentials to send with calls. You may provide any of the following types:
1767
- # * (`String`) The path to a service account key file in JSON format
1768
- # * (`Hash`) A service account key as a Hash
1769
1767
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1770
1768
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1771
1769
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -1774,7 +1772,26 @@ module Google
1774
1772
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1775
1773
  # * (`nil`) indicating no credentials
1776
1774
  #
1777
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
1775
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
1776
+ # is deprecated. Providing an unvalidated credential configuration to
1777
+ # Google APIs can compromise the security of your systems and data.
1778
+ #
1779
+ # @example
1780
+ #
1781
+ # # The recommended way to provide credentials is to use the `make_creds` method
1782
+ # # on the appropriate credentials class for your environment.
1783
+ #
1784
+ # require "googleauth"
1785
+ #
1786
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
1787
+ # json_key_io: ::File.open("/path/to/keyfile.json")
1788
+ # )
1789
+ #
1790
+ # client = ::Google::Cloud::DiscoveryEngine::V1::ConversationalSearchService::Client.new do |config|
1791
+ # config.credentials = credentials
1792
+ # end
1793
+ #
1794
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
1778
1795
  # external source for authentication to Google Cloud, you must validate it before
1779
1796
  # providing it to a Google API client library. Providing an unvalidated credential
1780
1797
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -801,8 +801,6 @@ module Google
801
801
  # @return [::String,nil]
802
802
  # @!attribute [rw] credentials
803
803
  # Credentials to send with calls. You may provide any of the following types:
804
- # * (`String`) The path to a service account key file in JSON format
805
- # * (`Hash`) A service account key as a Hash
806
804
  # * (`Google::Auth::Credentials`) A googleauth credentials object
807
805
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
808
806
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -811,7 +809,26 @@ module Google
811
809
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
812
810
  # * (`nil`) indicating no credentials
813
811
  #
814
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
812
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
813
+ # is deprecated. Providing an unvalidated credential configuration to
814
+ # Google APIs can compromise the security of your systems and data.
815
+ #
816
+ # @example
817
+ #
818
+ # # The recommended way to provide credentials is to use the `make_creds` method
819
+ # # on the appropriate credentials class for your environment.
820
+ #
821
+ # require "googleauth"
822
+ #
823
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
824
+ # json_key_io: ::File.open("/path/to/keyfile.json")
825
+ # )
826
+ #
827
+ # client = ::Google::Cloud::DiscoveryEngine::V1::DataStoreService::Client.new do |config|
828
+ # config.credentials = credentials
829
+ # end
830
+ #
831
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
815
832
  # external source for authentication to Google Cloud, you must validate it before
816
833
  # providing it to a Google API client library. Providing an unvalidated credential
817
834
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -642,8 +642,6 @@ module Google
642
642
  # @return [::String,nil]
643
643
  # @!attribute [rw] credentials
644
644
  # Credentials to send with calls. You may provide any of the following types:
645
- # * (`String`) The path to a service account key file in JSON format
646
- # * (`Hash`) A service account key as a Hash
647
645
  # * (`Google::Auth::Credentials`) A googleauth credentials object
648
646
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
649
647
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -652,7 +650,26 @@ module Google
652
650
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
653
651
  # * (`nil`) indicating no credentials
654
652
  #
655
- # 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
656
673
  # external source for authentication to Google Cloud, you must validate it before
657
674
  # providing it to a Google API client library. Providing an unvalidated credential
658
675
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -1206,8 +1206,6 @@ module Google
1206
1206
  # @return [::String,nil]
1207
1207
  # @!attribute [rw] credentials
1208
1208
  # Credentials to send with calls. You may provide any of the following types:
1209
- # * (`String`) The path to a service account key file in JSON format
1210
- # * (`Hash`) A service account key as a Hash
1211
1209
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1212
1210
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1213
1211
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -1216,7 +1214,26 @@ module Google
1216
1214
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1217
1215
  # * (`nil`) indicating no credentials
1218
1216
  #
1219
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
1217
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
1218
+ # is deprecated. Providing an unvalidated credential configuration to
1219
+ # Google APIs can compromise the security of your systems and data.
1220
+ #
1221
+ # @example
1222
+ #
1223
+ # # The recommended way to provide credentials is to use the `make_creds` method
1224
+ # # on the appropriate credentials class for your environment.
1225
+ #
1226
+ # require "googleauth"
1227
+ #
1228
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
1229
+ # json_key_io: ::File.open("/path/to/keyfile.json")
1230
+ # )
1231
+ #
1232
+ # client = ::Google::Cloud::DiscoveryEngine::V1::DocumentService::Client.new do |config|
1233
+ # config.credentials = credentials
1234
+ # end
1235
+ #
1236
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
1220
1237
  # external source for authentication to Google Cloud, you must validate it before
1221
1238
  # providing it to a Google API client library. Providing an unvalidated credential
1222
1239
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -642,8 +642,6 @@ module Google
642
642
  # @return [::String,nil]
643
643
  # @!attribute [rw] credentials
644
644
  # Credentials to send with calls. You may provide any of the following types:
645
- # * (`String`) The path to a service account key file in JSON format
646
- # * (`Hash`) A service account key as a Hash
647
645
  # * (`Google::Auth::Credentials`) A googleauth credentials object
648
646
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
649
647
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -652,7 +650,26 @@ module Google
652
650
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
653
651
  # * (`nil`) indicating no credentials
654
652
  #
655
- # 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
656
673
  # external source for authentication to Google Cloud, you must validate it before
657
674
  # providing it to a Google API client library. Providing an unvalidated credential
658
675
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -743,8 +743,6 @@ module Google
743
743
  # @return [::String,nil]
744
744
  # @!attribute [rw] credentials
745
745
  # Credentials to send with calls. You may provide any of the following types:
746
- # * (`String`) The path to a service account key file in JSON format
747
- # * (`Hash`) A service account key as a Hash
748
746
  # * (`Google::Auth::Credentials`) A googleauth credentials object
749
747
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
750
748
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -753,7 +751,26 @@ module Google
753
751
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
754
752
  # * (`nil`) indicating no credentials
755
753
  #
756
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
754
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
755
+ # is deprecated. Providing an unvalidated credential configuration to
756
+ # Google APIs can compromise the security of your systems and data.
757
+ #
758
+ # @example
759
+ #
760
+ # # The recommended way to provide credentials is to use the `make_creds` method
761
+ # # on the appropriate credentials class for your environment.
762
+ #
763
+ # require "googleauth"
764
+ #
765
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
766
+ # json_key_io: ::File.open("/path/to/keyfile.json")
767
+ # )
768
+ #
769
+ # client = ::Google::Cloud::DiscoveryEngine::V1::EngineService::Client.new do |config|
770
+ # config.credentials = credentials
771
+ # end
772
+ #
773
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
757
774
  # external source for authentication to Google Cloud, you must validate it before
758
775
  # providing it to a Google API client library. Providing an unvalidated credential
759
776
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -642,8 +642,6 @@ module Google
642
642
  # @return [::String,nil]
643
643
  # @!attribute [rw] credentials
644
644
  # Credentials to send with calls. You may provide any of the following types:
645
- # * (`String`) The path to a service account key file in JSON format
646
- # * (`Hash`) A service account key as a Hash
647
645
  # * (`Google::Auth::Credentials`) A googleauth credentials object
648
646
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
649
647
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -652,7 +650,26 @@ module Google
652
650
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
653
651
  # * (`nil`) indicating no credentials
654
652
  #
655
- # 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
656
673
  # external source for authentication to Google Cloud, you must validate it before
657
674
  # providing it to a Google API client library. Providing an unvalidated credential
658
675
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -548,8 +548,6 @@ module Google
548
548
  # @return [::String,nil]
549
549
  # @!attribute [rw] credentials
550
550
  # Credentials to send with calls. You may provide any of the following types:
551
- # * (`String`) The path to a service account key file in JSON format
552
- # * (`Hash`) A service account key as a Hash
553
551
  # * (`Google::Auth::Credentials`) A googleauth credentials object
554
552
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
555
553
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -558,7 +556,26 @@ module Google
558
556
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
559
557
  # * (`nil`) indicating no credentials
560
558
  #
561
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
559
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
560
+ # is deprecated. Providing an unvalidated credential configuration to
561
+ # Google APIs can compromise the security of your systems and data.
562
+ #
563
+ # @example
564
+ #
565
+ # # The recommended way to provide credentials is to use the `make_creds` method
566
+ # # on the appropriate credentials class for your environment.
567
+ #
568
+ # require "googleauth"
569
+ #
570
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
571
+ # json_key_io: ::File.open("/path/to/keyfile.json")
572
+ # )
573
+ #
574
+ # client = ::Google::Cloud::DiscoveryEngine::V1::GroundedGenerationService::Client.new do |config|
575
+ # config.credentials = credentials
576
+ # end
577
+ #
578
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
562
579
  # external source for authentication to Google Cloud, you must validate it before
563
580
  # providing it to a Google API client library. Providing an unvalidated credential
564
581
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -964,8 +964,6 @@ module Google
964
964
  # @return [::String,nil]
965
965
  # @!attribute [rw] credentials
966
966
  # Credentials to send with calls. You may provide any of the following types:
967
- # * (`String`) The path to a service account key file in JSON format
968
- # * (`Hash`) A service account key as a Hash
969
967
  # * (`Google::Auth::Credentials`) A googleauth credentials object
970
968
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
971
969
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -974,7 +972,26 @@ module Google
974
972
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
975
973
  # * (`nil`) indicating no credentials
976
974
  #
977
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
975
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
976
+ # is deprecated. Providing an unvalidated credential configuration to
977
+ # Google APIs can compromise the security of your systems and data.
978
+ #
979
+ # @example
980
+ #
981
+ # # The recommended way to provide credentials is to use the `make_creds` method
982
+ # # on the appropriate credentials class for your environment.
983
+ #
984
+ # require "googleauth"
985
+ #
986
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
987
+ # json_key_io: ::File.open("/path/to/keyfile.json")
988
+ # )
989
+ #
990
+ # client = ::Google::Cloud::DiscoveryEngine::V1::IdentityMappingStoreService::Client.new do |config|
991
+ # config.credentials = credentials
992
+ # end
993
+ #
994
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
978
995
  # external source for authentication to Google Cloud, you must validate it before
979
996
  # providing it to a Google API client library. Providing an unvalidated credential
980
997
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -642,8 +642,6 @@ module Google
642
642
  # @return [::String,nil]
643
643
  # @!attribute [rw] credentials
644
644
  # Credentials to send with calls. You may provide any of the following types:
645
- # * (`String`) The path to a service account key file in JSON format
646
- # * (`Hash`) A service account key as a Hash
647
645
  # * (`Google::Auth::Credentials`) A googleauth credentials object
648
646
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
649
647
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -652,7 +650,26 @@ module Google
652
650
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
653
651
  # * (`nil`) indicating no credentials
654
652
  #
655
- # 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
656
673
  # external source for authentication to Google Cloud, you must validate it before
657
674
  # providing it to a Google API client library. Providing an unvalidated credential
658
675
  # configuration to Google APIs can compromise the security of your systems and data.