feat: Add support for ListSkuGroups and ListSkuGroupBillableSkus APIs in Cloud Channel APIs

PiperOrigin-RevId: 540624759

google/cloud/channel/v1/service.proto

@@ -1185,6 +1185,59 @@ service CloudChannelService {
     option (google.api.method_signature) = "name";
   }
 
+  // Lists the Rebilling supported SKU groups the account is authorized to
+  // sell.
+  // Reference: https://cloud.google.com/skus/sku-groups
+  //
+  // Possible Error Codes:
+  //
+  // * PERMISSION_DENIED: If the account making the request and the account
+  // being queried are different, or the account doesn't exist.
+  // * INTERNAL: Any non-user error related to technical issues in the
+  // backend. In this case, contact Cloud Channel support.
+  //
+  // Return Value:
+  // If successful, the [SkuGroup][google.cloud.channel.v1.SkuGroup] resources.
+  // The data for each resource is displayed in the alphabetical order of SKU
+  // group display name.
+  // The data for each resource is displayed in the ascending order of
+  // [SkuGroup.display_name][google.cloud.channel.v1.SkuGroup.display_name]
+  //
+  // If unsuccessful, returns an error.
+  rpc ListSkuGroups(ListSkuGroupsRequest) returns (ListSkuGroupsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=accounts/*}/skuGroups"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Lists the Billable SKUs in a given SKU group.
+  //
+  // Possible error codes:
+  // PERMISSION_DENIED: If the account making the request and the account
+  // being queried for are different, or the account doesn't exist.
+  // INVALID_ARGUMENT: Missing or invalid required parameters in the
+  // request.
+  // INTERNAL: Any non-user error related to technical issue in the
+  // backend. In this case, contact cloud channel support.
+  //
+  // Return Value:
+  // If successful, the [BillableSku][google.cloud.channel.v1.BillableSku]
+  // resources. The data for each resource is displayed in the ascending order
+  // of:
+  //
+  // * [BillableSku.service_display_name][google.cloud.channel.v1.BillableSku.service_display_name]
+  // * [BillableSku.sku_display_name][google.cloud.channel.v1.BillableSku.sku_display_name]
+  //
+  // If unsuccessful, returns an error.
+  rpc ListSkuGroupBillableSkus(ListSkuGroupBillableSkusRequest)
+      returns (ListSkuGroupBillableSkusResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=accounts/*/skuGroups/*}/billableSkus"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
   // Returns the requested [Offer][google.cloud.channel.v1.Offer] resource.
   //
   // Possible error codes:
@@ -2035,6 +2088,110 @@ message DeleteChannelPartnerRepricingConfigRequest {
   ];
 }
 
+// Request message for ListSkuGroups.
+message ListSkuGroupsRequest {
+  // Required. The resource name of the account from which to list SKU groups.
+  // Parent uses the format: accounts/{account}.
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The maximum number of SKU groups to return. The service may
+  // return fewer than this value. If unspecified, returns a maximum of 1000 SKU
+  // groups. The maximum value is 1000; values above 1000 will be coerced to
+  // 1000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A token identifying a page of results beyond the first page.
+  // Obtained through
+  // [ListSkuGroups.next_page_token][] of the previous
+  // [CloudChannelService.ListSkuGroups][google.cloud.channel.v1.CloudChannelService.ListSkuGroups]
+  // call.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Request message for ListSkuGroupBillableSkus.
+message ListSkuGroupBillableSkusRequest {
+  // Required. Resource name of the SKU group.
+  // Format: accounts/{account}/skuGroups/{sku_group}.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudchannel.googleapis.com/SkuGroup"
+    }
+  ];
+
+  // Optional. The maximum number of SKUs to return. The service may return
+  // fewer than this value. If unspecified, returns a maximum of 100000 SKUs.
+  // The maximum value is 100000; values above 100000 will be coerced to 100000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A token identifying a page of results beyond the first page.
+  // Obtained through
+  // [ListSkuGroupBillableSkus.next_page_token][] of the previous
+  // [CloudChannelService.ListSkuGroupBillableSkus][google.cloud.channel.v1.CloudChannelService.ListSkuGroupBillableSkus]
+  // call.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for ListSkuGroups.
+message ListSkuGroupsResponse {
+  // The list of SKU groups requested.
+  repeated SkuGroup sku_groups = 1;
+
+  // A token to retrieve the next page of results.
+  // Pass to [ListSkuGroups.page_token][] to obtain that
+  // page.
+  string next_page_token = 2;
+}
+
+// Response message for ListSkuGroupBillableSkus.
+message ListSkuGroupBillableSkusResponse {
+  // The list of billable SKUs in the requested SKU group.
+  repeated BillableSku billable_skus = 1;
+
+  // A token to retrieve the next page of results.
+  // Pass to [ListSkuGroupBillableSkus.page_token][] to obtain that
+  // page.
+  string next_page_token = 2;
+}
+
+// Represents the SKU group information.
+message SkuGroup {
+  option (google.api.resource) = {
+    type: "cloudchannel.googleapis.com/SkuGroup"
+    pattern: "accounts/{account}/skuGroups/{sku_group}"
+  };
+
+  // Resource name of SKU group. Format:
+  // accounts/{account}/skuGroups/{sku_group}.
+  // Example:
+  // "accounts/C01234/skuGroups/3d50fd57-3157-4577-a5a9-a219b8490041".
+  string name = 1;
+
+  // Unique human readable identifier for the SKU group.
+  string display_name = 2;
+}
+
+// Represents the Billable SKU information.
+message BillableSku {
+  // Resource name of Billable SKU. Format:
+  // billableSkus/{sku}.
+  // Example:
+  // billableSkus/6E1B-6634-470F".
+  string sku = 1;
+
+  // Unique human readable name for the SKU.
+  string sku_display_name = 2;
+
+  // Resource name of Service which contains Repricing SKU. Format:
+  // services/{service}.
+  // Example:
+  // "services/B7D9-FDCB-15D8".
+  string service = 3;
+
+  // Unique human readable name for the Service.
+  string service_display_name = 4;
+}
+
 // Request message for
 // [CloudChannelService.CreateEntitlement][google.cloud.channel.v1.CloudChannelService.CreateEntitlement]
 message CreateEntitlementRequest {