fix: Changed field behavior for an existing field entitlement_granularity in message .google.cloud.channel.v1.RepricingConfig

Google APIs · copybara-github · commit 1c1b1ff7874a · 2025-12-01T12:36:26.000-08:00
docs: A comment for enum `CustomerAttestationState` is changed
docs: A comment for field `customer_attestation_state` in message `.google.cloud.channel.v1.Customer` is changed
docs: A comment for field `entitlement_granularity` in message `.google.cloud.channel.v1.RepricingConfig` is changed
docs: A comment for method `RegisterSubscriber` in service `CloudChannelService` is changed
docs: A comment for method `UnregisterSubscriber` in service `CloudChannelService` is changed
docs: A comment for method `ListSubscribers` in service `CloudChannelService` is changed
docs: A comment for field `owned` in message `.google.cloud.channel.v1.CloudIdentityCustomerAccount` is changed
docs: A comment for field `page_token` in message `.google.cloud.channel.v1.ListSkuGroupsRequest` is changed
docs: A comment for field `page_token` in message `.google.cloud.channel.v1.ListSkuGroupBillableSkusRequest` is changed
docs: A comment for field `next_page_token` in message `.google.cloud.channel.v1.ListSkuGroupsResponse` is changed
docs: A comment for field `next_page_token` in message `.google.cloud.channel.v1.ListSkuGroupBillableSkusResponse` is changed
docs: A comment for message `ChangeParametersRequest` is changed
docs: A comment for field `offers` in message `.google.cloud.channel.v1.ListOffersResponse` is changed
docs: A comment for field `account` in message `.google.cloud.channel.v1.RegisterSubscriberRequest` is changed
docs: A comment for field `account` in message `.google.cloud.channel.v1.UnregisterSubscriberRequest` is changed
docs: A comment for field `account` in message `.google.cloud.channel.v1.ListSubscribersRequest` is changed
docs: A comment for field `event_type` in message `.google.cloud.channel.v1.CustomerEvent` is changed
docs: A comment for field `event_type` in message `.google.cloud.channel.v1.EntitlementEvent` is changed

PiperOrigin-RevId: 838889186
diff --git a/google/cloud/channel/v1/customers.proto b/google/cloud/channel/v1/customers.proto
@@ -34,7 +34,7 @@ message Customer {
     pattern: "accounts/{account}/customers/{customer}"
   };
 
-  // The enum represents whether a customer belongs to public sector
+  // The enum represents if a customer belongs to public sector
   enum CustomerAttestationState {
     // Default value if not set yet
     CUSTOMER_ATTESTATION_STATE_UNSPECIFIED = 0;
@@ -107,7 +107,7 @@ message Customer {
   // Populated only if a CRM ID exists for this customer.
   string correlation_id = 14 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. Indicate whether a customer is attesting about the correctness of
+  // Optional. Indicate if a customer is attesting about the correctness of
   // provided information. Only required if creating a GCP Entitlement.
   CustomerAttestationState customer_attestation_state = 16
       [(google.api.field_behavior) = OPTIONAL];
diff --git a/google/cloud/channel/v1/entitlements.proto b/google/cloud/channel/v1/entitlements.proto
@@ -147,6 +147,11 @@ message Entitlement {
   // Optional. The billing account resource name that is used to pay for this
   // entitlement.
   string billing_account = 28 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Price reference ID for the offer. Only for offers that require
+  // additional price information. Used to guarantee that the pricing is
+  // consistent between quoting the offer and placing the order.
+  string price_reference_id = 29 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Definition for extended entitlement parameters.
diff --git a/google/cloud/channel/v1/offers.proto b/google/cloud/channel/v1/offers.proto
@@ -123,6 +123,27 @@ enum PeriodType {
   YEAR = 3;
 }
 
+// Discount Type.
+enum DiscountType {
+  // Not used.
+  DISCOUNT_TYPE_UNSPECIFIED = 0;
+
+  // Regional discount.
+  REGIONAL_DISCOUNT = 1;
+
+  // Promotional discount.
+  PROMOTIONAL_DISCOUNT = 2;
+
+  // Sales-provided discount.
+  SALES_DISCOUNT = 3;
+
+  // Reseller margin.
+  RESELLER_MARGIN = 4;
+
+  // Deal code discount.
+  DEAL_CODE = 5;
+}
+
 // Represents an offer made to resellers for purchase.
 // An offer is associated with a [Sku][google.cloud.channel.v1.Sku], has a plan
 // for payment, a price, and defines the constraints for buying.
@@ -279,8 +300,17 @@ message Price {
   // Effective Price after applying the discounts.
   google.type.Money effective_price = 3;
 
+  // The time period with respect to which base and effective prices are
+  // defined.
+  // Example: 1 month, 6 months, 1 year, etc.
+  Period price_period = 6;
+
   // Link to external price list, such as link to Google Voice rate card.
   string external_price_uri = 4;
+
+  // Breakdown of the discount into its components.
+  // This will be empty if there is no discount present.
+  repeated DiscountComponent discount_components = 5;
 }
 
 // Specifies the price by the duration of months.
@@ -330,3 +360,20 @@ message Period {
   // Period Type.
   PeriodType period_type = 2;
 }
+
+// Represents a single component of the total discount applicable on a Price.
+message DiscountComponent {
+  // Specifies the contribution of this discount component to the total
+  // discount.
+  oneof discount_value {
+    // Discount percentage, represented as decimal.
+    // For example, a 20% discount will be represented as 0.2.
+    double discount_percentage = 3;
+
+    // Fixed value discount.
+    google.type.Money discount_absolute = 4;
+  }
+
+  // Type of the discount.
+  DiscountType discount_type = 2;
+}
diff --git a/google/cloud/channel/v1/repricing.proto b/google/cloud/channel/v1/repricing.proto
@@ -115,7 +115,7 @@ message RepricingConfig {
 
   // Required. Defines the granularity for repricing.
   oneof granularity {
-    // Applies the repricing configuration at the entitlement level.
+    // Required. Applies the repricing configuration at the entitlement level.
     //
     // Note: If a
     // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig]
@@ -129,7 +129,8 @@ message RepricingConfig {
     // [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig]
     // and
     // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig].
-    EntitlementGranularity entitlement_granularity = 4;
+    EntitlementGranularity entitlement_granularity = 4
+        [(google.api.field_behavior) = REQUIRED];
 
     // Applies the repricing configuration at the channel partner level.
     // Only
diff --git a/google/cloud/channel/v1/service.proto b/google/cloud/channel/v1/service.proto
@@ -38,6 +38,10 @@ option go_package = "cloud.google.com/go/channel/apiv1/channelpb;channelpb";
 option java_multiple_files = true;
 option java_outer_classname = "ServiceProto";
 option java_package = "com.google.cloud.channel.v1";
+option (google.api.resource_definition) = {
+  type: "cloudchannel.googleapis.com/Account"
+  pattern: "accounts/{account}"
+};
 
 // CloudChannelService lets Google cloud resellers and distributors manage
 // their customers, channel partners, entitlements, and reports.
@@ -1361,8 +1365,8 @@ service CloudChannelService {
     };
   }
 
-  // Registers a service account with subscriber privileges on the Cloud Pub/Sub
-  // topic for this Channel Services account. After you create a
+  // Registers a service account with subscriber privileges on the Pub/Sub
+  // topic for this Channel Services account or integrator. After you create a
   // subscriber, you get the events through
   // [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
   //
@@ -1384,13 +1388,17 @@ service CloudChannelService {
     option (google.api.http) = {
       post: "/v1/{account=accounts/*}:register"
       body: "*"
+      additional_bindings {
+        post: "/v1/{integrator=integrators/*}:registerSubscriber"
+        body: "*"
+      }
     };
   }
 
-  // Unregisters a service account with subscriber privileges on the Cloud
-  // Pub/Sub topic created for this Channel Services account. If there are no
-  // service accounts left with subscriber privileges, this deletes the topic.
-  // You can call ListSubscribers to check for these accounts.
+  // Unregisters a service account with subscriber privileges on the Pub/Sub
+  // topic created for this Channel Services account or integrator. If there are
+  // no service accounts left with subscriber privileges, this deletes the
+  // topic. You can call ListSubscribers to check for these accounts.
   //
   // Possible error codes:
   //
@@ -1413,11 +1421,15 @@ service CloudChannelService {
     option (google.api.http) = {
       post: "/v1/{account=accounts/*}:unregister"
       body: "*"
+      additional_bindings {
+        post: "/v1/{integrator=integrators/*}:unregisterSubscriber"
+        body: "*"
+      }
     };
   }
 
-  // Lists service accounts with subscriber privileges on the Cloud Pub/Sub
-  // topic created for this Channel Services account.
+  // Lists service accounts with subscriber privileges on the Pub/Sub topic
+  // created for this Channel Services account or integrator.
   //
   // Possible error codes:
   //
@@ -1437,6 +1449,9 @@ service CloudChannelService {
       returns (ListSubscribersResponse) {
     option (google.api.http) = {
       get: "/v1/{account=accounts/*}:listSubscribers"
+      additional_bindings {
+        get: "/v1/{integrator=integrators/*}:listSubscribers"
+      }
     };
   }
 
@@ -1489,7 +1504,8 @@ message CloudIdentityCustomerAccount {
   bool existing = 1;
 
   // Returns true if the Cloud Identity account is associated with a customer
-  // of the Channel Services partner.
+  // of the Channel Services partner (with active subscriptions or purchase
+  // consents).
   bool owned = 2;
 
   // If owned = true, the name of the customer that owns the Cloud Identity
@@ -1843,6 +1859,11 @@ message ListTransferableOffersResponse {
 message TransferableOffer {
   // Offer with parameter constraints updated to allow the Transfer.
   Offer offer = 1;
+
+  // Optional. Price reference ID for the offer. Only for offers that require
+  // additional price information. Used to guarantee that the pricing is
+  // consistent between quoting the offer and placing the order.
+  string price_reference_id = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for
@@ -2167,7 +2188,8 @@ message ListSkuGroupsRequest {
 
   // Optional. A token identifying a page of results beyond the first page.
   // Obtained through
-  // [ListSkuGroups.next_page_token][] of the previous
+  // [ListSkuGroupsResponse.next_page_token][google.cloud.channel.v1.ListSkuGroupsResponse.next_page_token]
+  // of the previous
   // [CloudChannelService.ListSkuGroups][google.cloud.channel.v1.CloudChannelService.ListSkuGroups]
   // call.
   string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
@@ -2191,7 +2213,8 @@ message ListSkuGroupBillableSkusRequest {
 
   // Optional. A token identifying a page of results beyond the first page.
   // Obtained through
-  // [ListSkuGroupBillableSkus.next_page_token][] of the previous
+  // [ListSkuGroupBillableSkusResponse.next_page_token][google.cloud.channel.v1.ListSkuGroupBillableSkusResponse.next_page_token]
+  // of the previous
   // [CloudChannelService.ListSkuGroupBillableSkus][google.cloud.channel.v1.CloudChannelService.ListSkuGroupBillableSkus]
   // call.
   string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
@@ -2203,8 +2226,9 @@ message ListSkuGroupsResponse {
   repeated SkuGroup sku_groups = 1;
 
   // A token to retrieve the next page of results.
-  // Pass to [ListSkuGroups.page_token][] to obtain that
-  // page.
+  // Pass to
+  // [ListSkuGroupsRequest.page_token][google.cloud.channel.v1.ListSkuGroupsRequest.page_token]
+  // to obtain that page.
   string next_page_token = 2;
 }
 
@@ -2214,8 +2238,9 @@ message ListSkuGroupBillableSkusResponse {
   repeated BillableSku billable_skus = 1;
 
   // A token to retrieve the next page of results.
-  // Pass to [ListSkuGroupBillableSkus.page_token][] to obtain that
-  // page.
+  // Pass to
+  // [ListSkuGroupBillableSkusRequest.page_token][google.cloud.channel.v1.ListSkuGroupBillableSkusRequest.page_token]
+  // to obtain that page.
   string next_page_token = 2;
 }
 
@@ -2356,7 +2381,8 @@ message TransferEntitlementsToGoogleRequest {
   string request_id = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Request message for [CloudChannelService.ChangeParametersRequest][].
+// Request message for
+// [CloudChannelService.ChangeParameters][google.cloud.channel.v1.CloudChannelService.ChangeParameters].
 message ChangeParametersRequest {
   // Required. The name of the entitlement to update.
   // Name uses the format:
@@ -2461,6 +2487,11 @@ message ChangeOfferRequest {
   // This field is only relevant for multi-currency accounts. It should be
   // left empty for single currency accounts.
   string billing_account = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Price reference ID for the offer. Only for offers that require
+  // additional price information. Used to guarantee that the pricing is
+  // consistent between quoting the offer and placing the order.
+  string price_reference_id = 8 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for
@@ -2673,6 +2704,9 @@ message ListOffersRequest {
 // Response message for ListOffers.
 message ListOffersResponse {
   // The list of Offers requested.
+  //
+  // The pricing information for each Offer only includes the base price.
+  // Effective prices and discounts aren't populated.
   repeated Offer offers = 1;
 
   // A token to retrieve the next page of results.
@@ -2843,6 +2877,11 @@ message ListPurchasableOffersResponse {
 message PurchasableOffer {
   // Offer.
   Offer offer = 1;
+
+  // Optional. Price reference ID for the offer. Only for offers that require
+  // additional price information. Used to guarantee that the pricing is
+  // consistent between quoting the offer and placing the order.
+  string price_reference_id = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for QueryEligibleBillingAccounts.
@@ -2889,12 +2928,22 @@ message BillingAccountPurchaseInfo {
 
 // Request Message for RegisterSubscriber.
 message RegisterSubscriberRequest {
-  // Required. Resource name of the account.
-  string account = 1 [(google.api.field_behavior) = REQUIRED];
+  // Optional. Resource name of the account. Required if integrator is not
+  // provided. Otherwise, leave this field empty/unset.
+  string account = 1 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "cloudchannel.googleapis.com/Account"
+    }
+  ];
 
   // Required. Service account that provides subscriber access to the registered
   // topic.
   string service_account = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Resource name of the integrator. Required if account is not
+  // provided. Otherwise, leave this field empty/unset.
+  optional string integrator = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response Message for RegisterSubscriber.
@@ -2905,12 +2954,22 @@ message RegisterSubscriberResponse {
 
 // Request Message for UnregisterSubscriber.
 message UnregisterSubscriberRequest {
-  // Required. Resource name of the account.
-  string account = 1 [(google.api.field_behavior) = REQUIRED];
+  // Optional. Resource name of the account. Required if integrator is not
+  // provided. Otherwise, leave this field empty/unset.
+  string account = 1 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "cloudchannel.googleapis.com/Account"
+    }
+  ];
 
   // Required. Service account to unregister from subscriber access to the
   // topic.
   string service_account = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Resource name of the integrator. Required if account is not
+  // provided. Otherwise, leave this field empty/unset.
+  optional string integrator = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response Message for UnregisterSubscriber.
@@ -2921,8 +2980,14 @@ message UnregisterSubscriberResponse {
 
 // Request Message for ListSubscribers.
 message ListSubscribersRequest {
-  // Required. Resource name of the account.
-  string account = 1 [(google.api.field_behavior) = REQUIRED];
+  // Optional. Resource name of the account. Required if integrator is not
+  // provided. Otherwise, leave this field empty/unset.
+  string account = 1 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "cloudchannel.googleapis.com/Account"
+    }
+  ];
 
   // Optional. The maximum number of service accounts to return. The service may
   // return fewer than this value. If unspecified, returns at most 100 service
@@ -2936,6 +3001,10 @@ message ListSubscribersRequest {
   // When paginating, all other parameters provided to `ListSubscribers` must
   // match the call that provided the page token.
   string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Resource name of the integrator. Required if account is not
+  // provided. Otherwise, leave this field empty/unset.
+  optional string integrator = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response Message for ListSubscribers.
diff --git a/google/cloud/channel/v1/subscriber_event.proto b/google/cloud/channel/v1/subscriber_event.proto
@@ -43,7 +43,7 @@ message CustomerEvent {
     type: "cloudchannel.googleapis.com/Customer"
   }];
 
-  // Type of event which happened on the customer.
+  // Type of event which happened for the customer.
   Type event_type = 2;
 }
 
@@ -100,7 +100,7 @@ message EntitlementEvent {
     type: "cloudchannel.googleapis.com/Entitlement"
   }];
 
-  // Type of event which happened on the entitlement.
+  // Type of event which happened for the entitlement.
   Type event_type = 2;
 }
 

Original file line number	Diff line number	Diff line change
`@@ -43,7 +43,7 @@ message CustomerEvent {`
`43`	`43`	`type: "cloudchannel.googleapis.com/Customer"`
`44`	`44`	`}];`
`45`	`45`
`46`		`- // Type of event which happened on the customer.`
	`46`	`+ // Type of event which happened for the customer.`
`47`	`47`	`Type event_type = 2;`
`48`	`48`	`}`
`49`	`49`
`@@ -100,7 +100,7 @@ message EntitlementEvent {`
`100`	`100`	`type: "cloudchannel.googleapis.com/Entitlement"`
`101`	`101`	`}];`
`102`	`102`
`103`		`- // Type of event which happened on the entitlement.`
	`103`	`+ // Type of event which happened for the entitlement.`
`104`	`104`	`Type event_type = 2;`
`105`	`105`	`}`
`106`	`106`