google-cloud-iot-v1 0.7.1 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e8f967a178d0aa1ab9085fd46d29f1a4b088d8032128e84c01e630b9f31f9cd9
-  data.tar.gz: d76e1201370252f86d2e583856e91e89404b0706d7be735be7c7ccf0ca1f4440
+  metadata.gz: 70a8c6822aef0f83a6a68bee245c9ef9815b1974f1a9447afdd529a18ebc0023
+  data.tar.gz: df70abc4c2f6a2e84f1f46fc8a40c8494ed1101b9fec66a6d4fd49be4205de8d
 SHA512:
-  metadata.gz: 7f21a66a065355626fe1dac2531e367dd76bf4be872234af7c32a607bab39c33ecb9c7e2bcfbd42373df0540c14ec605b1cb5b4f923109ab0e4081fbdbbf5a43
-  data.tar.gz: 676333012b4c8cde3cae624af36c4d759f8df9e4fd81c79e33758a2e36b4e0b5345a22e07d18c48d9233d76bf77c4cd207a6bf6a53f837e56aae3d43bb949b28
+  metadata.gz: 63a55657c6dcb6cb902ddf19106e2fc46aa34d705a84086888d4c27da7a7c7b03bd308929077b9039c664433195e081ae7a245d0d698813739c5a746649f5ef0
+  data.tar.gz: 865ed356aa499d4e0a5d59002e7fa72880aea271f01cf5f0e464258d36e77dfa5147f4fce2ce0dab5cdd96e3f7b891925db3a1c70caa2847dbf04faa4cf75737

data/lib/google/cloud/iot/v1/device_manager/client.rb

@@ -206,7 +206,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
             end
 
@@ -2117,6 +2118,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the DeviceManager API.
               #

data/lib/google/cloud/iot/v1/device_manager/rest/client.rb

@@ -235,6 +235,22 @@ module Google
               # @return [::Google::Cloud::Iot::V1::DeviceRegistry]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::CreateDeviceRegistryRequest.new
+              #
+              #   # Call the create_device_registry method.
+              #   result = client.create_device_registry request
+              #
+              #   # The returned object is of type Google::Cloud::Iot::V1::DeviceRegistry.
+              #   p result
+              #
               def create_device_registry request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -298,6 +314,22 @@ module Google
               # @return [::Google::Cloud::Iot::V1::DeviceRegistry]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::GetDeviceRegistryRequest.new
+              #
+              #   # Call the get_device_registry method.
+              #   result = client.get_device_registry request
+              #
+              #   # The returned object is of type Google::Cloud::Iot::V1::DeviceRegistry.
+              #   p result
+              #
               def get_device_registry request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -368,6 +400,22 @@ module Google
               # @return [::Google::Cloud::Iot::V1::DeviceRegistry]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::UpdateDeviceRegistryRequest.new
+              #
+              #   # Call the update_device_registry method.
+              #   result = client.update_device_registry request
+              #
+              #   # The returned object is of type Google::Cloud::Iot::V1::DeviceRegistry.
+              #   p result
+              #
               def update_device_registry request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -431,6 +479,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::DeleteDeviceRegistryRequest.new
+              #
+              #   # Call the delete_device_registry method.
+              #   result = client.delete_device_registry request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_device_registry request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -503,6 +567,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Iot::V1::DeviceRegistry>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::ListDeviceRegistriesRequest.new
+              #
+              #   # Call the list_device_registries method.
+              #   result = client.list_device_registries request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Iot::V1::DeviceRegistry.
+              #     p item
+              #   end
+              #
               def list_device_registries request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -572,6 +656,22 @@ module Google
               # @return [::Google::Cloud::Iot::V1::Device]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::CreateDeviceRequest.new
+              #
+              #   # Call the create_device method.
+              #   result = client.create_device request
+              #
+              #   # The returned object is of type Google::Cloud::Iot::V1::Device.
+              #   p result
+              #
               def create_device request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -640,6 +740,22 @@ module Google
               # @return [::Google::Cloud::Iot::V1::Device]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::GetDeviceRequest.new
+              #
+              #   # Call the get_device method.
+              #   result = client.get_device request
+              #
+              #   # The returned object is of type Google::Cloud::Iot::V1::Device.
+              #   p result
+              #
               def get_device request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -710,6 +826,22 @@ module Google
               # @return [::Google::Cloud::Iot::V1::Device]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::UpdateDeviceRequest.new
+              #
+              #   # Call the update_device method.
+              #   result = client.update_device request
+              #
+              #   # The returned object is of type Google::Cloud::Iot::V1::Device.
+              #   p result
+              #
               def update_device request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -774,6 +906,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::DeleteDeviceRequest.new
+              #
+              #   # Call the delete_device method.
+              #   result = client.delete_device request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_device request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -859,6 +1007,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Iot::V1::Device>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::ListDevicesRequest.new
+              #
+              #   # Call the list_devices method.
+              #   result = client.list_devices request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Iot::V1::Device.
+              #     p item
+              #   end
+              #
               def list_devices request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -934,6 +1102,22 @@ module Google
               # @return [::Google::Cloud::Iot::V1::DeviceConfig]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::ModifyCloudToDeviceConfigRequest.new
+              #
+              #   # Call the modify_cloud_to_device_config method.
+              #   result = client.modify_cloud_to_device_config request
+              #
+              #   # The returned object is of type Google::Cloud::Iot::V1::DeviceConfig.
+              #   p result
+              #
               def modify_cloud_to_device_config request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1003,6 +1187,22 @@ module Google
               # @return [::Google::Cloud::Iot::V1::ListDeviceConfigVersionsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::ListDeviceConfigVersionsRequest.new
+              #
+              #   # Call the list_device_config_versions method.
+              #   result = client.list_device_config_versions request
+              #
+              #   # The returned object is of type Google::Cloud::Iot::V1::ListDeviceConfigVersionsResponse.
+              #   p result
+              #
               def list_device_config_versions request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1072,6 +1272,22 @@ module Google
               # @return [::Google::Cloud::Iot::V1::ListDeviceStatesResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::ListDeviceStatesRequest.new
+              #
+              #   # Call the list_device_states method.
+              #   result = client.list_device_states request
+              #
+              #   # The returned object is of type Google::Cloud::Iot::V1::ListDeviceStatesResponse.
+              #   p result
+              #
               def list_device_states request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1147,6 +1363,22 @@ module Google
               # @return [::Google::Iam::V1::Policy]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Iam::V1::SetIamPolicyRequest.new
+              #
+              #   # Call the set_iam_policy method.
+              #   result = client.set_iam_policy request
+              #
+              #   # The returned object is of type Google::Iam::V1::Policy.
+              #   p result
+              #
               def set_iam_policy request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1215,6 +1447,22 @@ module Google
               # @return [::Google::Iam::V1::Policy]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Iam::V1::GetIamPolicyRequest.new
+              #
+              #   # Call the get_iam_policy method.
+              #   result = client.get_iam_policy request
+              #
+              #   # The returned object is of type Google::Iam::V1::Policy.
+              #   p result
+              #
               def get_iam_policy request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1285,6 +1533,22 @@ module Google
               # @return [::Google::Iam::V1::TestIamPermissionsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Iam::V1::TestIamPermissionsRequest.new
+              #
+              #   # Call the test_iam_permissions method.
+              #   result = client.test_iam_permissions request
+              #
+              #   # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
+              #   p result
+              #
               def test_iam_permissions request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1369,6 +1633,22 @@ module Google
               # @return [::Google::Cloud::Iot::V1::SendCommandToDeviceResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::SendCommandToDeviceRequest.new
+              #
+              #   # Call the send_command_to_device method.
+              #   result = client.send_command_to_device request
+              #
+              #   # The returned object is of type Google::Cloud::Iot::V1::SendCommandToDeviceResponse.
+              #   p result
+              #
               def send_command_to_device request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1439,6 +1719,22 @@ module Google
               # @return [::Google::Cloud::Iot::V1::BindDeviceToGatewayResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::BindDeviceToGatewayRequest.new
+              #
+              #   # Call the bind_device_to_gateway method.
+              #   result = client.bind_device_to_gateway request
+              #
+              #   # The returned object is of type Google::Cloud::Iot::V1::BindDeviceToGatewayResponse.
+              #   p result
+              #
               def bind_device_to_gateway request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1509,6 +1805,22 @@ module Google
               # @return [::Google::Cloud::Iot::V1::UnbindDeviceFromGatewayResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/iot/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Iot::V1::DeviceManager::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Iot::V1::UnbindDeviceFromGatewayRequest.new
+              #
+              #   # Call the unbind_device_from_gateway method.
+              #   result = client.unbind_device_from_gateway request
+              #
+              #   # The returned object is of type Google::Cloud::Iot::V1::UnbindDeviceFromGatewayResponse.
+              #   p result
+              #
               def unbind_device_from_gateway request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/iot/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Iot
       module V1
-        VERSION = "0.7.1"
+        VERSION = "0.8.0"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -66,6 +66,20 @@ module Google
       # a non-empty value will be returned. The user will not be aware of what
       # non-empty value to expect.
       NON_EMPTY_DEFAULT = 7
+
+      # Denotes that the field in a resource (a message annotated with
+      # google.api.resource) is used in the resource name to uniquely identify the
+      # resource. For AIP-compliant APIs, this should only be applied to the
+      # `name` field on the resource.
+      #
+      # This behavior should not be applied to references to other resources within
+      # the message.
+      #
+      # The identifier field of resources often have different field behavior
+      # depending on the request it is embedded in (e.g. for Create methods name
+      # is optional and unused, while for Update methods it is required). Instead
+      # of method-specific annotations, only `IDENTIFIER` is required.
+      IDENTIFIER = 8
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-iot-v1
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.8.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-04 00:00:00.000000000 Z
+date: 2023-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -233,7 +233,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: Registers and manages IoT (Internet of Things) devices that connect to the