google-cloud-channel-v1 0.1.0 → 0.5.0

data/lib/google/cloud/channel/v1/cloud_channel_service/operations.rb

@@ -103,8 +103,13 @@ module Google
             # Lists operations that match the specified filter in the request. If the
             # server doesn't support this method, it returns `UNIMPLEMENTED`.
             #
-            # NOTE: the `name` binding below allows API services to override the binding
-            # to use different resource name schemes, such as `users/*/operations`.
+            # NOTE: the `name` binding allows API services to override the binding
+            # to use different resource name schemes, such as `users/*/operations`. To
+            # override the binding, API services can add a binding such as
+            # `"/v1/{name=users/*}/operations"` to their service configuration.
+            # For backwards compatibility, the default name includes the operations
+            # collection id, however overriding users must ensure the name binding
+            # is the parent resource, without the operations collection id.
             #
             # @overload list_operations(request, options = nil)
             #   Pass arguments to `list_operations` via a request object, either of type
@@ -122,7 +127,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     The name of the operation collection.
+            #     The name of the operation's parent resource.
             #   @param filter [::String]
             #     The standard list filter.
             #   @param page_size [::Integer]
@@ -390,6 +395,79 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Waits for the specified long-running operation until it is done or reaches
+            # at most a specified timeout, returning the latest state.  If the operation
+            # is already done, the latest state is immediately returned.  If the timeout
+            # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
+            # timeout is used.  If the server does not support this method, it returns
+            # `google.rpc.Code.UNIMPLEMENTED`.
+            # Note that this method is on a best-effort basis.  It may return the latest
+            # state before the specified timeout (including immediately), meaning even an
+            # immediate response is no guarantee that the operation is done.
+            #
+            # @overload wait_operation(request, options = nil)
+            #   Pass arguments to `wait_operation` via a request object, either of type
+            #   {::Google::Longrunning::WaitOperationRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Longrunning::WaitOperationRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload wait_operation(name: nil, timeout: nil)
+            #   Pass arguments to `wait_operation` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     The name of the operation resource to wait on.
+            #   @param timeout [::Google::Protobuf::Duration, ::Hash]
+            #     The maximum duration to wait before timing out. If left blank, the wait
+            #     will be at most the time permitted by the underlying HTTP/RPC protocol.
+            #     If RPC context deadline is also specified, the shorter one will be used.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def wait_operation request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Longrunning::WaitOperationRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.wait_operation.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Channel::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              options.apply_defaults timeout:      @config.rpcs.wait_operation.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.wait_operation.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Configuration class for the Operations API.
             #
@@ -482,7 +560,7 @@ module Google
               config_attr :scope,         nil, ::String, ::Array, nil
               config_attr :lib_name,      nil, ::String, nil
               config_attr :lib_version,   nil, ::String, nil
-              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
               config_attr :interceptors,  nil, ::Array, nil
               config_attr :timeout,       nil, ::Numeric, nil
               config_attr :metadata,      nil, ::Hash, nil
@@ -503,7 +581,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -515,7 +593,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
               #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
               #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
               #     include the following keys:
@@ -546,17 +624,24 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :cancel_operation
+                ##
+                # RPC-specific configuration for `wait_operation`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :wait_operation
 
                 # @private
                 def initialize parent_rpcs = nil
-                  list_operations_config = parent_rpcs&.list_operations if parent_rpcs&.respond_to? :list_operations
+                  list_operations_config = parent_rpcs.list_operations if parent_rpcs.respond_to? :list_operations
                   @list_operations = ::Gapic::Config::Method.new list_operations_config
-                  get_operation_config = parent_rpcs&.get_operation if parent_rpcs&.respond_to? :get_operation
+                  get_operation_config = parent_rpcs.get_operation if parent_rpcs.respond_to? :get_operation
                   @get_operation = ::Gapic::Config::Method.new get_operation_config
-                  delete_operation_config = parent_rpcs&.delete_operation if parent_rpcs&.respond_to? :delete_operation
+                  delete_operation_config = parent_rpcs.delete_operation if parent_rpcs.respond_to? :delete_operation
                   @delete_operation = ::Gapic::Config::Method.new delete_operation_config
-                  cancel_operation_config = parent_rpcs&.cancel_operation if parent_rpcs&.respond_to? :cancel_operation
+                  cancel_operation_config = parent_rpcs.cancel_operation if parent_rpcs.respond_to? :cancel_operation
                   @cancel_operation = ::Gapic::Config::Method.new cancel_operation_config
+                  wait_operation_config = parent_rpcs.wait_operation if parent_rpcs.respond_to? :wait_operation
+                  @wait_operation = ::Gapic::Config::Method.new wait_operation_config
 
                   yield self if block_given?
                 end

data/lib/google/cloud/channel/v1/entitlements_pb.rb

@@ -69,8 +69,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :end_time, :message, 2, "google.protobuf.Timestamp"
     end
     add_message "google.cloud.channel.v1.TransferableSku" do
-      optional :is_commitment, :message, 6, "google.protobuf.BoolValue"
-      optional :commitment_end_timestamp, :message, 7, "google.protobuf.Timestamp"
       optional :transfer_eligibility, :message, 9, "google.cloud.channel.v1.TransferEligibility"
       optional :sku, :message, 11, "google.cloud.channel.v1.Sku"
     end

data/lib/google/cloud/channel/v1/offers_pb.rb

@@ -50,6 +50,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :payment_type, :enum, 2, "google.cloud.channel.v1.PaymentType"
       optional :payment_cycle, :message, 3, "google.cloud.channel.v1.Period"
       optional :trial_period, :message, 4, "google.cloud.channel.v1.Period"
+      optional :billing_account, :string, 5
     end
     add_message "google.cloud.channel.v1.PriceByResource" do
       optional :resource_type, :enum, 1, "google.cloud.channel.v1.ResourceType"

data/lib/google/cloud/channel/v1/service_pb.rb

@@ -122,7 +122,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.channel.v1.CreateChannelPartnerLinkRequest" do
       optional :parent, :string, 1
       optional :channel_partner_link, :message, 2, "google.cloud.channel.v1.ChannelPartnerLink"
-      optional :domain, :string, 3
     end
     add_message "google.cloud.channel.v1.UpdateChannelPartnerLinkRequest" do
       optional :name, :string, 1
@@ -267,6 +266,30 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.channel.v1.PurchasableOffer" do
       optional :offer, :message, 1, "google.cloud.channel.v1.Offer"
     end
+    add_message "google.cloud.channel.v1.RegisterSubscriberRequest" do
+      optional :account, :string, 1
+      optional :service_account, :string, 2
+    end
+    add_message "google.cloud.channel.v1.RegisterSubscriberResponse" do
+      optional :topic, :string, 1
+    end
+    add_message "google.cloud.channel.v1.UnregisterSubscriberRequest" do
+      optional :account, :string, 1
+      optional :service_account, :string, 2
+    end
+    add_message "google.cloud.channel.v1.UnregisterSubscriberResponse" do
+      optional :topic, :string, 1
+    end
+    add_message "google.cloud.channel.v1.ListSubscribersRequest" do
+      optional :account, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+    end
+    add_message "google.cloud.channel.v1.ListSubscribersResponse" do
+      optional :topic, :string, 1
+      repeated :service_accounts, :string, 2
+      optional :next_page_token, :string, 3
+    end
   end
 end
 
@@ -325,6 +348,12 @@ module Google
         ListPurchasableOffersRequest::ChangeOfferPurchase = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListPurchasableOffersRequest.ChangeOfferPurchase").msgclass
         ListPurchasableOffersResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListPurchasableOffersResponse").msgclass
         PurchasableOffer = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.PurchasableOffer").msgclass
+        RegisterSubscriberRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.RegisterSubscriberRequest").msgclass
+        RegisterSubscriberResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.RegisterSubscriberResponse").msgclass
+        UnregisterSubscriberRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.UnregisterSubscriberRequest").msgclass
+        UnregisterSubscriberResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.UnregisterSubscriberResponse").msgclass
+        ListSubscribersRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListSubscribersRequest").msgclass
+        ListSubscribersResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListSubscribersResponse").msgclass
       end
     end
   end

data/lib/google/cloud/channel/v1/service_services_pb.rb

@@ -63,7 +63,7 @@ module Google
             # request.
             #
             # Return Value:
-            # <br/> List of [Customer][google.cloud.channel.v1.Customer]s pertaining to the reseller or empty list if
+            # List of [Customer][google.cloud.channel.v1.Customer]s pertaining to the reseller or empty list if
             # there are none.
             rpc :ListCustomers, ::Google::Cloud::Channel::V1::ListCustomersRequest, ::Google::Cloud::Channel::V1::ListCustomersResponse
             # Returns a requested [Customer][google.cloud.channel.v1.Customer] resource.
@@ -78,7 +78,7 @@ module Google
             # the result of an invalid name parameter.
             #
             # Return Value:
-            # <br/> [Customer][google.cloud.channel.v1.Customer] resource if found, error otherwise.
+            # [Customer][google.cloud.channel.v1.Customer] resource if found, error otherwise.
             rpc :GetCustomer, ::Google::Cloud::Channel::V1::GetCustomerRequest, ::Google::Cloud::Channel::V1::Customer
             # Confirms the existence of Cloud Identity accounts, based on the domain and
             # whether the Cloud Identity accounts are owned by the reseller.
@@ -90,31 +90,28 @@ module Google
             # * INVALID_ARGUMENT: Missing or invalid required parameters in the
             # request.
             # * INVALID_VALUE: Invalid domain value in the request.
-            # * NOT_FOUND: If there is no [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] customer
-            # for the domain specified in the request.
             #
             # Return Value:
-            # <br/> List of [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources if any exist for
-            # the domain, otherwise an error is returned.
+            # List of [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain.
+            # List may be empty.
+            #
+            # Note: in the v1alpha1 version of the API, a NOT_FOUND error is returned if
+            # no [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources match the domain.
             rpc :CheckCloudIdentityAccountsExist, ::Google::Cloud::Channel::V1::CheckCloudIdentityAccountsExistRequest, ::Google::Cloud::Channel::V1::CheckCloudIdentityAccountsExistResponse
             # Creates a new [Customer][google.cloud.channel.v1.Customer] resource under the reseller or distributor
             # account.
             #
             # Possible Error Codes:
-            # <ul>
-            # <li>PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different.</li>
-            # <li> INVALID_ARGUMENT:
-            # <ul>
-            #  <li> Missing or invalid required parameters in the request. </li>
-            #  <li> Domain field value doesn't match the domain specified in primary
-            #  email.</li>
-            # </ul>
-            # </li>
-            # </ul>
+            #
+            # * PERMISSION_DENIED: If the reseller account making the request and the
+            # reseller account being queried for are different.
+            # * INVALID_ARGUMENT: It can happen in following scenarios -
+            #     * Missing or invalid required parameters in the request.
+            #     * Domain field value doesn't match the domain specified in primary
+            #     email.
             #
             # Return Value:
-            # <br/> If successful, the newly created [Customer][google.cloud.channel.v1.Customer] resource, otherwise
+            # If successful, the newly created [Customer][google.cloud.channel.v1.Customer] resource, otherwise
             # returns an error.
             rpc :CreateCustomer, ::Google::Cloud::Channel::V1::CreateCustomerRequest, ::Google::Cloud::Channel::V1::Customer
             # Updates an existing [Customer][google.cloud.channel.v1.Customer] resource belonging to the reseller or
@@ -130,7 +127,7 @@ module Google
             # specified in the request.
             #
             # Return Value:
-            # <br/> If successful, the updated [Customer][google.cloud.channel.v1.Customer] resource, otherwise returns
+            # If successful, the updated [Customer][google.cloud.channel.v1.Customer] resource, otherwise returns
             # an error.
             rpc :UpdateCustomer, ::Google::Cloud::Channel::V1::UpdateCustomerRequest, ::Google::Cloud::Channel::V1::Customer
             # Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly.
@@ -161,7 +158,7 @@ module Google
             #    Contact Cloud Channel support in this case.
             #
             # Return Value:
-            # <br/>  Long Running Operation ID.
+            # Long Running Operation ID.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -175,7 +172,7 @@ module Google
             # * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
             #
             # Return Value:
-            # <br/> List of [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to the customer, or empty list if
+            # List of [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to the customer, or empty list if
             # there are none.
             rpc :ListEntitlements, ::Google::Cloud::Channel::V1::ListEntitlementsRequest, ::Google::Cloud::Channel::V1::ListEntitlementsResponse
             # List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on Cloud Identity ID or
@@ -186,21 +183,16 @@ module Google
             # the customer's Cloud Identity ID or Customer Name.
             #
             # Possible Error Codes:
-            # <ul>
-            # <li>PERMISSION_DENIED, due to one of the following reasons:
-            # <ul>
-            #    <li> If the customer doesn't belong to the reseller and no auth token,
-            #    or an invalid auth token is supplied. </li> <li> If the reseller account
-            #    making the request and the reseller account being queried for are
-            #    different. </li>
-            # </ul>
-            # </li>
-            # <li> INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request.</li>
-            # </ul>
+            #
+            # * PERMISSION_DENIED: Appears because of one of the following -
+            #     * The customer doesn't belong to the reseller and no auth token.
+            #     * The supplied auth token is invalid.
+            #     * The reseller account making the request and the queries reseller
+            #     account are different.
+            # * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
             #
             # Return Value:
-            # <br/> List of [TransferableSku][google.cloud.channel.v1.TransferableSku] for the given customer.
+            # List of [TransferableSku][google.cloud.channel.v1.TransferableSku] for the given customer.
             rpc :ListTransferableSkus, ::Google::Cloud::Channel::V1::ListTransferableSkusRequest, ::Google::Cloud::Channel::V1::ListTransferableSkusResponse
             # List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a customer based on Cloud Identity ID or
             # Customer Name in the request.
@@ -211,10 +203,11 @@ module Google
             #
             # Possible Error Codes:
             #
-            # * PERMISSION_DENIED, due to one of the following reasons: (a) If the
-            # customer doesn't belong to the reseller and no auth token or invalid auth
-            # token is supplied. (b) If the reseller account making the request and the
-            # reseller account being queried for are different.
+            # * PERMISSION_DENIED: Appears because of one of the following:
+            #     * If the customer doesn't belong to the reseller and no auth token or
+            #     invalid auth token is supplied.
+            #     * If the reseller account making the request and the reseller account
+            #     being queried for are different.
             # * INVALID_ARGUMENT: Missing or invalid required parameters in the
             # request.
             #
@@ -231,57 +224,44 @@ module Google
             # * NOT_FOUND: If the entitlement is not found for the customer.
             #
             # Return Value:
-            # <br/> If found, the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource, otherwise returns
+            # If found, the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource, otherwise returns
             # an error.
             rpc :GetEntitlement, ::Google::Cloud::Channel::V1::GetEntitlementRequest, ::Google::Cloud::Channel::V1::Entitlement
             # Creates an entitlement for a customer.
             #
             # Possible Error Codes:
-            # <ul>
-            # <li> PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # </li> <li> INVALID_ARGUMENT: <ul>
-            #   <li> Missing or invalid required parameters in the request. </li>
-            #   <li> Cannot purchase an entitlement if there is already an
-            #    entitlement for customer, for a SKU from the same product family. </li>
-            #   <li> INVALID_VALUE: Offer passed in isn't valid. Make sure OfferId is
-            # valid. If it is valid, then contact Google Channel support for further
-            # troubleshooting. </li>
-            # </ul>
-            # </li>
-            # <li> NOT_FOUND: If the customer or offer resource is not found for the
-            # reseller. </li>
-            # <li> ALREADY_EXISTS: This failure can happen in the following cases:
-            #   <ul>
-            #     <li>If the SKU has been already purchased for the customer.</li>
-            #     <li>If the customer's primary email already exists. In this case retry
-            #         after changing the customer's primary contact email.
-            #     </li>
-            #   </ul>
-            # </li>
-            # <li> CONDITION_NOT_MET or FAILED_PRECONDITION: This
-            # failure can happen in the following cases:
-            # <ul>
-            #    <li> Purchasing a SKU that requires domain verification and the
-            #    domain has not been verified. </li>
-            #    <li> Purchasing an Add-On SKU like Vault or Drive without purchasing
-            #    the pre-requisite SKU, such as Google Workspace Business Starter. </li>
-            #    <li> Applicable only for developer accounts: reseller and resold
-            #    domain. Must meet the following domain naming requirements:
-            #     <ul>
-            #       <li> Domain names must start with goog-test. </li>
-            #       <li> Resold domain names must include the reseller domain. </li>
-            #     </ul>
-            #    </li>
-            # </ul>
-            # </li>
-            # <li> INTERNAL: Any non-user error related to a technical issue in the
-            # backend. Contact Cloud Channel Support in this case. </li>
-            # <li> UNKNOWN: Any non-user error related to a technical issue in the
-            # backend. Contact Cloud Channel Support in this case. </li>
-            # </ul>
+            #
+            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: It can happen in below scenarios -
+            #     * Missing or invalid required parameters in the request.
+            #     * Cannot purchase an entitlement if there is already an entitlement for
+            #     customer, for a SKU from the same product family.
+            #     * INVALID_VALUE: Offer passed in isn't valid. Make sure OfferId is
+            #     valid. If it is valid, then contact Google Channel support for further
+            #     troubleshooting.
+            # * NOT_FOUND: If the customer or offer resource is not found for the
+            # reseller.
+            # * ALREADY_EXISTS: This failure can happen in the following cases:
+            #     * If the SKU has been already purchased for the customer.
+            #     * If the customer's primary email already exists. In this case retry
+            #     after changing the customer's primary contact email.
+            # * CONDITION_NOT_MET or FAILED_PRECONDITION: This failure can happen in the
+            # following cases:
+            #     * Purchasing a SKU that requires domain verification and the domain has
+            #     not been verified.
+            #     * Purchasing an Add-On SKU like Vault or Drive without purchasing the
+            #     pre-requisite SKU, such as Google Workspace Business Starter.
+            #     * Applicable only for developer accounts: reseller and resold domain.
+            #     Must meet the following domain naming requirements:
+            #         * Domain names must start with goog-test.
+            #         * Resold domain names must include the reseller domain.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel Support in this case.
+            # * UNKNOWN: Any non-user error related to a technical issue in the
+            # backend. Contact Cloud Channel Support in this case.
             #
             # Return Value:
-            # <br/> Long Running Operation ID.
+            # Long Running Operation ID.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -306,7 +286,7 @@ module Google
             # In this case, contact Cloud Channel support.
             #
             # Return Value:
-            # <br/> Long Running Operation ID.
+            # Long Running Operation ID.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -331,7 +311,7 @@ module Google
             # In this case, contact Cloud Channel support.
             #
             # Return Value:
-            # <br/> Long Running Operation ID.
+            # Long Running Operation ID.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -354,7 +334,7 @@ module Google
             # In this case, contact Cloud Channel support.
             #
             # Return Value:
-            # <br/> Long Running Operation ID.
+            # Long Running Operation ID.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -380,7 +360,7 @@ module Google
             # in the backend. In this case, contact Cloud Channel support.
             #
             # Return Value:
-            # <br/> Long Running Operation ID.
+            # Long Running Operation ID.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -402,7 +382,7 @@ module Google
             # In this case, contact Cloud Channel support.
             #
             # Return Value:
-            # <br/> Long Running Operation ID.
+            # Long Running Operation ID.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -429,7 +409,7 @@ module Google
             # In this case, contact Cloud Channel support.
             #
             # Return Value:
-            # <br/> Long Running Operation ID.
+            # Long Running Operation ID.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The response will contain
@@ -461,7 +441,7 @@ module Google
             # In this case, contact Cloud Channel support.
             #
             # Return Value:
-            # <br/> Long Running Operation ID.
+            # Long Running Operation ID.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -470,36 +450,30 @@ module Google
             # Transfers customer entitlements to new reseller.
             #
             # Possible Error Codes:
-            # <ul>
-            # <li> PERMISSION_DENIED: If the customer doesn't belong to the
-            # reseller.</li> <li> INVALID_ARGUMENT: Missing or invalid required
-            # parameters in the request. </li> <li> NOT_FOUND: If the customer or offer
-            # resource is not found for the reseller. </li> <li> ALREADY_EXISTS: If the
-            # SKU has been already transferred for the customer. </li> <li>
-            # CONDITION_NOT_MET or FAILED_PRECONDITION: This failure can happen in the
-            # following cases: <ul>
-            #    <li> Transferring a SKU that requires domain verification and the
-            # domain has not been verified. </li>
-            #    <li> Transferring an Add-On SKU like Vault or Drive without transferring
-            # the pre-requisite SKU, such as G Suite Basic </li> <li> Applicable only for
-            # developer accounts: reseller and resold domain must follow the domain
-            # naming convention as follows:
-            #      <ul>
-            #         <li> Domain names must start with goog-test. </li>
-            #         <li> Resold domain names must include the reseller domain. </li>
-            #      </ul>
-            #   </li>
-            #   <li> All transferring entitlements must be specified. </li>
-            # </ul>
-            # </li>
-            # <li> INTERNAL: Any non-user error related to a technical issue in the
-            # backend. Please contact Cloud Channel Support in this case. </li>
-            # <li> UNKNOWN: Any non-user error related to a technical issue in the
-            # backend. Please contact Cloud Channel Support in this case. </li>
-            # </ul>
+            #
+            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
+            # * NOT_FOUND: If the customer or offer resource is not found for the
+            # reseller.
+            # * ALREADY_EXISTS: If the SKU has been already transferred for the customer.
+            # * CONDITION_NOT_MET or FAILED_PRECONDITION: This failure can happen in the
+            # following cases:
+            #     * Transferring a SKU that requires domain verification and the domain
+            #     has not been verified.
+            #     * Transferring an Add-On SKU like Vault or Drive without transferring
+            #     the pre-requisite SKU, such as G Suite Basic.
+            #     * Applicable only for developer accounts: reseller and resold domain
+            #     must follow the domain naming convention as follows:
+            #         * Domain names must start with goog-test.
+            #         * Resold domain names must include the reseller domain.
+            #     * All transferring entitlements must be specified.
+            # * INTERNAL: Any non-user error related to a technical issue in the backend.
+            # Please contact Cloud Channel Support in this case.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Please contact Cloud Channel Support in this case.
             #
             # Return Value:
-            # <br/> Long Running Operation ID.
+            # Long Running Operation ID.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The Operation metadata will contain an
@@ -508,38 +482,29 @@ module Google
             # Transfers customer entitlements from current reseller to Google.
             #
             # Possible Error Codes:
-            # <ul>
-            # <li> PERMISSION_DENIED: If the customer doesn't belong to the reseller.
-            # </li> <li> INVALID_ARGUMENT: Missing or invalid required parameters in the
-            # request. </li>
-            # <li> NOT_FOUND: If the customer or offer resource is not found
-            # for the reseller. </li>
-            # <li> ALREADY_EXISTS: If the SKU has been already
-            # transferred for the customer. </li>
-            # <li> CONDITION_NOT_MET or FAILED_PRECONDITION: This failure can happen in
+            #
+            # * PERMISSION_DENIED: If the customer doesn't belong to the reseller.
+            # * INVALID_ARGUMENT: Missing or invalid required parameters in the request.
+            # * NOT_FOUND: If the customer or offer resource is not found for the
+            # reseller.
+            # * ALREADY_EXISTS: If the SKU has been already transferred for the customer.
+            # * CONDITION_NOT_MET or FAILED_PRECONDITION: This failure can happen in
             # the following cases:
-            # <ul>
-            #    <li> Transferring a SKU that requires domain verification and the
-            # domain has not been verified. </li>
-            #    <li> Transferring an Add-On SKU like Vault or Drive without purchasing
-            # the pre-requisite SKU, such as G Suite Basic </li> <li> Applicable only for
-            # developer accounts: reseller and resold domain must follow the domain
-            # naming convention as follows:
-            #      <ul>
-            #         <li> Domain names must start with goog-test. </li>
-            #         <li> Resold domain names must include the reseller domain. </li>
-            #      </ul>
-            #    </li>
-            # </ul>
-            # </li>
-            # <li> INTERNAL: Any non-user error related to a technical issue in the
-            # backend. Please contact Cloud Channel Support in this case. </li>
-            # <li> UNKNOWN: Any non-user error related to a technical issue in the
-            # backend. Please contact Cloud Channel Support in this case.</li>
-            # </ul>
+            #     * Transferring a SKU that requires domain verification and the domain
+            #     has not been verified.
+            #     * Transferring an Add-On SKU like Vault or Drive without purchasing the
+            #     pre-requisite SKU, such as G Suite Basic.
+            #     * Applicable only for developer accounts: reseller and resold domain
+            #     must follow the domain naming convention as follows:
+            #         * Domain names must start with goog-test.
+            #         * Resold domain names must include the reseller domain.
+            # * INTERNAL: Any non-user error related to a technical issue in the backend.
+            # Please contact Cloud Channel Support in this case.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # Please contact Cloud Channel Support in this case.
             #
             # Return Value:
-            # <br/> Long Running Operation ID.
+            # Long Running Operation ID.
             #
             # To get the results of the operation, call the GetOperation method of
             # CloudChannelOperationsService. The response will contain
@@ -557,7 +522,7 @@ module Google
             # request.
             #
             # Return Value:
-            # <br/> If successful, returns the list of [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources
+            # If successful, returns the list of [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources
             # for the distributor account, otherwise returns an error.
             rpc :ListChannelPartnerLinks, ::Google::Cloud::Channel::V1::ListChannelPartnerLinksRequest, ::Google::Cloud::Channel::V1::ListChannelPartnerLinksResponse
             # Returns a requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
@@ -573,7 +538,7 @@ module Google
             # due invalid channel partner link name.
             #
             # Return Value:
-            # <br/> [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if found, otherwise returns an error.
+            # [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if found, otherwise returns an error.
             rpc :GetChannelPartnerLink, ::Google::Cloud::Channel::V1::GetChannelPartnerLinkRequest, ::Google::Cloud::Channel::V1::ChannelPartnerLink
             # Initiates a channel partner link between a distributor and a reseller or
             # between resellers in an n-tier reseller channel.
@@ -597,7 +562,7 @@ module Google
             # the backend. In this case, contact Cloud Channel support.
             #
             # Return Value:
-            # <br/> Newly created [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if successful,
+            # Newly created [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource if successful,
             # otherwise error is returned.
             rpc :CreateChannelPartnerLink, ::Google::Cloud::Channel::V1::CreateChannelPartnerLinkRequest, ::Google::Cloud::Channel::V1::ChannelPartnerLink
             # Updates a channel partner link. A distributor calls this method to change a
@@ -605,26 +570,22 @@ module Google
             # To call this method, you must be a distributor.
             #
             # Possible Error Codes:
-            # <ul>
-            # <li> PERMISSION_DENIED: If the reseller account making the request and the
-            # reseller account being queried for are different. </li>
-            # <li> INVALID_ARGUMENT:
-            # <ul>
-            #   <li> Missing or invalid required parameters in the request. </li>
-            #   <li> Updating link state from invited to active or suspended. </li>
-            #   <li> Sending reseller_cloud_identity_id, invite_url or name in update
-            #   mask. </li>
-            # </ul>
-            # </li>
-            # <li> NOT_FOUND: ChannelPartnerLink resource not found.</li>
-            # <li> INTERNAL: Any non-user error related to a technical issue in the
-            # backend. In this case, contact Cloud Channel support. </li>
-            # <li> UNKNOWN: Any non-user error related to a technical issue in the
-            # backend. In this case, contact Cloud Channel support.</li>
-            # </ul>
+            #
+            # * PERMISSION_DENIED: If the reseller account making the request and the
+            # reseller account being queried for are different.
+            # * INVALID_ARGUMENT: It can happen in following scenarios -
+            #     * Missing or invalid required parameters in the request.
+            #     * Updating link state from invited to active or suspended.
+            #     * Sending reseller_cloud_identity_id, invite_url or name in update
+            #     mask.
+            # * NOT_FOUND: ChannelPartnerLink resource not found.
+            # * INTERNAL: Any non-user error related to a technical issue in the backend.
+            # In this case, contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in the backend.
+            # In this case, contact Cloud Channel support.
             #
             # Return Value:
-            # <br/> If successful, the updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource, otherwise
+            # If successful, the updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource, otherwise
             # returns an error.
             rpc :UpdateChannelPartnerLink, ::Google::Cloud::Channel::V1::UpdateChannelPartnerLinkRequest, ::Google::Cloud::Channel::V1::ChannelPartnerLink
             # Lists the Products the reseller is authorized to sell.
@@ -670,6 +631,69 @@ module Google
             # * INVALID_ARGUMENT: Missing or invalid required parameters in the
             # request.
             rpc :ListPurchasableOffers, ::Google::Cloud::Channel::V1::ListPurchasableOffersRequest, ::Google::Cloud::Channel::V1::ListPurchasableOffersResponse
+            # Registers a service account with subscriber privileges on the Cloud Pub/Sub
+            # topic created for this Channel Services account. Once you create a
+            # subscriber, you will get the events as per [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
+            #
+            # Possible Error Codes:
+            #
+            # * PERMISSION_DENIED: If the reseller account making the request and the
+            # reseller account being provided are different, or if the impersonated user
+            # is not a super admin.
+            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
+            # request.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. In this case, contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in
+            # the backend. In this case, contact Cloud Channel support.
+            #
+            # Return Value:
+            # Topic name with service email address registered if successful,
+            # otherwise error is returned.
+            rpc :RegisterSubscriber, ::Google::Cloud::Channel::V1::RegisterSubscriberRequest, ::Google::Cloud::Channel::V1::RegisterSubscriberResponse
+            # Unregisters a service account with subscriber privileges on the Cloud
+            # Pub/Sub topic created for this Channel Services account. If there are no
+            # more service account left with sunbscriber privileges, the topic will be
+            # deleted. You can check this by calling ListSubscribers api.
+            #
+            # Possible Error Codes:
+            #
+            # * PERMISSION_DENIED: If the reseller account making the request and the
+            # reseller account being provided are different, or if the impersonated user
+            # is not a super admin.
+            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
+            # request.
+            # * NOT_FOUND: If the topic resource doesn't exist.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. In this case, contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in
+            # the backend. In this case, contact Cloud Channel support.
+            #
+            # Return Value:
+            # Topic name from which service email address has been unregistered if
+            # successful, otherwise error is returned. If the service email was already
+            # not associated with the topic, the success response will be returned.
+            rpc :UnregisterSubscriber, ::Google::Cloud::Channel::V1::UnregisterSubscriberRequest, ::Google::Cloud::Channel::V1::UnregisterSubscriberResponse
+            # Lists service accounts with subscriber privileges on the Cloud Pub/Sub
+            # topic created for this Channel Services account.
+            #
+            # Possible Error Codes:
+            #
+            # * PERMISSION_DENIED: If the reseller account making the request and the
+            # reseller account being provided are different, or if the account is not
+            # a super admin.
+            # * INVALID_ARGUMENT: Missing or invalid required parameters in the
+            # request.
+            # * NOT_FOUND: If the topic resource doesn't exist.
+            # * INTERNAL: Any non-user error related to a technical issue in the
+            # backend. In this case, contact Cloud Channel support.
+            # * UNKNOWN: Any non-user error related to a technical issue in
+            # the backend. In this case, contact Cloud Channel support.
+            #
+            # Return Value:
+            # List of service email addresses if successful, otherwise error is
+            # returned.
+            rpc :ListSubscribers, ::Google::Cloud::Channel::V1::ListSubscribersRequest, ::Google::Cloud::Channel::V1::ListSubscribersResponse
           end
 
           Stub = Service.rpc_stub_class