google-cloud-channel-v1 0.15.0 → 0.17.0

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

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "gapic/rest"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/channel/v1/version"
+
+require "google/cloud/channel/v1/cloud_channel_service/credentials"
+require "google/cloud/channel/v1/cloud_channel_service/paths"
+require "google/cloud/channel/v1/cloud_channel_service/rest/operations"
+require "google/cloud/channel/v1/cloud_channel_service/rest/client"
+
+module Google
+  module Cloud
+    module Channel
+      module V1
+        ##
+        # CloudChannelService lets Google cloud resellers and distributors manage
+        # their customers, channel partners, entitlements, and reports.
+        #
+        # Using this service:
+        # 1. Resellers and distributors can manage a customer entity.
+        # 2. Distributors can register an authorized reseller in their channel and
+        #    provide them with delegated admin access.
+        # 3. Resellers and distributors can manage customer entitlements.
+        #
+        # CloudChannelService exposes the following resources:
+        # - {::Google::Cloud::Channel::V1::Customer Customer}s: An entity-usually an
+        # enterprise-managed by a reseller or distributor.
+        #
+        # - {::Google::Cloud::Channel::V1::Entitlement Entitlement}s: An entity that
+        # provides a customer with the means to use a service. Entitlements are created
+        # or updated as a result of a successful fulfillment.
+        #
+        # - {::Google::Cloud::Channel::V1::ChannelPartnerLink ChannelPartnerLink}s: An
+        # entity that identifies links between distributors and their indirect
+        # resellers in a channel.
+        #
+        # To load this service and instantiate a REST client:
+        #
+        #     require "google/cloud/channel/v1/cloud_channel_service/rest"
+        #     client = ::Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
+        #
+        module CloudChannelService
+          # Client for the REST transport
+          module Rest
+          end
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "rest", "helpers.rb"
+require "google/cloud/channel/v1/cloud_channel_service/rest/helpers" if ::File.file? helper_path

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

@@ -26,6 +26,7 @@ require "google/cloud/channel/v1/cloud_channel_service/credentials"
 require "google/cloud/channel/v1/cloud_channel_service/paths"
 require "google/cloud/channel/v1/cloud_channel_service/operations"
 require "google/cloud/channel/v1/cloud_channel_service/client"
+require "google/cloud/channel/v1/cloud_channel_service/rest"
 
 module Google
   module Cloud
@@ -53,11 +54,16 @@ module Google
         # entity that identifies links between distributors and their indirect
         # resellers in a channel.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/channel/v1/cloud_channel_service"
         #     client = ::Google::Cloud::Channel::V1::CloudChannelService::Client.new
         #
+        # @example Load this service and instantiate a REST client
+        #
+        #     require "google/cloud/channel/v1/cloud_channel_service/rest"
+        #     client = ::Google::Cloud::Channel::V1::CloudChannelService::Rest::Client.new
+        #
         module CloudChannelService
         end
       end

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

@@ -24,6 +24,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :language_code, :string, 10
       optional :cloud_identity_info, :message, 12, "google.cloud.channel.v1.CloudIdentityInfo"
       optional :channel_partner_id, :string, 13
+      optional :correlation_id, :string, 14
     end
     add_message "google.cloud.channel.v1.ContactInfo" do
       optional :first_name, :string, 1

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

@@ -0,0 +1,81 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/channel/v1/entitlement_changes.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/cloud/channel/v1/entitlements_pb'
+require 'google/protobuf/timestamp_pb'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/channel/v1/entitlement_changes.proto", :syntax => :proto3) do
+    add_message "google.cloud.channel.v1.EntitlementChange" do
+      optional :entitlement, :string, 1
+      optional :offer, :string, 2
+      optional :provisioned_service, :message, 3, "google.cloud.channel.v1.ProvisionedService"
+      optional :change_type, :enum, 4, "google.cloud.channel.v1.EntitlementChange.ChangeType"
+      optional :create_time, :message, 5, "google.protobuf.Timestamp"
+      optional :operator_type, :enum, 6, "google.cloud.channel.v1.EntitlementChange.OperatorType"
+      repeated :parameters, :message, 8, "google.cloud.channel.v1.Parameter"
+      optional :operator, :string, 12
+      oneof :change_reason do
+        optional :suspension_reason, :enum, 9, "google.cloud.channel.v1.Entitlement.SuspensionReason"
+        optional :cancellation_reason, :enum, 10, "google.cloud.channel.v1.EntitlementChange.CancellationReason"
+        optional :activation_reason, :enum, 11, "google.cloud.channel.v1.EntitlementChange.ActivationReason"
+        optional :other_change_reason, :string, 100
+      end
+    end
+    add_enum "google.cloud.channel.v1.EntitlementChange.ChangeType" do
+      value :CHANGE_TYPE_UNSPECIFIED, 0
+      value :CREATED, 1
+      value :PRICE_PLAN_SWITCHED, 3
+      value :COMMITMENT_CHANGED, 4
+      value :RENEWED, 5
+      value :SUSPENDED, 6
+      value :ACTIVATED, 7
+      value :CANCELLED, 8
+      value :SKU_CHANGED, 9
+      value :RENEWAL_SETTING_CHANGED, 10
+      value :PAID_SUBSCRIPTION_STARTED, 11
+      value :LICENSE_CAP_CHANGED, 12
+      value :SUSPENSION_DETAILS_CHANGED, 13
+      value :TRIAL_END_DATE_EXTENDED, 14
+      value :TRIAL_STARTED, 15
+    end
+    add_enum "google.cloud.channel.v1.EntitlementChange.OperatorType" do
+      value :OPERATOR_TYPE_UNSPECIFIED, 0
+      value :CUSTOMER_SERVICE_REPRESENTATIVE, 1
+      value :SYSTEM, 2
+      value :CUSTOMER, 3
+      value :RESELLER, 4
+    end
+    add_enum "google.cloud.channel.v1.EntitlementChange.CancellationReason" do
+      value :CANCELLATION_REASON_UNSPECIFIED, 0
+      value :SERVICE_TERMINATED, 1
+      value :RELATIONSHIP_ENDED, 2
+      value :PARTIAL_TRANSFER, 3
+    end
+    add_enum "google.cloud.channel.v1.EntitlementChange.ActivationReason" do
+      value :ACTIVATION_REASON_UNSPECIFIED, 0
+      value :RESELLER_REVOKED_SUSPENSION, 1
+      value :CUSTOMER_ACCEPTED_PENDING_TOS, 2
+      value :RENEWAL_SETTINGS_CHANGED, 3
+      value :OTHER_ACTIVATION_REASON, 100
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Channel
+      module V1
+        EntitlementChange = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.EntitlementChange").msgclass
+        EntitlementChange::ChangeType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.EntitlementChange.ChangeType").enummodule
+        EntitlementChange::OperatorType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.EntitlementChange.OperatorType").enummodule
+        EntitlementChange::CancellationReason = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.EntitlementChange.CancellationReason").enummodule
+        EntitlementChange::ActivationReason = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.EntitlementChange.ActivationReason").enummodule
+      end
+    end
+  end
+end

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

@@ -7,6 +7,7 @@ require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/cloud/channel/v1/operations_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/type/date_pb'

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

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "google/cloud/channel/v1/cloud_channel_reports_service/rest"
+require "google/cloud/channel/v1/cloud_channel_service/rest"
+require "google/cloud/channel/v1/version"
+
+module Google
+  module Cloud
+    module Channel
+      ##
+      # To load just the REST part of this package, including all its services, and instantiate a REST client:
+      #
+      # @example
+      #
+      #     require "google/cloud/channel/v1/rest"
+      #     client = ::Google::Cloud::Channel::V1::CloudChannelReportsService::Rest::Client.new
+      #
+      module V1
+      end
+    end
+  end
+end

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

@@ -10,8 +10,10 @@ require 'google/api/resource_pb'
 require 'google/cloud/channel/v1/channel_partner_links_pb'
 require 'google/cloud/channel/v1/common_pb'
 require 'google/cloud/channel/v1/customers_pb'
+require 'google/cloud/channel/v1/entitlement_changes_pb'
 require 'google/cloud/channel/v1/entitlements_pb'
 require 'google/cloud/channel/v1/offers_pb'
+require 'google/cloud/channel/v1/operations_pb'
 require 'google/cloud/channel/v1/products_pb'
 require 'google/cloud/channel/v1/repricing_pb'
 require 'google/longrunning/operations_pb'
@@ -271,6 +273,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :page_token, :string, 3
       optional :filter, :string, 4
       optional :language_code, :string, 5
+      optional :show_future_offers, :bool, 7
     end
     add_message "google.cloud.channel.v1.ListOffersResponse" do
       repeated :offers, :message, 1, "google.cloud.channel.v1.Offer"
@@ -353,6 +356,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :service_accounts, :string, 2
       optional :next_page_token, :string, 3
     end
+    add_message "google.cloud.channel.v1.ListEntitlementChangesRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 2
+      optional :page_token, :string, 3
+      optional :filter, :string, 4
+    end
+    add_message "google.cloud.channel.v1.ListEntitlementChangesResponse" do
+      repeated :entitlement_changes, :message, 1, "google.cloud.channel.v1.EntitlementChange"
+      optional :next_page_token, :string, 2
+    end
   end
 end
 
@@ -431,6 +444,8 @@ module Google
         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
+        ListEntitlementChangesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListEntitlementChangesRequest").msgclass
+        ListEntitlementChangesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.channel.v1.ListEntitlementChangesResponse").msgclass
       end
     end
   end

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

@@ -967,6 +967,23 @@ module Google
             # Return value:
             # A list of service email addresses.
             rpc :ListSubscribers, ::Google::Cloud::Channel::V1::ListSubscribersRequest, ::Google::Cloud::Channel::V1::ListSubscribersResponse
+            # List entitlement history.
+            #
+            # Possible error codes:
+            #
+            # * PERMISSION_DENIED: The reseller account making the request and the
+            # provided reseller account are different.
+            # * INVALID_ARGUMENT: Missing or invalid required fields in the request.
+            # * NOT_FOUND: The parent resource doesn't exist. Usually the result of an
+            # invalid name parameter.
+            # * INTERNAL: Any non-user error related to a technical issue in the backend.
+            # In this case, contact CloudChannel 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 [EntitlementChange][google.cloud.channel.v1.EntitlementChange]s.
+            rpc :ListEntitlementChanges, ::Google::Cloud::Channel::V1::ListEntitlementChangesRequest, ::Google::Cloud::Channel::V1::ListEntitlementChangesResponse
           end
 
           Stub = Service.rpc_stub_class

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Channel
       module V1
-        VERSION = "0.15.0"
+        VERSION = "0.17.0"
       end
     end
   end

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

@@ -24,13 +24,18 @@ module Google
   module Cloud
     module Channel
       ##
-      # To load this package, including all its services, and instantiate a client:
+      # API client module.
       #
-      # @example
+      # @example Load this package, including all its services, and instantiate a gRPC client
       #
       #     require "google/cloud/channel/v1"
       #     client = ::Google::Cloud::Channel::V1::CloudChannelReportsService::Client.new
       #
+      # @example Load this package, including all its services, and instantiate a REST client
+      #
+      #     require "google/cloud/channel/v1"
+      #     client = ::Google::Cloud::Channel::V1::CloudChannelReportsService::Rest::Client.new
+      #
       module V1
       end
     end

data/proto_docs/google/cloud/channel/v1/customers.rb

@@ -72,6 +72,10 @@ module Google
         #   @return [::String]
         #     Cloud Identity ID of the customer's channel partner.
         #     Populated only if a channel partner exists for this customer.
+        # @!attribute [rw] correlation_id
+        #   @return [::String]
+        #     Optional. External CRM ID for the customer.
+        #     Populated only if a CRM ID exists for this customer.
         class Customer
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/channel/v1/entitlement_changes.rb

@@ -0,0 +1,182 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Channel
+      module V1
+        # Change event entry for Entitlement order history
+        # @!attribute [rw] suspension_reason
+        #   @return [::Google::Cloud::Channel::V1::Entitlement::SuspensionReason]
+        #     Suspension reason for the Entitlement.
+        # @!attribute [rw] cancellation_reason
+        #   @return [::Google::Cloud::Channel::V1::EntitlementChange::CancellationReason]
+        #     Cancellation reason for the Entitlement.
+        # @!attribute [rw] activation_reason
+        #   @return [::Google::Cloud::Channel::V1::EntitlementChange::ActivationReason]
+        #     The Entitlement's activation reason
+        # @!attribute [rw] other_change_reason
+        #   @return [::String]
+        #     e.g. purchase_number change reason, entered by CRS.
+        # @!attribute [rw] entitlement
+        #   @return [::String]
+        #     Required. Resource name of an entitlement in the form:
+        #     accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
+        # @!attribute [rw] offer
+        #   @return [::String]
+        #     Required. Resource name of the Offer at the time of change.
+        #     Takes the form: accounts/\\{account_id}/offers/\\{offer_id}.
+        # @!attribute [rw] provisioned_service
+        #   @return [::Google::Cloud::Channel::V1::ProvisionedService]
+        #     Service provisioned for an Entitlement.
+        # @!attribute [rw] change_type
+        #   @return [::Google::Cloud::Channel::V1::EntitlementChange::ChangeType]
+        #     The change action type.
+        # @!attribute [rw] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The submitted time of the change.
+        # @!attribute [rw] operator_type
+        #   @return [::Google::Cloud::Channel::V1::EntitlementChange::OperatorType]
+        #     Operator type responsible for the change.
+        # @!attribute [rw] parameters
+        #   @return [::Array<::Google::Cloud::Channel::V1::Parameter>]
+        #     Extended parameters, such as:
+        #     purchase_order_number, gcp_details;
+        #     internal_correlation_id, long_running_operation_id, order_id;
+        #     etc.
+        # @!attribute [rw] operator
+        #   @return [::String]
+        #     Human-readable identifier that shows what operator made a change.
+        #     When the operator_type is RESELLER, this is the user's email address.
+        #     For all other operator types, this is empty.
+        class EntitlementChange
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Specifies the type of change action
+          module ChangeType
+            # Not used.
+            CHANGE_TYPE_UNSPECIFIED = 0
+
+            # New Entitlement was created.
+            CREATED = 1
+
+            # Price plan associated with an Entitlement was changed.
+            PRICE_PLAN_SWITCHED = 3
+
+            # Number of seats committed for a commitment Entitlement was changed.
+            COMMITMENT_CHANGED = 4
+
+            # An annual Entitlement was renewed.
+            RENEWED = 5
+
+            # Entitlement was suspended.
+            SUSPENDED = 6
+
+            # Entitlement was activated.
+            ACTIVATED = 7
+
+            # Entitlement was cancelled.
+            CANCELLED = 8
+
+            # Entitlement was upgraded or downgraded for ex. from Google Workspace
+            # Business Standard to Google Workspace Business Plus.
+            SKU_CHANGED = 9
+
+            # The settings for renewal of an Entitlement have changed.
+            RENEWAL_SETTING_CHANGED = 10
+
+            # Use for Google Workspace subscription.
+            # Either a trial was converted to a paid subscription or a new subscription
+            # with no trial is created.
+            PAID_SUBSCRIPTION_STARTED = 11
+
+            # License cap was changed for the entitlement.
+            LICENSE_CAP_CHANGED = 12
+
+            # The suspension details have changed (but it is still suspended).
+            SUSPENSION_DETAILS_CHANGED = 13
+
+            # The trial end date was extended.
+            TRIAL_END_DATE_EXTENDED = 14
+
+            # Entitlement started trial.
+            TRIAL_STARTED = 15
+          end
+
+          # Specifies the type of operator responsible for the change
+          module OperatorType
+            # Not used.
+            OPERATOR_TYPE_UNSPECIFIED = 0
+
+            # Customer service representative.
+            CUSTOMER_SERVICE_REPRESENTATIVE = 1
+
+            # System auto job.
+            SYSTEM = 2
+
+            # Customer user.
+            CUSTOMER = 3
+
+            # Reseller user.
+            RESELLER = 4
+          end
+
+          # Cancellation reason for the entitlement
+          module CancellationReason
+            # Not used.
+            CANCELLATION_REASON_UNSPECIFIED = 0
+
+            # Reseller triggered a cancellation of the service.
+            SERVICE_TERMINATED = 1
+
+            # Relationship between the reseller and customer has ended due to a
+            # transfer.
+            RELATIONSHIP_ENDED = 2
+
+            # Entitlement transferred away from reseller while still keeping other
+            # entitlement(s) with the reseller.
+            PARTIAL_TRANSFER = 3
+          end
+
+          # The Entitlement's activation reason
+          module ActivationReason
+            # Not used.
+            ACTIVATION_REASON_UNSPECIFIED = 0
+
+            # Reseller reactivated a suspended Entitlement.
+            RESELLER_REVOKED_SUSPENSION = 1
+
+            # Customer accepted pending terms of service.
+            CUSTOMER_ACCEPTED_PENDING_TOS = 2
+
+            # Reseller updated the renewal settings on an entitlement that was
+            # suspended due to cancellation, and this update reactivated the
+            # entitlement.
+            RENEWAL_SETTINGS_CHANGED = 3
+
+            # Other reasons (Activated temporarily for cancellation, added a payment
+            # plan to a trial entitlement, etc.)
+            OTHER_ACTIVATION_REASON = 100
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/channel/v1/entitlements.rb

@@ -69,13 +69,22 @@ module Google
         #     parameter names and values are defined in the
         #     {::Google::Cloud::Channel::V1::Offer#parameter_definitions Offer.parameter_definitions}.
         #
-        #     The response may include the following output-only Parameters:
+        #     For Google Workspace, the following Parameters may be accepted as input:
+        #
+        #     - max_units: The maximum assignable units for a flexible offer
+        #
+        #     OR
+        #
+        #     - num_units: The total commitment for commitment-based offers
+        #
+        #     The response may additionally include the following output-only Parameters:
         #
         #     - assigned_units: The number of licenses assigned to users.
         #
-        #     - max_units: The maximum assignable units for a flexible offer.
+        #     For GCP billing subaccounts, the following Parameter may be accepted as
+        #     input:
         #
-        #     - num_units: The total commitment for commitment-based offers.
+        #     - display_name: The display name of the billing subaccount.
         class Entitlement
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/channel/v1/service.rb

@@ -1125,6 +1125,12 @@ module Google
         #     Optional. The BCP-47 language code. For example, "en-US". The
         #     response will localize in the corresponding language code, if specified.
         #     The default value is "en-US".
+        # @!attribute [rw] show_future_offers
+        #   @return [::Boolean]
+        #     Optional. A boolean flag that determines if a response returns future
+        #     offers 30 days from now. If the show_future_offers is true, the response
+        #     will only contain offers that are scheduled to be available 30 days from
+        #     now.
         class ListOffersRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1391,6 +1397,52 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Request message for
+        # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_entitlement_changes CloudChannelService.ListEntitlementChanges}
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The resource name of the entitlement for which to list
+        #     entitlement changes. The `-` wildcard may be used to match entitlements
+        #     across a customer. Formats:
+        #
+        #       * accounts/\\{account_id}/customers/\\{customer_id}/entitlements/\\{entitlement_id}
+        #       * accounts/\\{account_id}/customers/\\{customer_id}/entitlements/-
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of entitlement changes to return. The service
+        #     may return fewer than this value. If unspecified, returns at most 10
+        #     entitlement changes. The maximum value is 50; the server will coerce values
+        #     above 50.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous
+        #     {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_entitlement_changes CloudChannelService.ListEntitlementChanges}
+        #     call. Provide this to retrieve the subsequent page.
+        #
+        #     When paginating, all other parameters provided to
+        #     {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_entitlement_changes CloudChannelService.ListEntitlementChanges}
+        #     must match the call that provided the page token.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Filters applied to the list results.
+        class ListEntitlementChangesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::Channel::V1::CloudChannelService::Client#list_entitlement_changes CloudChannelService.ListEntitlementChanges}
+        # @!attribute [rw] entitlement_changes
+        #   @return [::Array<::Google::Cloud::Channel::V1::EntitlementChange>]
+        #     The list of entitlement changes.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token to list the next page of results.
+        class ListEntitlementChangesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end