From e69c47f438eb55caec51716fbc2b8a42313ca024 Mon Sep 17 00:00:00 2001 From: Google APIs Date: Fri, 9 Dec 2022 08:12:00 -0800 Subject: [PATCH] feat: Add support for granular repricing configurations via SkuGroups in Cloud Channel Repricing APIs PiperOrigin-RevId: 494176375 --- .../channel/v1/channel_partner_links.proto | 25 +- google/cloud/channel/v1/common.proto | 2 +- google/cloud/channel/v1/customers.proto | 14 +- google/cloud/channel/v1/entitlements.proto | 64 +- google/cloud/channel/v1/offers.proto | 9 +- google/cloud/channel/v1/operations.proto | 5 +- google/cloud/channel/v1/products.proto | 2 +- google/cloud/channel/v1/reports_service.proto | 97 ++- google/cloud/channel/v1/repricing.proto | 89 +- google/cloud/channel/v1/service.proto | 795 +++++++++++------- .../cloud/channel/v1/subscriber_event.proto | 10 +- 11 files changed, 692 insertions(+), 420 deletions(-) diff --git a/google/cloud/channel/v1/channel_partner_links.proto b/google/cloud/channel/v1/channel_partner_links.proto index fb301586ea..d0607af278 100644 --- a/google/cloud/channel/v1/channel_partner_links.proto +++ b/google/cloud/channel/v1/channel_partner_links.proto @@ -26,7 +26,9 @@ option java_multiple_files = true; option java_outer_classname = "ChannelPartnerLinksProto"; option java_package = "com.google.cloud.channel.v1"; -// The level of granularity the [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] will display. +// The level of granularity the +// [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] will +// display. enum ChannelPartnerLinkView { // The default / unset value. // The API will default to the BASIC view. @@ -72,24 +74,29 @@ message ChannelPartnerLink { string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Required. Cloud Identity ID of the linked reseller. - string reseller_cloud_identity_id = 2 [(google.api.field_behavior) = REQUIRED]; + string reseller_cloud_identity_id = 2 + [(google.api.field_behavior) = REQUIRED]; // Required. State of the channel partner link. - ChannelPartnerLinkState link_state = 3 [(google.api.field_behavior) = REQUIRED]; + ChannelPartnerLinkState link_state = 3 + [(google.api.field_behavior) = REQUIRED]; // Output only. URI of the web page where partner accepts the link invitation. string invite_link_uri = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Timestamp of when the channel partner link is created. - google.protobuf.Timestamp create_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + google.protobuf.Timestamp create_time = 5 + [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Timestamp of when the channel partner link is updated. - google.protobuf.Timestamp update_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + google.protobuf.Timestamp update_time = 6 + [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. Public identifier that a customer must use to generate a transfer token - // to move to this distributor-reseller combination. + // Output only. Public identifier that a customer must use to generate a + // transfer token to move to this distributor-reseller combination. string public_id = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Cloud Identity info of the channel partner (IR). - CloudIdentityInfo channel_partner_cloud_identity_info = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; -} + CloudIdentityInfo channel_partner_cloud_identity_info = 8 + [(google.api.field_behavior) = OUTPUT_ONLY]; +} \ No newline at end of file diff --git a/google/cloud/channel/v1/common.proto b/google/cloud/channel/v1/common.proto index 175d044e63..2380722ac8 100644 --- a/google/cloud/channel/v1/common.proto +++ b/google/cloud/channel/v1/common.proto @@ -149,4 +149,4 @@ message AdminUser { // Family name of the admin user. string family_name = 3; -} +} \ No newline at end of file diff --git a/google/cloud/channel/v1/customers.proto b/google/cloud/channel/v1/customers.proto index e34432f2e6..18bf1ad99a 100644 --- a/google/cloud/channel/v1/customers.proto +++ b/google/cloud/channel/v1/customers.proto @@ -45,7 +45,8 @@ message Customer { // embargoes, we require a region and zip code. You must provide valid // addresses for every customer. To set the customer's language, use the // Customer-level language code. - google.type.PostalAddress org_postal_address = 3 [(google.api.field_behavior) = REQUIRED]; + google.type.PostalAddress org_postal_address = 3 + [(google.api.field_behavior) = REQUIRED]; // Primary contact info. ContactInfo primary_contact_info = 4; @@ -62,10 +63,12 @@ message Customer { string domain = 6 [(google.api.field_behavior) = REQUIRED]; // Output only. Time when the customer was created. - google.protobuf.Timestamp create_time = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + google.protobuf.Timestamp create_time = 7 + [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Time when the customer was updated. - google.protobuf.Timestamp update_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + google.protobuf.Timestamp update_time = 8 + [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The customer's Cloud Identity ID if the customer has a Cloud // Identity resource. @@ -78,7 +81,8 @@ message Customer { // Output only. Cloud Identity information for the customer. // Populated only if a Cloud Identity account exists for this customer. - CloudIdentityInfo cloud_identity_info = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; + CloudIdentityInfo cloud_identity_info = 12 + [(google.api.field_behavior) = OUTPUT_ONLY]; // Cloud Identity ID of the customer's channel partner. // Populated only if a channel partner exists for this customer. @@ -107,4 +111,4 @@ message ContactInfo { // The customer account's contact phone number. string phone = 7; -} +} \ No newline at end of file diff --git a/google/cloud/channel/v1/entitlements.proto b/google/cloud/channel/v1/entitlements.proto index 35da239384..8a6633b140 100644 --- a/google/cloud/channel/v1/entitlements.proto +++ b/google/cloud/channel/v1/entitlements.proto @@ -47,7 +47,9 @@ message Entitlement { SUSPENDED = 5; } - // Suspension reason for an entitlement if [provisioning_state][google.cloud.channel.v1.Entitlement.provisioning_state] = SUSPENDED. + // Suspension reason for an entitlement if + // [provisioning_state][google.cloud.channel.v1.Entitlement.provisioning_state] + // = SUSPENDED. enum SuspensionReason { // Not used. SUSPENSION_REASON_UNSPECIFIED = 0; @@ -74,10 +76,12 @@ message Entitlement { string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The time at which the entitlement is created. - google.protobuf.Timestamp create_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + google.protobuf.Timestamp create_time = 5 + [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The time at which the entitlement is updated. - google.protobuf.Timestamp update_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + google.protobuf.Timestamp update_time = 6 + [(google.api.field_behavior) = OUTPUT_ONLY]; // Required. The offer resource name for which the entitlement is to be // created. Takes the form: accounts/{account_id}/offers/{offer_id}. @@ -93,19 +97,23 @@ message Entitlement { CommitmentSettings commitment_settings = 12; // Output only. Current provisioning state of the entitlement. - ProvisioningState provisioning_state = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; + ProvisioningState provisioning_state = 13 + [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Service provisioning details for the entitlement. - ProvisionedService provisioned_service = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; + ProvisionedService provisioned_service = 16 + [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. Enumerable of all current suspension reasons for an entitlement. - repeated SuspensionReason suspension_reasons = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; + // Output only. Enumerable of all current suspension reasons for an + // entitlement. + repeated SuspensionReason suspension_reasons = 18 + [(google.api.field_behavior) = OUTPUT_ONLY]; - // Optional. This purchase order (PO) information is for resellers to use for their - // company tracking usage. If a purchaseOrderId value is given, it appears in - // the API responses and shows up in the invoice. The property accepts up to - // 80 plain text characters. This is only supported for Google Workspace - // entitlements. + // Optional. This purchase order (PO) information is for resellers to use for + // their company tracking usage. If a purchaseOrderId value is given, it + // appears in the API responses and shows up in the invoice. The property + // accepts up to 80 plain text characters. This is only supported for Google + // Workspace entitlements. string purchase_order_id = 19 [(google.api.field_behavior) = OPTIONAL]; // Output only. Settings for trial offers. @@ -136,9 +144,9 @@ message Parameter { // Value of the parameter. Value value = 2; - // Output only. Specifies whether this parameter is allowed to be changed. For example, for - // a Google Workspace Business Starter entitlement in commitment plan, - // num_units is editable when entitlement is active. + // Output only. Specifies whether this parameter is allowed to be changed. For + // example, for a Google Workspace Business Starter entitlement in commitment + // plan, num_units is editable when entitlement is active. bool editable = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } @@ -146,32 +154,35 @@ message Parameter { message AssociationInfo { // The name of the base entitlement, for which this entitlement is an add-on. string base_entitlement = 1 [(google.api.resource_reference) = { - type: "cloudchannel.googleapis.com/Entitlement" - }]; + type: "cloudchannel.googleapis.com/Entitlement" + }]; } // Service provisioned for an entitlement. message ProvisionedService { - // Output only. Provisioning ID of the entitlement. For Google Workspace, this is the - // underlying Subscription ID. For Google Cloud Platform, this is the + // Output only. Provisioning ID of the entitlement. For Google Workspace, this + // is the underlying Subscription ID. For Google Cloud Platform, this is the // Billing Account ID of the billing subaccount." string provisioning_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. The product pertaining to the provisioning resource as specified in the - // Offer. + // Output only. The product pertaining to the provisioning resource as + // specified in the Offer. string product_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. The SKU pertaining to the provisioning resource as specified in the Offer. + // Output only. The SKU pertaining to the provisioning resource as specified + // in the Offer. string sku_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Commitment settings for commitment-based offers. message CommitmentSettings { // Output only. Commitment start timestamp. - google.protobuf.Timestamp start_time = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + google.protobuf.Timestamp start_time = 1 + [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Commitment end timestamp. - google.protobuf.Timestamp end_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + google.protobuf.Timestamp end_time = 2 + [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. Renewal settings applicable for a commitment-based Offer. RenewalSettings renewal_settings = 4 [(google.api.field_behavior) = OPTIONAL]; @@ -218,7 +229,8 @@ message TransferableSku { // The SKU pertaining to the provisioning resource as specified in the Offer. Sku sku = 11; - // Optional. The customer to transfer has an entitlement with the populated legacy SKU. + // Optional. The customer to transfer has an entitlement with the populated + // legacy SKU. Sku legacy_sku = 12 [(google.api.field_behavior) = OPTIONAL]; } @@ -247,4 +259,4 @@ message TransferEligibility { // Specified the reason for ineligibility. Reason ineligibility_reason = 3; -} +} \ No newline at end of file diff --git a/google/cloud/channel/v1/offers.proto b/google/cloud/channel/v1/offers.proto index ebe698e1f5..3a50404535 100644 --- a/google/cloud/channel/v1/offers.proto +++ b/google/cloud/channel/v1/offers.proto @@ -125,8 +125,8 @@ enum PeriodType { } // 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. +// 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. message Offer { option (google.api.resource) = { type: "cloudchannel.googleapis.com/Offer" @@ -156,7 +156,8 @@ message Offer { google.protobuf.Timestamp start_time = 7; // Output only. End of the Offer validity time. - google.protobuf.Timestamp end_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + google.protobuf.Timestamp end_time = 8 + [(google.api.field_behavior) = OUTPUT_ONLY]; // Parameters required to use current Offer to purchase. repeated ParameterDefinition parameter_definitions = 9; @@ -326,4 +327,4 @@ message Period { // Period Type. PeriodType period_type = 2; -} +} \ No newline at end of file diff --git a/google/cloud/channel/v1/operations.proto b/google/cloud/channel/v1/operations.proto index ad432919bf..e9e190772c 100644 --- a/google/cloud/channel/v1/operations.proto +++ b/google/cloud/channel/v1/operations.proto @@ -21,7 +21,8 @@ option java_multiple_files = true; option java_outer_classname = "OperationsProto"; option java_package = "com.google.cloud.channel.v1"; -// Provides contextual information about a [google.longrunning.Operation][google.longrunning.Operation]. +// Provides contextual information about a +// [google.longrunning.Operation][google.longrunning.Operation]. message OperationMetadata { // RPCs that return a Long Running Operation. enum OperationType { @@ -64,4 +65,4 @@ message OperationMetadata { // The RPC that initiated this Long Running Operation. OperationType operation_type = 1; -} +} \ No newline at end of file diff --git a/google/cloud/channel/v1/products.proto b/google/cloud/channel/v1/products.proto index 8dc39767a9..411e1698b9 100644 --- a/google/cloud/channel/v1/products.proto +++ b/google/cloud/channel/v1/products.proto @@ -91,4 +91,4 @@ message Media { // Type of the media. MediaType type = 3; -} +} \ No newline at end of file diff --git a/google/cloud/channel/v1/reports_service.proto b/google/cloud/channel/v1/reports_service.proto index 464061766c..1cb87124cb 100644 --- a/google/cloud/channel/v1/reports_service.proto +++ b/google/cloud/channel/v1/reports_service.proto @@ -38,7 +38,8 @@ option java_package = "com.google.cloud.channel.v1"; // Google Workspace.) service CloudChannelReportsService { option (google.api.default_host) = "cloudchannel.googleapis.com"; - option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/apps.reports.usage.readonly"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/apps.reports.usage.readonly"; // Begins generation of data for a given report. The report // identifier is a UID (for example, `613bf59q`). @@ -62,7 +63,8 @@ service CloudChannelReportsService { // instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. // // To get the results of report generation, call - // [CloudChannelReportsService.FetchReportResults][google.cloud.channel.v1.CloudChannelReportsService.FetchReportResults] with the + // [CloudChannelReportsService.FetchReportResults][google.cloud.channel.v1.CloudChannelReportsService.FetchReportResults] + // with the // [RunReportJobResponse.report_job][google.cloud.channel.v1.RunReportJobResponse.report_job]. rpc RunReportJob(RunReportJobRequest) returns (google.longrunning.Operation) { option (google.api.http) = { @@ -75,8 +77,10 @@ service CloudChannelReportsService { }; } - // Retrieves data generated by [CloudChannelReportsService.RunReportJob][google.cloud.channel.v1.CloudChannelReportsService.RunReportJob]. - rpc FetchReportResults(FetchReportResultsRequest) returns (FetchReportResultsResponse) { + // Retrieves data generated by + // [CloudChannelReportsService.RunReportJob][google.cloud.channel.v1.CloudChannelReportsService.RunReportJob]. + rpc FetchReportResults(FetchReportResultsRequest) + returns (FetchReportResultsResponse) { option (google.api.http) = { post: "/v1/{report_job=accounts/*/reportJobs/*}:fetchReportResults" body: "*" @@ -94,10 +98,11 @@ service CloudChannelReportsService { } } -// Request message for [CloudChannelReportsService.RunReportJob][google.cloud.channel.v1.CloudChannelReportsService.RunReportJob]. +// Request message for +// [CloudChannelReportsService.RunReportJob][google.cloud.channel.v1.CloudChannelReportsService.RunReportJob]. message RunReportJobRequest { - // Required. The report's resource name. Specifies the account and report used to - // generate report data. The report_id identifier is a UID (for example, + // Required. The report's resource name. Specifies the account and report used + // to generate report data. The report_id identifier is a UID (for example, // `613bf59q`). // Name uses the format: // accounts/{account_id}/reports/{report_id} @@ -111,8 +116,8 @@ message RunReportJobRequest { // Optional. The range of usage or invoice dates to include in the result. DateRange date_range = 2 [(google.api.field_behavior) = OPTIONAL]; - // Optional. A structured string that defines conditions on dimension columns to - // restrict the report output. + // Optional. A structured string that defines conditions on dimension columns + // to restrict the report output. // // Filters support logical operators (AND, OR, NOT) and conditional operators // (=, !=, <, >, <=, and >=) using `column_id` as keys. @@ -130,9 +135,11 @@ message RunReportJobRequest { string language_code = 4 [(google.api.field_behavior) = OPTIONAL]; } -// Response message for [CloudChannelReportsService.RunReportJob][google.cloud.channel.v1.CloudChannelReportsService.RunReportJob]. +// Response message for +// [CloudChannelReportsService.RunReportJob][google.cloud.channel.v1.CloudChannelReportsService.RunReportJob]. message RunReportJobResponse { - // Pass `report_job.name` to [FetchReportResultsRequest.report_job][google.cloud.channel.v1.FetchReportResultsRequest.report_job] + // Pass `report_job.name` to + // [FetchReportResultsRequest.report_job][google.cloud.channel.v1.FetchReportResultsRequest.report_job] // to retrieve the report's results. ReportJob report_job = 1; @@ -142,9 +149,11 @@ message RunReportJobResponse { ReportResultsMetadata report_metadata = 2; } -// Request message for [CloudChannelReportsService.FetchReportResults][google.cloud.channel.v1.CloudChannelReportsService.FetchReportResults]. +// Request message for +// [CloudChannelReportsService.FetchReportResults][google.cloud.channel.v1.CloudChannelReportsService.FetchReportResults]. message FetchReportResultsRequest { - // Required. The report job created by [CloudChannelReportsService.RunReportJob][google.cloud.channel.v1.CloudChannelReportsService.RunReportJob]. + // Required. The report job created by + // [CloudChannelReportsService.RunReportJob][google.cloud.channel.v1.CloudChannelReportsService.RunReportJob]. // Report_job uses the format: // accounts/{account_id}/reportJobs/{report_job_id} string report_job = 1 [ @@ -154,9 +163,9 @@ message FetchReportResultsRequest { } ]; - // Optional. Requested page size of the report. The server may return fewer results than - // requested. If you don't specify a page size, the server uses a sensible - // default (may change over time). + // Optional. Requested page size of the report. The server may return fewer + // results than requested. If you don't specify a page size, the server uses a + // sensible default (may change over time). // // The maximum value is 30,000; the server will change larger values to // 30,000. @@ -164,12 +173,15 @@ message FetchReportResultsRequest { // Optional. A token that specifies a page of results beyond the first page. // Obtained through - // [FetchReportResultsResponse.next_page_token][google.cloud.channel.v1.FetchReportResultsResponse.next_page_token] of the previous - // [CloudChannelReportsService.FetchReportResults][google.cloud.channel.v1.CloudChannelReportsService.FetchReportResults] call. + // [FetchReportResultsResponse.next_page_token][google.cloud.channel.v1.FetchReportResultsResponse.next_page_token] + // of the previous + // [CloudChannelReportsService.FetchReportResults][google.cloud.channel.v1.CloudChannelReportsService.FetchReportResults] + // call. string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; } -// Response message for [CloudChannelReportsService.FetchReportResults][google.cloud.channel.v1.CloudChannelReportsService.FetchReportResults]. +// Response message for +// [CloudChannelReportsService.FetchReportResults][google.cloud.channel.v1.CloudChannelReportsService.FetchReportResults]. // Contains a tabular representation of the report results. message FetchReportResultsResponse { // The metadata for the report results (display name, columns, row count, and @@ -180,27 +192,30 @@ message FetchReportResultsResponse { // of the columns from `report_metadata`. repeated Row rows = 2; - // Pass this token to [FetchReportResultsRequest.page_token][google.cloud.channel.v1.FetchReportResultsRequest.page_token] to retrieve - // the next page of results. + // Pass this token to + // [FetchReportResultsRequest.page_token][google.cloud.channel.v1.FetchReportResultsRequest.page_token] + // to retrieve the next page of results. string next_page_token = 3; } -// Request message for [CloudChannelReportsService.ListReports][google.cloud.channel.v1.CloudChannelReportsService.ListReports]. +// Request message for +// [CloudChannelReportsService.ListReports][google.cloud.channel.v1.CloudChannelReportsService.ListReports]. message ListReportsRequest { - // Required. The resource name of the partner account to list available reports for. - // Parent uses the format: - // accounts/{account_id} + // Required. The resource name of the partner account to list available + // reports for. Parent uses the format: accounts/{account_id} string parent = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. Requested page size of the report. The server might return fewer results - // than requested. If unspecified, returns 20 reports. - // The maximum value is 100. + // Optional. Requested page size of the report. The server might return fewer + // results than requested. If unspecified, returns 20 reports. The maximum + // value is 100. int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token that specifies a page of results beyond the first page. // Obtained through - // [ListReportsResponse.next_page_token][google.cloud.channel.v1.ListReportsResponse.next_page_token] of the previous - // [CloudChannelReportsService.ListReports][google.cloud.channel.v1.CloudChannelReportsService.ListReports] call. + // [ListReportsResponse.next_page_token][google.cloud.channel.v1.ListReportsResponse.next_page_token] + // of the previous + // [CloudChannelReportsService.ListReports][google.cloud.channel.v1.CloudChannelReportsService.ListReports] + // call. string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The BCP-47 language code, such as "en-US". If specified, the @@ -210,18 +225,21 @@ message ListReportsRequest { string language_code = 4 [(google.api.field_behavior) = OPTIONAL]; } -// Response message for [CloudChannelReportsService.ListReports][google.cloud.channel.v1.CloudChannelReportsService.ListReports]. +// Response message for +// [CloudChannelReportsService.ListReports][google.cloud.channel.v1.CloudChannelReportsService.ListReports]. message ListReportsResponse { // The reports available to the partner. repeated Report reports = 1; - // Pass this token to [FetchReportResultsRequest.page_token][google.cloud.channel.v1.FetchReportResultsRequest.page_token] to retrieve - // the next page of results. + // Pass this token to + // [FetchReportResultsRequest.page_token][google.cloud.channel.v1.FetchReportResultsRequest.page_token] + // to retrieve the next page of results. string next_page_token = 2; } // The result of a [RunReportJob][] operation. Contains the name to use in -// [FetchReportResultsRequest.report_job][google.cloud.channel.v1.FetchReportResultsRequest.report_job] and the status of the operation. +// [FetchReportResultsRequest.report_job][google.cloud.channel.v1.FetchReportResultsRequest.report_job] +// and the status of the operation. message ReportJob { option (google.api.resource) = { type: "cloudchannel.googleapis.com/ReportJob" @@ -238,7 +256,8 @@ message ReportJob { } // The features describing the data. Returned by -// [CloudChannelReportsService.RunReportJob][google.cloud.channel.v1.CloudChannelReportsService.RunReportJob] and +// [CloudChannelReportsService.RunReportJob][google.cloud.channel.v1.CloudChannelReportsService.RunReportJob] +// and // [CloudChannelReportsService.FetchReportResults][google.cloud.channel.v1.CloudChannelReportsService.FetchReportResults]. message ReportResultsMetadata { // Details of the completed report. @@ -404,9 +423,9 @@ message Report { pattern: "accounts/{account}/reports/{report}" }; - // Required. The report's resource name. Specifies the account and report used to - // generate report data. The report_id identifier is a UID - // (for example, `613bf59q`). + // Required. The report's resource name. Specifies the account and report used + // to generate report data. The report_id identifier is a UID (for example, + // `613bf59q`). // // Name uses the format: // accounts/{account_id}/reports/{report_id} @@ -422,4 +441,4 @@ message Report { // A description of other aspects of the report, such as the products // it supports. string description = 4; -} +} \ No newline at end of file diff --git a/google/cloud/channel/v1/repricing.proto b/google/cloud/channel/v1/repricing.proto index 7cc2f26072..1a15067b37 100644 --- a/google/cloud/channel/v1/repricing.proto +++ b/google/cloud/channel/v1/repricing.proto @@ -54,14 +54,16 @@ message CustomerRepricingConfig { // accounts/{account_id}/customers/{customer_id}/customerRepricingConfigs/{id}. string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Required. The configuration for bill modifications made by a reseller before - // sending it to customers. + // Required. The configuration for bill modifications made by a reseller + // before sending it to customers. RepricingConfig repricing_config = 2 [(google.api.field_behavior) = REQUIRED]; - // Output only. Timestamp of an update to the repricing rule. If `update_time` is after - // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] then it indicates this was set - // mid-month. - google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + // Output only. Timestamp of an update to the repricing rule. If `update_time` + // is after + // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] + // then it indicates this was set mid-month. + google.protobuf.Timestamp update_time = 3 + [(google.api.field_behavior) = OUTPUT_ONLY]; } // Configuration for how a distributor will rebill a channel partner @@ -77,14 +79,16 @@ message ChannelPartnerRepricingConfig { // accounts/{account_id}/channelPartnerLinks/{channel_partner_id}/channelPartnerRepricingConfigs/{id}. string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Required. The configuration for bill modifications made by a reseller before - // sending it to ChannelPartner. + // Required. The configuration for bill modifications made by a reseller + // before sending it to ChannelPartner. RepricingConfig repricing_config = 2 [(google.api.field_behavior) = REQUIRED]; - // Output only. Timestamp of an update to the repricing rule. If `update_time` is after - // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] then it indicates this was set - // mid-month. - google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + // Output only. Timestamp of an update to the repricing rule. If `update_time` + // is after + // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] + // then it indicates this was set mid-month. + google.protobuf.Timestamp update_time = 3 + [(google.api.field_behavior) = OUTPUT_ONLY]; } // Configuration for repricing a Google bill over a period of time. @@ -95,16 +99,14 @@ message RepricingConfig { // Format: // accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id} string entitlement = 1 [(google.api.resource_reference) = { - type: "cloudchannel.googleapis.com/Entitlement" - }]; + type: "cloudchannel.googleapis.com/Entitlement" + }]; } // Applies the repricing configuration at the channel partner level. // The channel partner value is derived from the resource name. Takes an // empty json object. - message ChannelPartnerGranularity { - - } + message ChannelPartnerGranularity {} // Required. Defines the granularity for repricing. oneof granularity { @@ -117,16 +119,23 @@ message RepricingConfig { ChannelPartnerGranularity channel_partner_granularity = 5; } - // Required. The YearMonth when these adjustments activate. The Day field needs to be - // "0" since we only accept YearMonth repricing boundaries. - google.type.Date effective_invoice_month = 1 [(google.api.field_behavior) = REQUIRED]; + // Required. The YearMonth when these adjustments activate. The Day field + // needs to be "0" since we only accept YearMonth repricing boundaries. + google.type.Date effective_invoice_month = 1 + [(google.api.field_behavior) = REQUIRED]; // Required. Information about the adjustment. RepricingAdjustment adjustment = 2 [(google.api.field_behavior) = REQUIRED]; - // Required. The [RebillingBasis][google.cloud.channel.v1.RebillingBasis] to use for this bill. Specifies the relative cost - // based on repricing costs you will apply. + // Required. The [RebillingBasis][google.cloud.channel.v1.RebillingBasis] to + // use for this bill. Specifies the relative cost based on repricing costs you + // will apply. RebillingBasis rebilling_basis = 3 [(google.api.field_behavior) = REQUIRED]; + + // The conditional overrides to apply for this configuration. If you list + // multiple overrides, only the first valid override is used. If you don't + // list any overrides, the API uses the normal adjustment and rebilling basis. + repeated ConditionalOverride conditional_overrides = 6; } // A type that represents the various adjustments you can apply to a bill. @@ -147,3 +156,39 @@ message PercentageAdjustment { // Pass-Through => "0.00" google.type.Decimal percentage = 2; } + +// Specifies the override to conditionally apply. +message ConditionalOverride { + // Required. Information about the applied override's adjustment. + RepricingAdjustment adjustment = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The [RebillingBasis][google.cloud.channel.v1.RebillingBasis] to + // use for the applied override. Shows the relative cost based on your + // repricing costs. + RebillingBasis rebilling_basis = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. Specifies the condition which, if met, will apply the override. + RepricingCondition repricing_condition = 3 + [(google.api.field_behavior) = REQUIRED]; +} + +// Represents the various repricing conditions you can use for a conditional +// override. +message RepricingCondition { + // Represents the types of existing conditional statements. + oneof condition { + // SKU Group condition for override. + SkuGroupCondition sku_group_condition = 1; + } +} + +// A condition that applies the override if a line item SKU is found in the SKU +// group. +message SkuGroupCondition { + // Specifies a SKU group (https://cloud.google.com/skus/sku-groups). + // Resource name of SKU group. Format: + // accounts/{account}/skuGroups/{sku_group}. + // Example: + // "accounts/C01234/skuGroups/3d50fd57-3157-4577-a5a9-a219b8490041". + string sku_group = 1; +} \ No newline at end of file diff --git a/google/cloud/channel/v1/service.proto b/google/cloud/channel/v1/service.proto index bbb092e181..93730e9ea3 100644 --- a/google/cloud/channel/v1/service.proto +++ b/google/cloud/channel/v1/service.proto @@ -46,18 +46,20 @@ option java_package = "com.google.cloud.channel.v1"; // 3. Resellers and distributors can manage customer entitlements. // // CloudChannelService exposes the following resources: -// - [Customer][google.cloud.channel.v1.Customer]s: An entity—usually an enterprise—managed by a reseller or -// distributor. +// - [Customer][google.cloud.channel.v1.Customer]s: An entity-usually an +// enterprise-managed by a reseller or distributor. // -// - [Entitlement][google.cloud.channel.v1.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. +// - [Entitlement][google.cloud.channel.v1.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. // -// - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: An entity that identifies links between -// distributors and their indirect resellers in a channel. +// - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: An +// entity that identifies links between distributors and their indirect +// resellers in a channel. service CloudChannelService { option (google.api.default_host) = "cloudchannel.googleapis.com"; - option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/apps.order"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/apps.order"; // List [Customer][google.cloud.channel.v1.Customer]s. // @@ -68,7 +70,8 @@ service CloudChannelService { // * INVALID_ARGUMENT: Required request parameters are missing or invalid. // // Return value: - // List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if there are no customers. + // List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if + // there are no customers. rpc ListCustomers(ListCustomersRequest) returns (ListCustomersResponse) { option (google.api.http) = { get: "/v1/{parent=accounts/*}/customers" @@ -78,7 +81,8 @@ service CloudChannelService { }; } - // Returns the requested [Customer][google.cloud.channel.v1.Customer] resource. + // Returns the requested [Customer][google.cloud.channel.v1.Customer] + // resource. // // Possible error codes: // @@ -111,20 +115,24 @@ service CloudChannelService { // * INVALID_VALUE: Invalid domain value in the request. // // Return value: - // A list of [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources for the domain (may be - // empty) + // A list of + // [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] + // resources for the domain (may be empty) // // Note: in the v1alpha1 version of the API, a NOT_FOUND error returns if - // no [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] resources match the domain. - rpc CheckCloudIdentityAccountsExist(CheckCloudIdentityAccountsExistRequest) returns (CheckCloudIdentityAccountsExistResponse) { + // no + // [CloudIdentityCustomerAccount][google.cloud.channel.v1.CloudIdentityCustomerAccount] + // resources match the domain. + rpc CheckCloudIdentityAccountsExist(CheckCloudIdentityAccountsExistRequest) + returns (CheckCloudIdentityAccountsExistResponse) { option (google.api.http) = { post: "/v1/{parent=accounts/*}:checkCloudIdentityAccountsExist" body: "*" }; } - // Creates a new [Customer][google.cloud.channel.v1.Customer] resource under the reseller or distributor - // account. + // Creates a new [Customer][google.cloud.channel.v1.Customer] resource under + // the reseller or distributor account. // // Possible error codes: // @@ -147,15 +155,16 @@ service CloudChannelService { }; } - // Updates an existing [Customer][google.cloud.channel.v1.Customer] resource for the reseller or - // distributor. + // Updates an existing [Customer][google.cloud.channel.v1.Customer] resource + // for the reseller or distributor. // // Possible error codes: // // * PERMISSION_DENIED: The reseller account making the request is different // from the reseller account in the API request. // * INVALID_ARGUMENT: Required request parameters are missing or invalid. - // * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request. + // * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found + // for the name in the request. // // Return value: // The updated [Customer][google.cloud.channel.v1.Customer] resource. @@ -178,7 +187,8 @@ service CloudChannelService { // this customer. // * INVALID_ARGUMENT: Required request parameters are missing or invalid. // * FAILED_PRECONDITION: The customer has existing entitlements. - // * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found for the name in the request. + // * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found + // for the name in the request. rpc DeleteCustomer(DeleteCustomerRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1/{name=accounts/*/customers/*}" @@ -189,10 +199,10 @@ service CloudChannelService { option (google.api.method_signature) = "name"; } - // Imports a [Customer][google.cloud.channel.v1.Customer] from the Cloud Identity associated with the provided - // Cloud Identity ID or domain before a TransferEntitlements call. If a - // linked Customer already exists and overwrite_if_exists is true, it will - // update that Customer's data. + // Imports a [Customer][google.cloud.channel.v1.Customer] from the Cloud + // Identity associated with the provided Cloud Identity ID or domain before a + // TransferEntitlements call. If a linked Customer already exists and + // overwrite_if_exists is true, it will update that Customer's data. // // Possible error codes: // @@ -238,7 +248,8 @@ service CloudChannelService { // To get the results of the operation, call the GetOperation method of // CloudChannelOperationsService. The Operation metadata contains an // instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. - rpc ProvisionCloudIdentity(ProvisionCloudIdentityRequest) returns (google.longrunning.Operation) { + rpc ProvisionCloudIdentity(ProvisionCloudIdentityRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/{customer=accounts/*/customers/*}:provisionCloudIdentity" body: "*" @@ -249,7 +260,8 @@ service CloudChannelService { }; } - // Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a customer. + // Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a + // customer. // // Possible error codes: // @@ -257,15 +269,17 @@ service CloudChannelService { // * INVALID_ARGUMENT: Required request parameters are missing or invalid. // // Return value: - // A list of the customer's [Entitlement][google.cloud.channel.v1.Entitlement]s. - rpc ListEntitlements(ListEntitlementsRequest) returns (ListEntitlementsResponse) { + // A list of the customer's + // [Entitlement][google.cloud.channel.v1.Entitlement]s. + rpc ListEntitlements(ListEntitlementsRequest) + returns (ListEntitlementsResponse) { option (google.api.http) = { get: "/v1/{parent=accounts/*/customers/*}/entitlements" }; } - // List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a customer based on the Cloud Identity ID or - // Customer Name in the request. + // List [TransferableSku][google.cloud.channel.v1.TransferableSku]s of a + // customer based on the Cloud Identity ID or Customer Name in the request. // // Use this method to list the entitlements information of an // unowned customer. You should provide the customer's @@ -281,16 +295,18 @@ service CloudChannelService { // * INVALID_ARGUMENT: Required request parameters are missing or invalid. // // Return value: - // A list of the customer's [TransferableSku][google.cloud.channel.v1.TransferableSku]. - rpc ListTransferableSkus(ListTransferableSkusRequest) returns (ListTransferableSkusResponse) { + // A list of the customer's + // [TransferableSku][google.cloud.channel.v1.TransferableSku]. + rpc ListTransferableSkus(ListTransferableSkusRequest) + returns (ListTransferableSkusResponse) { option (google.api.http) = { post: "/v1/{parent=accounts/*}:listTransferableSkus" body: "*" }; } - // List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a customer based on Cloud Identity ID or - // Customer Name in the request. + // List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a + // customer based on Cloud Identity ID or Customer Name in the request. // // Use this method when a reseller gets the entitlement information of an // unowned customer. The reseller should provide the customer's @@ -307,15 +323,18 @@ service CloudChannelService { // * INVALID_ARGUMENT: Required request parameters are missing or invalid. // // Return value: - // List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for the given customer and SKU. - rpc ListTransferableOffers(ListTransferableOffersRequest) returns (ListTransferableOffersResponse) { + // List of [TransferableOffer][google.cloud.channel.v1.TransferableOffer] for + // the given customer and SKU. + rpc ListTransferableOffers(ListTransferableOffersRequest) + returns (ListTransferableOffersResponse) { option (google.api.http) = { post: "/v1/{parent=accounts/*}:listTransferableOffers" body: "*" }; } - // Returns the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource. + // Returns the requested [Entitlement][google.cloud.channel.v1.Entitlement] + // resource. // // Possible error codes: // @@ -367,7 +386,8 @@ service CloudChannelService { // To get the results of the operation, call the GetOperation method of // CloudChannelOperationsService. The Operation metadata will contain an // instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. - rpc CreateEntitlement(CreateEntitlementRequest) returns (google.longrunning.Operation) { + rpc CreateEntitlement(CreateEntitlementRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/{parent=accounts/*/customers/*}/entitlements" body: "*" @@ -401,7 +421,8 @@ service CloudChannelService { // To get the results of the operation, call the GetOperation method of // CloudChannelOperationsService. The Operation metadata will contain an // instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. - rpc ChangeParameters(ChangeParametersRequest) returns (google.longrunning.Operation) { + rpc ChangeParameters(ChangeParametersRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/{name=accounts/*/customers/*/entitlements/*}:changeParameters" body: "*" @@ -435,7 +456,8 @@ service CloudChannelService { // To get the results of the operation, call the GetOperation method of // CloudChannelOperationsService. The Operation metadata will contain an // instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. - rpc ChangeRenewalSettings(ChangeRenewalSettingsRequest) returns (google.longrunning.Operation) { + rpc ChangeRenewalSettings(ChangeRenewalSettingsRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/{name=accounts/*/customers/*/entitlements/*}:changeRenewalSettings" body: "*" @@ -502,7 +524,8 @@ service CloudChannelService { // To get the results of the operation, call the GetOperation method of // CloudChannelOperationsService. The Operation metadata will contain an // instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. - rpc StartPaidService(StartPaidServiceRequest) returns (google.longrunning.Operation) { + rpc StartPaidService(StartPaidServiceRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/{name=accounts/*/customers/*/entitlements/*}:startPaidService" body: "*" @@ -534,7 +557,8 @@ service CloudChannelService { // To get the results of the operation, call the GetOperation method of // CloudChannelOperationsService. The Operation metadata will contain an // instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. - rpc SuspendEntitlement(SuspendEntitlementRequest) returns (google.longrunning.Operation) { + rpc SuspendEntitlement(SuspendEntitlementRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/{name=accounts/*/customers/*/entitlements/*}:suspend" body: "*" @@ -571,7 +595,8 @@ service CloudChannelService { // CloudChannelOperationsService. The response will contain // google.protobuf.Empty on success. The Operation metadata will contain an // instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. - rpc CancelEntitlement(CancelEntitlementRequest) returns (google.longrunning.Operation) { + rpc CancelEntitlement(CancelEntitlementRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/{name=accounts/*/customers/*/entitlements/*}:cancel" body: "*" @@ -609,7 +634,8 @@ service CloudChannelService { // To get the results of the operation, call the GetOperation method of // CloudChannelOperationsService. The Operation metadata will contain an // instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. - rpc ActivateEntitlement(ActivateEntitlementRequest) returns (google.longrunning.Operation) { + rpc ActivateEntitlement(ActivateEntitlementRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/{name=accounts/*/customers/*/entitlements/*}:activate" body: "*" @@ -649,7 +675,8 @@ service CloudChannelService { // To get the results of the operation, call the GetOperation method of // CloudChannelOperationsService. The Operation metadata will contain an // instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. - rpc TransferEntitlements(TransferEntitlementsRequest) returns (google.longrunning.Operation) { + rpc TransferEntitlements(TransferEntitlementsRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/{parent=accounts/*/customers/*}:transferEntitlements" body: "*" @@ -689,7 +716,8 @@ service CloudChannelService { // CloudChannelOperationsService. The response will contain // google.protobuf.Empty on success. The Operation metadata will contain an // instance of [OperationMetadata][google.cloud.channel.v1.OperationMetadata]. - rpc TransferEntitlementsToGoogle(TransferEntitlementsToGoogleRequest) returns (google.longrunning.Operation) { + rpc TransferEntitlementsToGoogle(TransferEntitlementsToGoogleRequest) + returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/{parent=accounts/*/customers/*}:transferEntitlementsToGoogle" body: "*" @@ -700,8 +728,8 @@ service CloudChannelService { }; } - // List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s belonging to a distributor. - // You must be a distributor to call this method. + // List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s + // belonging to a distributor. You must be a distributor to call this method. // // Possible error codes: // @@ -710,14 +738,17 @@ service CloudChannelService { // * INVALID_ARGUMENT: Required request parameters are missing or invalid. // // Return value: - // The list of the distributor account's [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources. - rpc ListChannelPartnerLinks(ListChannelPartnerLinksRequest) returns (ListChannelPartnerLinksResponse) { + // The list of the distributor account's + // [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources. + rpc ListChannelPartnerLinks(ListChannelPartnerLinksRequest) + returns (ListChannelPartnerLinksResponse) { option (google.api.http) = { get: "/v1/{parent=accounts/*}/channelPartnerLinks" }; } - // Returns the requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource. + // Returns the requested + // [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource. // You must be a distributor to call this method. // // Possible error codes: @@ -729,8 +760,10 @@ service CloudChannelService { // invalid channel partner link name. // // Return value: - // The [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource. - rpc GetChannelPartnerLink(GetChannelPartnerLinkRequest) returns (ChannelPartnerLink) { + // The [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] + // resource. + rpc GetChannelPartnerLink(GetChannelPartnerLinkRequest) + returns (ChannelPartnerLink) { option (google.api.http) = { get: "/v1/{name=accounts/*/channelPartnerLinks/*}" }; @@ -757,8 +790,10 @@ service CloudChannelService { // Contact Cloud Channel support. // // Return value: - // The new [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource. - rpc CreateChannelPartnerLink(CreateChannelPartnerLinkRequest) returns (ChannelPartnerLink) { + // The new [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] + // resource. + rpc CreateChannelPartnerLink(CreateChannelPartnerLinkRequest) + returns (ChannelPartnerLink) { option (google.api.http) = { post: "/v1/{parent=accounts/*}/channelPartnerLinks" body: "channel_partner_link" @@ -785,8 +820,10 @@ service CloudChannelService { // Contact Cloud Channel support. // // Return value: - // The updated [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource. - rpc UpdateChannelPartnerLink(UpdateChannelPartnerLinkRequest) returns (ChannelPartnerLink) { + // The updated + // [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource. + rpc UpdateChannelPartnerLink(UpdateChannelPartnerLinkRequest) + returns (ChannelPartnerLink) { option (google.api.http) = { patch: "/v1/{name=accounts/*/channelPartnerLinks/*}" body: "*" @@ -800,14 +837,18 @@ service CloudChannelService { // // * PERMISSION_DENIED: If the account making the request and the account // being queried are different. - // * NOT_FOUND: The [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] was not found. + // * NOT_FOUND: The + // [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] + // was not found. // * INTERNAL: Any non-user error related to technical issues in the // backend. In this case, contact Cloud Channel support. // // Return Value: - // If successful, the [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] resource, otherwise returns - // an error. - rpc GetCustomerRepricingConfig(GetCustomerRepricingConfigRequest) returns (CustomerRepricingConfig) { + // If successful, the + // [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] + // resource, otherwise returns an error. + rpc GetCustomerRepricingConfig(GetCustomerRepricingConfigRequest) + returns (CustomerRepricingConfig) { option (google.api.http) = { get: "/v1/{name=accounts/*/customers/*/customerRepricingConfigs/*}" }; @@ -821,21 +862,25 @@ service CloudChannelService { // // * PERMISSION_DENIED: If the account making the request and the account // being queried are different. - // * NOT_FOUND: The [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] specified does not exist or is - // not associated with the given account. + // * NOT_FOUND: The + // [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] + // specified does not exist or is not associated with the given account. // * INTERNAL: Any non-user error related to technical issues in the // backend. In this case, contact Cloud Channel support. // // Return Value: - // If successful, the [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] resources. The - // data for each resource is displayed in the ascending order of: + // If successful, the + // [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] + // resources. The data for each resource is displayed in the ascending order + // of: // * customer ID // * [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement] // * [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] // * [CustomerRepricingConfig.update_time][google.cloud.channel.v1.CustomerRepricingConfig.update_time] // // If unsuccessful, returns an error. - rpc ListCustomerRepricingConfigs(ListCustomerRepricingConfigsRequest) returns (ListCustomerRepricingConfigsResponse) { + rpc ListCustomerRepricingConfigs(ListCustomerRepricingConfigsRequest) + returns (ListCustomerRepricingConfigsResponse) { option (google.api.http) = { get: "/v1/{parent=accounts/*/customers/*}/customerRepricingConfigs" }; @@ -844,9 +889,9 @@ service CloudChannelService { // Creates a CustomerRepricingConfig. Call this method to set modifications // for a specific customer's bill. You can only create configs if the - // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] is a - // future month. If needed, you can create a config for the current month, - // with some restrictions. + // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] + // is a future month. If needed, you can create a config for the current + // month, with some restrictions. // // When creating a config for a future month, make sure there are no existing // configs for that @@ -860,9 +905,11 @@ service CloudChannelService { // Changes to the config may be immediate, but may take up to 24 hours. // * There is a limit of ten configs for any // [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement] - // or [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. - // * The contained [CustomerRepricingConfig.repricing_config][google.cloud.channel.v1.CustomerRepricingConfig.repricing_config] vaule must be - // different from the value used in the current config for a + // or + // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. + // * The contained + // [CustomerRepricingConfig.repricing_config][google.cloud.channel.v1.CustomerRepricingConfig.repricing_config] + // vaule must be different from the value used in the current config for a // [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement]. // // Possible Error Codes: @@ -872,15 +919,18 @@ service CloudChannelService { // * INVALID_ARGUMENT: Missing or invalid required parameters in the // request. Also displays if the updated config is for the current month or // past months. - // * NOT_FOUND: The [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] specified does not exist or is - // not associated with the given account. + // * NOT_FOUND: The + // [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] + // specified does not exist or is not associated with the given account. // * INTERNAL: Any non-user error related to technical issues in the // backend. In this case, contact Cloud Channel support. // // Return Value: - // If successful, the updated [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] resource, otherwise - // returns an error. - rpc CreateCustomerRepricingConfig(CreateCustomerRepricingConfigRequest) returns (CustomerRepricingConfig) { + // If successful, the updated + // [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] + // resource, otherwise returns an error. + rpc CreateCustomerRepricingConfig(CreateCustomerRepricingConfigRequest) + returns (CustomerRepricingConfig) { option (google.api.http) = { post: "/v1/{parent=accounts/*/customers/*}/customerRepricingConfigs" body: "customer_repricing_config" @@ -893,10 +943,11 @@ service CloudChannelService { // CustomerRepricingConfig. // // You can only update configs if the - // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] is a - // future month. To make changes to configs for the current month, use - // [CreateCustomerRepricingConfig][google.cloud.channel.v1.CloudChannelService.CreateCustomerRepricingConfig], taking note of its restrictions. You - // cannot update the [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. + // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] + // is a future month. To make changes to configs for the current month, use + // [CreateCustomerRepricingConfig][google.cloud.channel.v1.CloudChannelService.CreateCustomerRepricingConfig], + // taking note of its restrictions. You cannot update the + // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. // // When updating a config in the future: // @@ -909,15 +960,18 @@ service CloudChannelService { // * INVALID_ARGUMENT: Missing or invalid required parameters in the // request. Also displays if the updated config is for the current month or // past months. - // * NOT_FOUND: The [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] specified does not exist or is - // not associated with the given account. + // * NOT_FOUND: The + // [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] + // specified does not exist or is not associated with the given account. // * INTERNAL: Any non-user error related to technical issues in the // backend. In this case, contact Cloud Channel support. // // Return Value: - // If successful, the updated [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] resource, otherwise - // returns an error. - rpc UpdateCustomerRepricingConfig(UpdateCustomerRepricingConfigRequest) returns (CustomerRepricingConfig) { + // If successful, the updated + // [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] + // resource, otherwise returns an error. + rpc UpdateCustomerRepricingConfig(UpdateCustomerRepricingConfigRequest) + returns (CustomerRepricingConfig) { option (google.api.http) = { patch: "/v1/{customer_repricing_config.name=accounts/*/customers/*/customerRepricingConfigs/*}" body: "customer_repricing_config" @@ -925,20 +979,25 @@ service CloudChannelService { option (google.api.method_signature) = "customer_repricing_config"; } - // Deletes the given [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] permanently. You can only - // delete configs if their [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] is set - // to a date after the current month. + // Deletes the given + // [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] + // permanently. You can only delete configs if their + // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] + // is set to a date after the current month. // // Possible error codes: // // * PERMISSION_DENIED: The account making the request does not own // this customer. // * INVALID_ARGUMENT: Required request parameters are missing or invalid. - // * FAILED_PRECONDITION: The [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] is active or in the - // past. - // * NOT_FOUND: No [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] found for the name in the - // request. - rpc DeleteCustomerRepricingConfig(DeleteCustomerRepricingConfigRequest) returns (google.protobuf.Empty) { + // * FAILED_PRECONDITION: The + // [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] + // is active or in the past. + // * NOT_FOUND: No + // [CustomerRepricingConfig][google.cloud.channel.v1.CustomerRepricingConfig] + // found for the name in the request. + rpc DeleteCustomerRepricingConfig(DeleteCustomerRepricingConfigRequest) + returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1/{name=accounts/*/customers/*/customerRepricingConfigs/*}" }; @@ -952,14 +1011,18 @@ service CloudChannelService { // // * PERMISSION_DENIED: If the account making the request and the account // being queried are different. - // * NOT_FOUND: The [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] was not found. + // * NOT_FOUND: The + // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] + // was not found. // * INTERNAL: Any non-user error related to technical issues in the // backend. In this case, contact Cloud Channel support. // // Return Value: - // If successful, the [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] resource, otherwise - // returns an error. - rpc GetChannelPartnerRepricingConfig(GetChannelPartnerRepricingConfigRequest) returns (ChannelPartnerRepricingConfig) { + // If successful, the + // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] + // resource, otherwise returns an error. + rpc GetChannelPartnerRepricingConfig(GetChannelPartnerRepricingConfigRequest) + returns (ChannelPartnerRepricingConfig) { option (google.api.http) = { get: "/v1/{name=accounts/*/channelPartnerLinks/*/channelPartnerRepricingConfigs/*}" }; @@ -973,20 +1036,25 @@ service CloudChannelService { // // * PERMISSION_DENIED: If the account making the request and the account // being queried are different. - // * NOT_FOUND: The [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] specified does not exist - // or is not associated with the given account. + // * NOT_FOUND: The + // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] + // specified does not exist or is not associated with the given account. // * INTERNAL: Any non-user error related to technical issues in the // backend. In this case, contact Cloud Channel support. // // Return Value: - // If successful, the [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] resources. - // The data for each resource is displayed in the ascending order of: + // If successful, the + // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] + // resources. The data for each resource is displayed in the ascending order + // of: // * channel partner ID // * [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] // * [ChannelPartnerRepricingConfig.update_time][google.cloud.channel.v1.ChannelPartnerRepricingConfig.update_time] // // If unsuccessful, returns an error. - rpc ListChannelPartnerRepricingConfigs(ListChannelPartnerRepricingConfigsRequest) returns (ListChannelPartnerRepricingConfigsResponse) { + rpc ListChannelPartnerRepricingConfigs( + ListChannelPartnerRepricingConfigsRequest) + returns (ListChannelPartnerRepricingConfigsResponse) { option (google.api.http) = { get: "/v1/{parent=accounts/*/channelPartnerLinks/*}/channelPartnerRepricingConfigs" }; @@ -995,9 +1063,10 @@ service CloudChannelService { // Creates a ChannelPartnerRepricingConfig. Call this method to set // modifications for a specific ChannelPartner's bill. You can only create - // configs if the [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] is a future - // month. If needed, you can create a config for the current month, with some - // restrictions. + // configs if the + // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] + // is a future month. If needed, you can create a config for the current + // month, with some restrictions. // // When creating a config for a future month, make sure there are no existing // configs for that @@ -1011,8 +1080,9 @@ service CloudChannelService { // Changes to the config may be immediate, but may take up to 24 hours. // * There is a limit of ten configs for any ChannelPartner or // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. - // * The contained [ChannelPartnerRepricingConfig.repricing_config][google.cloud.channel.v1.ChannelPartnerRepricingConfig.repricing_config] vaule - // must be different from the value used in the current config for a + // * The contained + // [ChannelPartnerRepricingConfig.repricing_config][google.cloud.channel.v1.ChannelPartnerRepricingConfig.repricing_config] + // vaule must be different from the value used in the current config for a // ChannelPartner. // // Possible Error Codes: @@ -1022,20 +1092,25 @@ service CloudChannelService { // * INVALID_ARGUMENT: Missing or invalid required parameters in the // request. Also displays if the updated config is for the current month or // past months. - // * NOT_FOUND: The [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] specified does not exist - // or is not associated with the given account. + // * NOT_FOUND: The + // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] + // specified does not exist or is not associated with the given account. // * INTERNAL: Any non-user error related to technical issues in the // backend. In this case, contact Cloud Channel support. // // Return Value: - // If successful, the updated [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] resource, - // otherwise returns an error. - rpc CreateChannelPartnerRepricingConfig(CreateChannelPartnerRepricingConfigRequest) returns (ChannelPartnerRepricingConfig) { + // If successful, the updated + // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] + // resource, otherwise returns an error. + rpc CreateChannelPartnerRepricingConfig( + CreateChannelPartnerRepricingConfigRequest) + returns (ChannelPartnerRepricingConfig) { option (google.api.http) = { post: "/v1/{parent=accounts/*/channelPartnerLinks/*}/channelPartnerRepricingConfigs" body: "channel_partner_repricing_config" }; - option (google.api.method_signature) = "parent,channel_partner_repricing_config"; + option (google.api.method_signature) = + "parent,channel_partner_repricing_config"; } // Updates a ChannelPartnerRepricingConfig. Call this method to set @@ -1043,10 +1118,11 @@ service CloudChannelService { // the existing CustomerRepricingConfig. // // You can only update configs if the - // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] is a - // future month. To make changes to configs for the current month, use - // [CreateChannelPartnerRepricingConfig][google.cloud.channel.v1.CloudChannelService.CreateChannelPartnerRepricingConfig], taking note of its restrictions. - // You cannot update the [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. + // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] + // is a future month. To make changes to configs for the current month, use + // [CreateChannelPartnerRepricingConfig][google.cloud.channel.v1.CloudChannelService.CreateChannelPartnerRepricingConfig], + // taking note of its restrictions. You cannot update the + // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month]. // // When updating a config in the future: // @@ -1059,15 +1135,19 @@ service CloudChannelService { // * INVALID_ARGUMENT: Missing or invalid required parameters in the // request. Also displays if the updated config is for the current month or // past months. - // * NOT_FOUND: The [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] specified does not exist - // or is not associated with the given account. + // * NOT_FOUND: The + // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] + // specified does not exist or is not associated with the given account. // * INTERNAL: Any non-user error related to technical issues in the // backend. In this case, contact Cloud Channel support. // // Return Value: - // If successful, the updated [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] resource, - // otherwise returns an error. - rpc UpdateChannelPartnerRepricingConfig(UpdateChannelPartnerRepricingConfigRequest) returns (ChannelPartnerRepricingConfig) { + // If successful, the updated + // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] + // resource, otherwise returns an error. + rpc UpdateChannelPartnerRepricingConfig( + UpdateChannelPartnerRepricingConfigRequest) + returns (ChannelPartnerRepricingConfig) { option (google.api.http) = { patch: "/v1/{channel_partner_repricing_config.name=accounts/*/channelPartnerLinks/*/channelPartnerRepricingConfigs/*}" body: "channel_partner_repricing_config" @@ -1075,20 +1155,26 @@ service CloudChannelService { option (google.api.method_signature) = "channel_partner_repricing_config"; } - // Deletes the given [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] permanently. You can - // only delete configs if their [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] is - // set to a date after the current month. + // Deletes the given + // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] + // permanently. You can only delete configs if their + // [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month] + // is set to a date after the current month. // // Possible error codes: // // * PERMISSION_DENIED: The account making the request does not own // this customer. // * INVALID_ARGUMENT: Required request parameters are missing or invalid. - // * FAILED_PRECONDITION: The [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] is active or - // in the past. - // * NOT_FOUND: No [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] found for the name in the - // request. - rpc DeleteChannelPartnerRepricingConfig(DeleteChannelPartnerRepricingConfigRequest) returns (google.protobuf.Empty) { + // * FAILED_PRECONDITION: The + // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] + // is active or in the past. + // * NOT_FOUND: No + // [ChannelPartnerRepricingConfig][google.cloud.channel.v1.ChannelPartnerRepricingConfig] + // found for the name in the request. + rpc DeleteChannelPartnerRepricingConfig( + DeleteChannelPartnerRepricingConfigRequest) + returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1/{name=accounts/*/channelPartnerLinks/*/channelPartnerRepricingConfigs/*}" }; @@ -1153,7 +1239,8 @@ service CloudChannelService { // // * PERMISSION_DENIED: The customer doesn't belong to the reseller. // * INVALID_ARGUMENT: Required request parameters are missing or invalid. - rpc ListPurchasableSkus(ListPurchasableSkusRequest) returns (ListPurchasableSkusResponse) { + rpc ListPurchasableSkus(ListPurchasableSkusRequest) + returns (ListPurchasableSkusResponse) { option (google.api.http) = { get: "/v1/{customer=accounts/*/customers/*}:listPurchasableSkus" }; @@ -1168,7 +1255,8 @@ service CloudChannelService { // // * PERMISSION_DENIED: The customer doesn't belong to the reseller // * INVALID_ARGUMENT: Required request parameters are missing or invalid. - rpc ListPurchasableOffers(ListPurchasableOffersRequest) returns (ListPurchasableOffersResponse) { + rpc ListPurchasableOffers(ListPurchasableOffersRequest) + returns (ListPurchasableOffersResponse) { option (google.api.http) = { get: "/v1/{customer=accounts/*/customers/*}:listPurchasableOffers" }; @@ -1176,7 +1264,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 - // subscriber, you get the events through [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent] + // subscriber, you get the events through + // [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent] // // Possible error codes: // @@ -1191,7 +1280,8 @@ service CloudChannelService { // // Return value: // The topic name with the registered service email address. - rpc RegisterSubscriber(RegisterSubscriberRequest) returns (RegisterSubscriberResponse) { + rpc RegisterSubscriber(RegisterSubscriberRequest) + returns (RegisterSubscriberResponse) { option (google.api.http) = { post: "/v1/{account=accounts/*}:register" body: "*" @@ -1219,7 +1309,8 @@ service CloudChannelService { // The topic name that unregistered the service email address. // Returns a success response if the service email address wasn't registered // with the topic. - rpc UnregisterSubscriber(UnregisterSubscriberRequest) returns (UnregisterSubscriberResponse) { + rpc UnregisterSubscriber(UnregisterSubscriberRequest) + returns (UnregisterSubscriberResponse) { option (google.api.http) = { post: "/v1/{account=accounts/*}:unregister" body: "*" @@ -1243,14 +1334,16 @@ service CloudChannelService { // // Return value: // A list of service email addresses. - rpc ListSubscribers(ListSubscribersRequest) returns (ListSubscribersResponse) { + rpc ListSubscribers(ListSubscribersRequest) + returns (ListSubscribersResponse) { option (google.api.http) = { get: "/v1/{account=accounts/*}:listSubscribers" }; } } -// Request message for [CloudChannelService.CheckCloudIdentityAccountsExist][google.cloud.channel.v1.CloudChannelService.CheckCloudIdentityAccountsExist]. +// Request message for +// [CloudChannelService.CheckCloudIdentityAccountsExist][google.cloud.channel.v1.CloudChannelService.CheckCloudIdentityAccountsExist]. message CheckCloudIdentityAccountsExistRequest { // Required. The reseller account's resource name. // Parent uses the format: accounts/{account_id} @@ -1287,40 +1380,48 @@ message CheckCloudIdentityAccountsExistResponse { repeated CloudIdentityCustomerAccount cloud_identity_accounts = 1; } -// Request message for [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] +// Request message for +// [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] message ListCustomersRequest { // Required. The resource name of the reseller account to list customers from. // Parent uses the format: accounts/{account_id}. string parent = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. The maximum number of customers to return. The service may return fewer - // than this value. If unspecified, returns at most 10 customers. The + // Optional. The maximum number of customers to return. The service may return + // fewer than this value. If unspecified, returns at most 10 customers. The // maximum value is 50. int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token identifying a page of results other than the first page. // Obtained through - // [ListCustomersResponse.next_page_token][google.cloud.channel.v1.ListCustomersResponse.next_page_token] of the previous - // [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] call. + // [ListCustomersResponse.next_page_token][google.cloud.channel.v1.ListCustomersResponse.next_page_token] + // of the previous + // [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers] + // call. string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; - // Optional. Filters applied to the [CloudChannelService.ListCustomers] results. See + // Optional. Filters applied to the [CloudChannelService.ListCustomers] + // results. See // https://cloud.google.com/channel/docs/concepts/google-cloud/filter-customers // for more information. string filter = 4 [(google.api.field_behavior) = OPTIONAL]; } -// Response message for [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers]. +// Response message for +// [CloudChannelService.ListCustomers][google.cloud.channel.v1.CloudChannelService.ListCustomers]. message ListCustomersResponse { // The customers belonging to a reseller or distributor. repeated Customer customers = 1; // A token to retrieve the next page of results. - // Pass to [ListCustomersRequest.page_token][google.cloud.channel.v1.ListCustomersRequest.page_token] to obtain that page. + // Pass to + // [ListCustomersRequest.page_token][google.cloud.channel.v1.ListCustomersRequest.page_token] + // to obtain that page. string next_page_token = 2; } -// Request message for [CloudChannelService.GetCustomer][google.cloud.channel.v1.CloudChannelService.GetCustomer]. +// Request message for +// [CloudChannelService.GetCustomer][google.cloud.channel.v1.CloudChannelService.GetCustomer]. message GetCustomerRequest { // Required. The resource name of the customer to retrieve. // Name uses the format: accounts/{account_id}/customers/{customer_id} @@ -1332,17 +1433,19 @@ message GetCustomerRequest { ]; } -// Request message for [CloudChannelService.CreateCustomer][google.cloud.channel.v1.CloudChannelService.CreateCustomer] +// Request message for +// [CloudChannelService.CreateCustomer][google.cloud.channel.v1.CloudChannelService.CreateCustomer] message CreateCustomerRequest { - // Required. The resource name of reseller account in which to create the customer. - // Parent uses the format: accounts/{account_id} + // Required. The resource name of reseller account in which to create the + // customer. Parent uses the format: accounts/{account_id} string parent = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The customer to create. Customer customer = 2 [(google.api.field_behavior) = REQUIRED]; } -// Request message for [CloudChannelService.UpdateCustomer][google.cloud.channel.v1.CloudChannelService.UpdateCustomer]. +// Request message for +// [CloudChannelService.UpdateCustomer][google.cloud.channel.v1.CloudChannelService.UpdateCustomer]. message UpdateCustomerRequest { // Required. New contents of the customer. Customer customer = 2 [(google.api.field_behavior) = REQUIRED]; @@ -1352,7 +1455,8 @@ message UpdateCustomerRequest { google.protobuf.FieldMask update_mask = 3; } -// Request message for [CloudChannelService.DeleteCustomer][google.cloud.channel.v1.CloudChannelService.DeleteCustomer]. +// Request message for +// [CloudChannelService.DeleteCustomer][google.cloud.channel.v1.CloudChannelService.DeleteCustomer]. message DeleteCustomerRequest { // Required. The resource name of the customer to delete. string name = 1 [ @@ -1363,7 +1467,8 @@ message DeleteCustomerRequest { ]; } -// Request message for [CloudChannelService.ImportCustomer][google.cloud.channel.v1.CloudChannelService.ImportCustomer] +// Request message for +// [CloudChannelService.ImportCustomer][google.cloud.channel.v1.CloudChannelService.ImportCustomer] message ImportCustomerRequest { // Specifies the identity of the transfer customer. // A customer's cloud_identity_id or domain is required to look up the @@ -1393,9 +1498,10 @@ message ImportCustomerRequest { // conflicting region code or domain. bool overwrite_if_exists = 5 [(google.api.field_behavior) = REQUIRED]; - // Optional. Cloud Identity ID of a channel partner who will be the direct reseller for - // the customer's order. This field is required for 2-tier transfer scenarios - // and can be provided via the request Parent binding as well. + // Optional. Cloud Identity ID of a channel partner who will be the direct + // reseller for the customer's order. This field is required for 2-tier + // transfer scenarios and can be provided via the request Parent binding as + // well. string channel_partner_id = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. Specifies the customer that will receive imported Cloud Identity @@ -1409,7 +1515,8 @@ message ImportCustomerRequest { ]; } -// Request message for [CloudChannelService.ProvisionCloudIdentity][google.cloud.channel.v1.CloudChannelService.ProvisionCloudIdentity] +// Request message for +// [CloudChannelService.ProvisionCloudIdentity][google.cloud.channel.v1.CloudChannelService.ProvisionCloudIdentity] message ProvisionCloudIdentityRequest { // Required. Resource name of the customer. // Format: accounts/{account_id}/customers/{customer_id} @@ -1430,7 +1537,8 @@ message ProvisionCloudIdentityRequest { bool validate_only = 4; } -// Request message for [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] +// Request message for +// [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] message ListEntitlementsRequest { // Required. The resource name of the reseller's customer account to list // entitlements for. @@ -1442,29 +1550,35 @@ message ListEntitlementsRequest { } ]; - // Optional. Requested page size. Server might return fewer results than requested. - // If unspecified, return at most 50 entitlements. - // The maximum value is 100; the server will coerce values above 100. + // Optional. Requested page size. Server might return fewer results than + // requested. If unspecified, return at most 50 entitlements. The maximum + // value is 100; the server will coerce values above 100. int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token for a page of results other than the first page. // Obtained using - // [ListEntitlementsResponse.next_page_token][google.cloud.channel.v1.ListEntitlementsResponse.next_page_token] of the previous - // [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] call. + // [ListEntitlementsResponse.next_page_token][google.cloud.channel.v1.ListEntitlementsResponse.next_page_token] + // of the previous + // [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements] + // call. string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; } -// Response message for [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements]. +// Response message for +// [CloudChannelService.ListEntitlements][google.cloud.channel.v1.CloudChannelService.ListEntitlements]. message ListEntitlementsResponse { // The reseller customer's entitlements. repeated Entitlement entitlements = 1; // A token to list the next page of results. - // Pass to [ListEntitlementsRequest.page_token][google.cloud.channel.v1.ListEntitlementsRequest.page_token] to obtain that page. + // Pass to + // [ListEntitlementsRequest.page_token][google.cloud.channel.v1.ListEntitlementsRequest.page_token] + // to obtain that page. string next_page_token = 2; } -// Request message for [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] +// Request message for +// [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] message ListTransferableSkusRequest { // Specifies the identity of transferred customer. // Either a cloud_identity_id of the customer or the customer name is @@ -1492,9 +1606,10 @@ message ListTransferableSkusRequest { // A token for a page of results other than the first page. // Obtained using - // [ListTransferableSkusResponse.next_page_token][google.cloud.channel.v1.ListTransferableSkusResponse.next_page_token] of the previous - // [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] call. - // Optional. + // [ListTransferableSkusResponse.next_page_token][google.cloud.channel.v1.ListTransferableSkusResponse.next_page_token] + // of the previous + // [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus] + // call. Optional. string page_token = 3; // Optional. The super admin of the resold customer generates this token to @@ -1510,18 +1625,21 @@ message ListTransferableSkusRequest { string language_code = 6; } -// Response message for [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus]. +// Response message for +// [CloudChannelService.ListTransferableSkus][google.cloud.channel.v1.CloudChannelService.ListTransferableSkus]. message ListTransferableSkusResponse { // Information about existing SKUs for a customer that needs a transfer. repeated TransferableSku transferable_skus = 1; // A token to retrieve the next page of results. - // Pass to [ListTransferableSkusRequest.page_token][google.cloud.channel.v1.ListTransferableSkusRequest.page_token] to obtain - // that page. + // Pass to + // [ListTransferableSkusRequest.page_token][google.cloud.channel.v1.ListTransferableSkusRequest.page_token] + // to obtain that page. string next_page_token = 2; } -// Request message for [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] +// Request message for +// [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] message ListTransferableOffersRequest { // Specifies the identity of transferred customer. // Either a cloud_identity_id of the customer or the customer name is @@ -1545,8 +1663,10 @@ message ListTransferableOffersRequest { // A token for a page of results other than the first page. // Obtained using - // [ListTransferableOffersResponse.next_page_token][google.cloud.channel.v1.ListTransferableOffersResponse.next_page_token] of the previous - // [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] call. + // [ListTransferableOffersResponse.next_page_token][google.cloud.channel.v1.ListTransferableOffersResponse.next_page_token] + // of the previous + // [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers] + // call. string page_token = 3; // Required. The SKU to look up Offers for. @@ -1558,15 +1678,17 @@ message ListTransferableOffersRequest { string language_code = 7 [(google.api.field_behavior) = OPTIONAL]; } -// Response message for [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers]. +// Response message for +// [CloudChannelService.ListTransferableOffers][google.cloud.channel.v1.CloudChannelService.ListTransferableOffers]. message ListTransferableOffersResponse { // Information about Offers for a customer that can be used for // transfer. repeated TransferableOffer transferable_offers = 1; // A token to retrieve the next page of results. - // Pass to [ListTransferableOffersRequest.page_token][google.cloud.channel.v1.ListTransferableOffersRequest.page_token] to obtain - // that page. + // Pass to + // [ListTransferableOffersRequest.page_token][google.cloud.channel.v1.ListTransferableOffersRequest.page_token] + // to obtain that page. string next_page_token = 2; } @@ -1577,7 +1699,8 @@ message TransferableOffer { Offer offer = 1; } -// Request message for [CloudChannelService.GetEntitlement][google.cloud.channel.v1.CloudChannelService.GetEntitlement]. +// Request message for +// [CloudChannelService.GetEntitlement][google.cloud.channel.v1.CloudChannelService.GetEntitlement]. message GetEntitlementRequest { // Required. The resource name of the entitlement to retrieve. // Name uses the format: @@ -1590,39 +1713,45 @@ message GetEntitlementRequest { ]; } -// Request message for [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] +// Request message for +// [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] message ListChannelPartnerLinksRequest { - // Required. The resource name of the reseller account for listing channel partner - // links. - // Parent uses the format: accounts/{account_id} + // Required. The resource name of the reseller account for listing channel + // partner links. Parent uses the format: accounts/{account_id} string parent = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. Requested page size. Server might return fewer results than requested. - // If unspecified, server will pick a default size (25). - // The maximum value is 200; the server will coerce values above 200. + // Optional. Requested page size. Server might return fewer results than + // requested. If unspecified, server will pick a default size (25). The + // maximum value is 200; the server will coerce values above 200. int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token for a page of results other than the first page. // Obtained using - // [ListChannelPartnerLinksResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerLinksResponse.next_page_token] of the previous - // [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] call. + // [ListChannelPartnerLinksResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerLinksResponse.next_page_token] + // of the previous + // [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks] + // call. string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The level of granularity the ChannelPartnerLink will display. ChannelPartnerLinkView view = 4 [(google.api.field_behavior) = OPTIONAL]; } -// Response message for [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks]. +// Response message for +// [CloudChannelService.ListChannelPartnerLinks][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerLinks]. message ListChannelPartnerLinksResponse { // The Channel partner links for a reseller. repeated ChannelPartnerLink channel_partner_links = 1; // A token to retrieve the next page of results. - // Pass to [ListChannelPartnerLinksRequest.page_token][google.cloud.channel.v1.ListChannelPartnerLinksRequest.page_token] to obtain that page. + // Pass to + // [ListChannelPartnerLinksRequest.page_token][google.cloud.channel.v1.ListChannelPartnerLinksRequest.page_token] + // to obtain that page. string next_page_token = 2; } -// Request message for [CloudChannelService.GetChannelPartnerLink][google.cloud.channel.v1.CloudChannelService.GetChannelPartnerLink]. +// Request message for +// [CloudChannelService.GetChannelPartnerLink][google.cloud.channel.v1.CloudChannelService.GetChannelPartnerLink]. message GetChannelPartnerLinkRequest { // Required. The resource name of the channel partner link to retrieve. // Name uses the format: accounts/{account_id}/channelPartnerLinks/{id} @@ -1633,7 +1762,8 @@ message GetChannelPartnerLinkRequest { ChannelPartnerLinkView view = 2 [(google.api.field_behavior) = OPTIONAL]; } -// Request message for [CloudChannelService.CreateChannelPartnerLink][google.cloud.channel.v1.CloudChannelService.CreateChannelPartnerLink] +// Request message for +// [CloudChannelService.CreateChannelPartnerLink][google.cloud.channel.v1.CloudChannelService.CreateChannelPartnerLink] message CreateChannelPartnerLinkRequest { // Required. Create a channel partner link for the provided reseller account's // resource name. @@ -1643,27 +1773,32 @@ message CreateChannelPartnerLinkRequest { // Required. The channel partner link to create. // Either channel_partner_link.reseller_cloud_identity_id or domain can be // used to create a link. - ChannelPartnerLink channel_partner_link = 2 [(google.api.field_behavior) = REQUIRED]; + ChannelPartnerLink channel_partner_link = 2 + [(google.api.field_behavior) = REQUIRED]; } -// Request message for [CloudChannelService.UpdateChannelPartnerLink][google.cloud.channel.v1.CloudChannelService.UpdateChannelPartnerLink] +// Request message for +// [CloudChannelService.UpdateChannelPartnerLink][google.cloud.channel.v1.CloudChannelService.UpdateChannelPartnerLink] message UpdateChannelPartnerLinkRequest { // Required. The resource name of the channel partner link to cancel. // Name uses the format: accounts/{account_id}/channelPartnerLinks/{id} // where {id} is the Cloud Identity ID of the partner. string name = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The channel partner link to update. Only channel_partner_link.link_state - // is allowed for updates. - ChannelPartnerLink channel_partner_link = 2 [(google.api.field_behavior) = REQUIRED]; + // Required. The channel partner link to update. Only + // channel_partner_link.link_state is allowed for updates. + ChannelPartnerLink channel_partner_link = 2 + [(google.api.field_behavior) = REQUIRED]; // Required. The update mask that applies to the resource. // The only allowable value for an update mask is // channel_partner_link.link_state. - google.protobuf.FieldMask update_mask = 3 [(google.api.field_behavior) = REQUIRED]; + google.protobuf.FieldMask update_mask = 3 + [(google.api.field_behavior) = REQUIRED]; } -// Request message for [CloudChannelService.GetCustomerRepricingConfig][google.cloud.channel.v1.CloudChannelService.GetCustomerRepricingConfig]. +// Request message for +// [CloudChannelService.GetCustomerRepricingConfig][google.cloud.channel.v1.CloudChannelService.GetCustomerRepricingConfig]. message GetCustomerRepricingConfigRequest { // Required. The resource name of the CustomerRepricingConfig. // Format: @@ -1676,7 +1811,8 @@ message GetCustomerRepricingConfigRequest { ]; } -// Request message for [CloudChannelService.ListCustomerRepricingConfigs][google.cloud.channel.v1.CloudChannelService.ListCustomerRepricingConfigs]. +// Request message for +// [CloudChannelService.ListCustomerRepricingConfigs][google.cloud.channel.v1.CloudChannelService.ListCustomerRepricingConfigs]. message ListCustomerRepricingConfigsRequest { // Required. The resource name of the customer. // Parent uses the format: accounts/{account_id}/customers/{customer_id}. @@ -1689,15 +1825,17 @@ message ListCustomerRepricingConfigsRequest { } ]; - // Optional. The maximum number of repricing configs to return. The service may return - // fewer than this value. If unspecified, returns a maximum of 50 rules. The - // maximum value is 100; values above 100 will be coerced to 100. + // Optional. The maximum number of repricing configs to return. The service + // may return fewer than this value. If unspecified, returns a maximum of 50 + // rules. The maximum value is 100; values above 100 will be coerced to 100. int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token identifying a page of results beyond the first page. // Obtained through - // [ListCustomerRepricingConfigsResponse.next_page_token][google.cloud.channel.v1.ListCustomerRepricingConfigsResponse.next_page_token] of the previous - // [CloudChannelService.ListCustomerRepricingConfigs][google.cloud.channel.v1.CloudChannelService.ListCustomerRepricingConfigs] call. + // [ListCustomerRepricingConfigsResponse.next_page_token][google.cloud.channel.v1.ListCustomerRepricingConfigsResponse.next_page_token] + // of the previous + // [CloudChannelService.ListCustomerRepricingConfigs][google.cloud.channel.v1.CloudChannelService.ListCustomerRepricingConfigs] + // call. string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A filter for [CloudChannelService.ListCustomerRepricingConfigs] @@ -1710,21 +1848,25 @@ message ListCustomerRepricingConfigsRequest { string filter = 4 [(google.api.field_behavior) = OPTIONAL]; } -// Response message for [CloudChannelService.ListCustomerRepricingConfigs][google.cloud.channel.v1.CloudChannelService.ListCustomerRepricingConfigs]. +// Response message for +// [CloudChannelService.ListCustomerRepricingConfigs][google.cloud.channel.v1.CloudChannelService.ListCustomerRepricingConfigs]. message ListCustomerRepricingConfigsResponse { // The repricing configs for this channel partner. repeated CustomerRepricingConfig customer_repricing_configs = 1; // A token to retrieve the next page of results. - // Pass to [ListCustomerRepricingConfigsRequest.page_token][google.cloud.channel.v1.ListCustomerRepricingConfigsRequest.page_token] to obtain that - // page. + // Pass to + // [ListCustomerRepricingConfigsRequest.page_token][google.cloud.channel.v1.ListCustomerRepricingConfigsRequest.page_token] + // to obtain that page. string next_page_token = 2; } -// Request message for [CloudChannelService.CreateCustomerRepricingConfig][google.cloud.channel.v1.CloudChannelService.CreateCustomerRepricingConfig]. +// Request message for +// [CloudChannelService.CreateCustomerRepricingConfig][google.cloud.channel.v1.CloudChannelService.CreateCustomerRepricingConfig]. message CreateCustomerRepricingConfigRequest { - // Required. The resource name of the customer that will receive this repricing config. - // Parent uses the format: accounts/{account_id}/customers/{customer_id} + // Required. The resource name of the customer that will receive this + // repricing config. Parent uses the format: + // accounts/{account_id}/customers/{customer_id} string parent = 1 [ (google.api.field_behavior) = REQUIRED, (google.api.resource_reference) = { @@ -1733,19 +1875,23 @@ message CreateCustomerRepricingConfigRequest { ]; // Required. The CustomerRepricingConfig object to update. - CustomerRepricingConfig customer_repricing_config = 2 [(google.api.field_behavior) = REQUIRED]; + CustomerRepricingConfig customer_repricing_config = 2 + [(google.api.field_behavior) = REQUIRED]; } -// Request message for [CloudChannelService.UpdateCustomerRepricingConfig][google.cloud.channel.v1.CloudChannelService.UpdateCustomerRepricingConfig]. +// Request message for +// [CloudChannelService.UpdateCustomerRepricingConfig][google.cloud.channel.v1.CloudChannelService.UpdateCustomerRepricingConfig]. message UpdateCustomerRepricingConfigRequest { // Required. The CustomerRepricingConfig object to update. - CustomerRepricingConfig customer_repricing_config = 1 [(google.api.field_behavior) = REQUIRED]; + CustomerRepricingConfig customer_repricing_config = 1 + [(google.api.field_behavior) = REQUIRED]; } -// Request message for [CloudChannelService.DeleteCustomerRepricingConfig][google.cloud.channel.v1.CloudChannelService.DeleteCustomerRepricingConfig]. +// Request message for +// [CloudChannelService.DeleteCustomerRepricingConfig][google.cloud.channel.v1.CloudChannelService.DeleteCustomerRepricingConfig]. message DeleteCustomerRepricingConfigRequest { - // Required. The resource name of the customer repricing config rule to delete. - // Format: + // Required. The resource name of the customer repricing config rule to + // delete. Format: // accounts/{account_id}/customers/{customer_id}/customerRepricingConfigs/{id}. string name = 1 [ (google.api.field_behavior) = REQUIRED, @@ -1755,7 +1901,8 @@ message DeleteCustomerRepricingConfigRequest { ]; } -// Request message for [CloudChannelService.GetChannelPartnerRepricingConfig][google.cloud.channel.v1.CloudChannelService.GetChannelPartnerRepricingConfig] +// Request message for +// [CloudChannelService.GetChannelPartnerRepricingConfig][google.cloud.channel.v1.CloudChannelService.GetChannelPartnerRepricingConfig] message GetChannelPartnerRepricingConfigRequest { // Required. The resource name of the ChannelPartnerRepricingConfig // Format: @@ -1771,8 +1918,9 @@ message GetChannelPartnerRepricingConfigRequest { // Request message for // [CloudChannelService.ListChannelPartnerRepricingConfigs][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerRepricingConfigs]. message ListChannelPartnerRepricingConfigsRequest { - // Required. The resource name of the account's [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]. - // Parent uses the format: + // Required. The resource name of the account's + // [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]. Parent + // uses the format: // accounts/{account_id}/channelPartnerLinks/{channel_partner_id}. // Supports accounts/{account_id}/channelPartnerLinks/- to retrieve configs // for all channel partners. @@ -1783,21 +1931,23 @@ message ListChannelPartnerRepricingConfigsRequest { } ]; - // Optional. The maximum number of repricing configs to return. The service may return - // fewer than this value. If unspecified, returns a maximum of 50 rules. The - // maximum value is 100; values above 100 will be coerced to 100. + // Optional. The maximum number of repricing configs to return. The service + // may return fewer than this value. If unspecified, returns a maximum of 50 + // rules. The maximum value is 100; values above 100 will be coerced to 100. int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token identifying a page of results beyond the first page. // Obtained through - // [ListChannelPartnerRepricingConfigsResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerRepricingConfigsResponse.next_page_token] of the - // previous [CloudChannelService.ListChannelPartnerRepricingConfigs][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerRepricingConfigs] call. + // [ListChannelPartnerRepricingConfigsResponse.next_page_token][google.cloud.channel.v1.ListChannelPartnerRepricingConfigsResponse.next_page_token] + // of the previous + // [CloudChannelService.ListChannelPartnerRepricingConfigs][google.cloud.channel.v1.CloudChannelService.ListChannelPartnerRepricingConfigs] + // call. string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; - // Optional. A filter for [CloudChannelService.ListChannelPartnerRepricingConfigs] - // results (channel_partner_link only). You can use this filter when you - // support a BatchGet-like query. - // To use the filter, you must set + // Optional. A filter for + // [CloudChannelService.ListChannelPartnerRepricingConfigs] results + // (channel_partner_link only). You can use this filter when you support a + // BatchGet-like query. To use the filter, you must set // `parent=accounts/{account_id}/channelPartnerLinks/-`. // // Example: `channel_partner_link = @@ -1813,16 +1963,17 @@ message ListChannelPartnerRepricingConfigsResponse { repeated ChannelPartnerRepricingConfig channel_partner_repricing_configs = 1; // A token to retrieve the next page of results. - // Pass to [ListChannelPartnerRepricingConfigsRequest.page_token][google.cloud.channel.v1.ListChannelPartnerRepricingConfigsRequest.page_token] to obtain - // that page. + // Pass to + // [ListChannelPartnerRepricingConfigsRequest.page_token][google.cloud.channel.v1.ListChannelPartnerRepricingConfigsRequest.page_token] + // to obtain that page. string next_page_token = 2; } // Request message for // [CloudChannelService.CreateChannelPartnerRepricingConfig][google.cloud.channel.v1.CloudChannelService.CreateChannelPartnerRepricingConfig]. message CreateChannelPartnerRepricingConfigRequest { - // Required. The resource name of the ChannelPartner that will receive the repricing - // config. Parent uses the format: + // Required. The resource name of the ChannelPartner that will receive the + // repricing config. Parent uses the format: // accounts/{account_id}/channelPartnerLinks/{channel_partner_id} string parent = 1 [ (google.api.field_behavior) = REQUIRED, @@ -1832,19 +1983,22 @@ message CreateChannelPartnerRepricingConfigRequest { ]; // Required. The ChannelPartnerRepricingConfig object to update. - ChannelPartnerRepricingConfig channel_partner_repricing_config = 2 [(google.api.field_behavior) = REQUIRED]; + ChannelPartnerRepricingConfig channel_partner_repricing_config = 2 + [(google.api.field_behavior) = REQUIRED]; } // Request message for // [CloudChannelService.UpdateChannelPartnerRepricingConfig][google.cloud.channel.v1.CloudChannelService.UpdateChannelPartnerRepricingConfig]. message UpdateChannelPartnerRepricingConfigRequest { // Required. The ChannelPartnerRepricingConfig object to update. - ChannelPartnerRepricingConfig channel_partner_repricing_config = 1 [(google.api.field_behavior) = REQUIRED]; + ChannelPartnerRepricingConfig channel_partner_repricing_config = 1 + [(google.api.field_behavior) = REQUIRED]; } // Request message for DeleteChannelPartnerRepricingConfig. message DeleteChannelPartnerRepricingConfigRequest { - // Required. The resource name of the channel partner repricing config rule to delete. + // Required. The resource name of the channel partner repricing config rule to + // delete. string name = 1 [ (google.api.field_behavior) = REQUIRED, (google.api.resource_reference) = { @@ -1853,11 +2007,12 @@ message DeleteChannelPartnerRepricingConfigRequest { ]; } -// Request message for [CloudChannelService.CreateEntitlement][google.cloud.channel.v1.CloudChannelService.CreateEntitlement] +// Request message for +// [CloudChannelService.CreateEntitlement][google.cloud.channel.v1.CloudChannelService.CreateEntitlement] message CreateEntitlementRequest { - // Required. The resource name of the reseller's customer account in which to create the - // entitlement. - // Parent uses the format: accounts/{account_id}/customers/{customer_id} + // Required. The resource name of the reseller's customer account in which to + // create the entitlement. Parent uses the format: + // accounts/{account_id}/customers/{customer_id} string parent = 1 [ (google.api.field_behavior) = REQUIRED, (google.api.resource_reference) = { @@ -1868,8 +2023,9 @@ message CreateEntitlementRequest { // Required. The entitlement to create. Entitlement entitlement = 2 [(google.api.field_behavior) = REQUIRED]; - // Optional. You can specify an optional unique request ID, and if you need to retry - // your request, the server will know to ignore the request if it's complete. + // Optional. You can specify an optional unique request ID, and if you need to + // retry your request, the server will know to ignore the request if it's + // complete. // // For example, you make an initial request and the request times out. If you // make the request again with the same request ID, the server can check if @@ -1882,15 +2038,17 @@ message CreateEntitlementRequest { string request_id = 5 [(google.api.field_behavior) = OPTIONAL]; } -// Request message for [CloudChannelService.TransferEntitlements][google.cloud.channel.v1.CloudChannelService.TransferEntitlements]. +// Request message for +// [CloudChannelService.TransferEntitlements][google.cloud.channel.v1.CloudChannelService.TransferEntitlements]. message TransferEntitlementsRequest { - // Required. The resource name of the reseller's customer account that will receive - // transferred entitlements. - // Parent uses the format: accounts/{account_id}/customers/{customer_id} + // Required. The resource name of the reseller's customer account that will + // receive transferred entitlements. Parent uses the format: + // accounts/{account_id}/customers/{customer_id} string parent = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The new entitlements to create or transfer. - repeated Entitlement entitlements = 2 [(google.api.field_behavior) = REQUIRED]; + repeated Entitlement entitlements = 2 + [(google.api.field_behavior) = REQUIRED]; // The super admin of the resold customer generates this token to // authorize a reseller to access their Cloud Identity and purchase @@ -1898,8 +2056,9 @@ message TransferEntitlementsRequest { // See https://support.google.com/a/answer/7643790 for more details. string auth_token = 4; - // Optional. You can specify an optional unique request ID, and if you need to retry - // your request, the server will know to ignore the request if it's complete. + // Optional. You can specify an optional unique request ID, and if you need to + // retry your request, the server will know to ignore the request if it's + // complete. // // For example, you make an initial request and the request times out. If you // make the request again with the same request ID, the server can check if @@ -1912,25 +2071,29 @@ message TransferEntitlementsRequest { string request_id = 6 [(google.api.field_behavior) = OPTIONAL]; } -// Response message for [CloudChannelService.TransferEntitlements][google.cloud.channel.v1.CloudChannelService.TransferEntitlements]. +// Response message for +// [CloudChannelService.TransferEntitlements][google.cloud.channel.v1.CloudChannelService.TransferEntitlements]. // This is put in the response field of google.longrunning.Operation. message TransferEntitlementsResponse { // The transferred entitlements. repeated Entitlement entitlements = 1; } -// Request message for [CloudChannelService.TransferEntitlementsToGoogle][google.cloud.channel.v1.CloudChannelService.TransferEntitlementsToGoogle]. +// Request message for +// [CloudChannelService.TransferEntitlementsToGoogle][google.cloud.channel.v1.CloudChannelService.TransferEntitlementsToGoogle]. message TransferEntitlementsToGoogleRequest { - // Required. The resource name of the reseller's customer account where the entitlements - // transfer from. - // Parent uses the format: accounts/{account_id}/customers/{customer_id} + // Required. The resource name of the reseller's customer account where the + // entitlements transfer from. Parent uses the format: + // accounts/{account_id}/customers/{customer_id} string parent = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The entitlements to transfer to Google. - repeated Entitlement entitlements = 2 [(google.api.field_behavior) = REQUIRED]; + repeated Entitlement entitlements = 2 + [(google.api.field_behavior) = REQUIRED]; - // Optional. You can specify an optional unique request ID, and if you need to retry - // your request, the server will know to ignore the request if it's complete. + // Optional. You can specify an optional unique request ID, and if you need to + // retry your request, the server will know to ignore the request if it's + // complete. // // For example, you make an initial request and the request times out. If you // make the request again with the same request ID, the server can check if @@ -1950,14 +2113,17 @@ message ChangeParametersRequest { // accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id} string name = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. Entitlement parameters to update. You can only change editable parameters. + // Required. Entitlement parameters to update. You can only change editable + // parameters. // // To view the available Parameters for a request, refer to the - // [Offer.parameter_definitions][google.cloud.channel.v1.Offer.parameter_definitions] from the desired offer. + // [Offer.parameter_definitions][google.cloud.channel.v1.Offer.parameter_definitions] + // from the desired offer. repeated Parameter parameters = 2 [(google.api.field_behavior) = REQUIRED]; - // Optional. You can specify an optional unique request ID, and if you need to retry - // your request, the server will know to ignore the request if it's complete. + // Optional. You can specify an optional unique request ID, and if you need to + // retry your request, the server will know to ignore the request if it's + // complete. // // For example, you make an initial request and the request times out. If you // make the request again with the same request ID, the server can check if @@ -1973,7 +2139,8 @@ message ChangeParametersRequest { string purchase_order_id = 5 [(google.api.field_behavior) = OPTIONAL]; } -// Request message for [CloudChannelService.ChangeRenewalSettings][google.cloud.channel.v1.CloudChannelService.ChangeRenewalSettings]. +// Request message for +// [CloudChannelService.ChangeRenewalSettings][google.cloud.channel.v1.CloudChannelService.ChangeRenewalSettings]. message ChangeRenewalSettingsRequest { // Required. The name of the entitlement to update. // Name uses the format: @@ -1983,8 +2150,9 @@ message ChangeRenewalSettingsRequest { // Required. New renewal settings. RenewalSettings renewal_settings = 4 [(google.api.field_behavior) = REQUIRED]; - // Optional. You can specify an optional unique request ID, and if you need to retry - // your request, the server will know to ignore the request if it's complete. + // Optional. You can specify an optional unique request ID, and if you need to + // retry your request, the server will know to ignore the request if it's + // complete. // // For example, you make an initial request and the request times out. If you // make the request again with the same request ID, the server can check if @@ -1997,7 +2165,8 @@ message ChangeRenewalSettingsRequest { string request_id = 5 [(google.api.field_behavior) = OPTIONAL]; } -// Request message for [CloudChannelService.ChangeOffer][google.cloud.channel.v1.CloudChannelService.ChangeOffer]. +// Request message for +// [CloudChannelService.ChangeOffer][google.cloud.channel.v1.CloudChannelService.ChangeOffer]. message ChangeOfferRequest { // Required. The resource name of the entitlement to update. // Name uses the format: @@ -2013,15 +2182,18 @@ message ChangeOfferRequest { } ]; - // Optional. Parameters needed to purchase the Offer. To view the available Parameters - // refer to the [Offer.parameter_definitions][google.cloud.channel.v1.Offer.parameter_definitions] from the desired offer. + // Optional. Parameters needed to purchase the Offer. To view the available + // Parameters refer to the + // [Offer.parameter_definitions][google.cloud.channel.v1.Offer.parameter_definitions] + // from the desired offer. repeated Parameter parameters = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Purchase order id provided by the reseller. string purchase_order_id = 5 [(google.api.field_behavior) = OPTIONAL]; - // Optional. You can specify an optional unique request ID, and if you need to retry - // your request, the server will know to ignore the request if it's complete. + // Optional. You can specify an optional unique request ID, and if you need to + // retry your request, the server will know to ignore the request if it's + // complete. // // For example, you make an initial request and the request times out. If you // make the request again with the same request ID, the server can check if @@ -2034,15 +2206,17 @@ message ChangeOfferRequest { string request_id = 6 [(google.api.field_behavior) = OPTIONAL]; } -// Request message for [CloudChannelService.StartPaidService][google.cloud.channel.v1.CloudChannelService.StartPaidService]. +// Request message for +// [CloudChannelService.StartPaidService][google.cloud.channel.v1.CloudChannelService.StartPaidService]. message StartPaidServiceRequest { // Required. The name of the entitlement to start a paid service for. // Name uses the format: // accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id} string name = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. You can specify an optional unique request ID, and if you need to retry - // your request, the server will know to ignore the request if it's complete. + // Optional. You can specify an optional unique request ID, and if you need to + // retry your request, the server will know to ignore the request if it's + // complete. // // For example, you make an initial request and the request times out. If you // make the request again with the same request ID, the server can check if @@ -2055,15 +2229,17 @@ message StartPaidServiceRequest { string request_id = 3 [(google.api.field_behavior) = OPTIONAL]; } -// Request message for [CloudChannelService.CancelEntitlement][google.cloud.channel.v1.CloudChannelService.CancelEntitlement]. +// Request message for +// [CloudChannelService.CancelEntitlement][google.cloud.channel.v1.CloudChannelService.CancelEntitlement]. message CancelEntitlementRequest { // Required. The resource name of the entitlement to cancel. // Name uses the format: // accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id} string name = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. You can specify an optional unique request ID, and if you need to retry - // your request, the server will know to ignore the request if it's complete. + // Optional. You can specify an optional unique request ID, and if you need to + // retry your request, the server will know to ignore the request if it's + // complete. // // For example, you make an initial request and the request times out. If you // make the request again with the same request ID, the server can check if @@ -2076,15 +2252,17 @@ message CancelEntitlementRequest { string request_id = 3 [(google.api.field_behavior) = OPTIONAL]; } -// Request message for [CloudChannelService.SuspendEntitlement][google.cloud.channel.v1.CloudChannelService.SuspendEntitlement]. +// Request message for +// [CloudChannelService.SuspendEntitlement][google.cloud.channel.v1.CloudChannelService.SuspendEntitlement]. message SuspendEntitlementRequest { // Required. The resource name of the entitlement to suspend. // Name uses the format: // accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id} string name = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. You can specify an optional unique request ID, and if you need to retry - // your request, the server will know to ignore the request if it's complete. + // Optional. You can specify an optional unique request ID, and if you need to + // retry your request, the server will know to ignore the request if it's + // complete. // // For example, you make an initial request and the request times out. If you // make the request again with the same request ID, the server can check if @@ -2097,15 +2275,17 @@ message SuspendEntitlementRequest { string request_id = 3 [(google.api.field_behavior) = OPTIONAL]; } -// Request message for [CloudChannelService.ActivateEntitlement][google.cloud.channel.v1.CloudChannelService.ActivateEntitlement]. +// Request message for +// [CloudChannelService.ActivateEntitlement][google.cloud.channel.v1.CloudChannelService.ActivateEntitlement]. message ActivateEntitlementRequest { // Required. The resource name of the entitlement to activate. // Name uses the format: // accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id} string name = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. You can specify an optional unique request ID, and if you need to retry - // your request, the server will know to ignore the request if it's complete. + // Optional. You can specify an optional unique request ID, and if you need to + // retry your request, the server will know to ignore the request if it's + // complete. // // For example, you make an initial request and the request times out. If you // make the request again with the same request ID, the server can check if @@ -2137,9 +2317,9 @@ message ListProductsRequest { // Format: accounts/{account_id}. string account = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. Requested page size. Server might return fewer results than requested. - // If unspecified, returns at most 100 Products. - // The maximum value is 1000; the server will coerce values above 1000. + // Optional. Requested page size. Server might return fewer results than + // requested. If unspecified, returns at most 100 Products. The maximum value + // is 1000; the server will coerce values above 1000. int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token for a page of results other than the first page. @@ -2176,9 +2356,9 @@ message ListSkusRequest { // Format: accounts/{account_id}. string account = 2 [(google.api.field_behavior) = REQUIRED]; - // Optional. Requested page size. Server might return fewer results than requested. - // If unspecified, returns at most 100 SKUs. - // The maximum value is 1000; the server will coerce values above 1000. + // Optional. Requested page size. Server might return fewer results than + // requested. If unspecified, returns at most 100 SKUs. The maximum value is + // 1000; the server will coerce values above 1000. int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token for a page of results other than the first page. @@ -2202,13 +2382,13 @@ message ListSkusResponse { // Request message for ListOffers. message ListOffersRequest { - // Required. The resource name of the reseller account from which to list Offers. - // Parent uses the format: accounts/{account_id}. + // Required. The resource name of the reseller account from which to list + // Offers. Parent uses the format: accounts/{account_id}. string parent = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. Requested page size. Server might return fewer results than requested. - // If unspecified, returns at most 500 Offers. - // The maximum value is 1000; the server will coerce values above 1000. + // Optional. Requested page size. Server might return fewer results than + // requested. If unspecified, returns at most 500 Offers. The maximum value is + // 1000; the server will coerce values above 1000. int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token for a page of results other than the first page. @@ -2248,7 +2428,8 @@ message ListPurchasableSkusRequest { } // List SKUs for upgrading or downgrading an entitlement. Make the purchase - // using [CloudChannelService.ChangeOffer][google.cloud.channel.v1.CloudChannelService.ChangeOffer]. + // using + // [CloudChannelService.ChangeOffer][google.cloud.channel.v1.CloudChannelService.ChangeOffer]. message ChangeOfferPurchase { // Change Type enum. enum ChangeType { @@ -2289,9 +2470,9 @@ message ListPurchasableSkusRequest { } ]; - // Optional. Requested page size. Server might return fewer results than requested. - // If unspecified, returns at most 100 SKUs. - // The maximum value is 1000; the server will coerce values above 1000. + // Optional. Requested page size. Server might return fewer results than + // requested. If unspecified, returns at most 100 SKUs. The maximum value is + // 1000; the server will coerce values above 1000. int32 page_size = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token for a page of results other than the first page. @@ -2359,9 +2540,9 @@ message ListPurchasableOffersRequest { } ]; - // Optional. Requested page size. Server might return fewer results than requested. - // If unspecified, returns at most 100 Offers. - // The maximum value is 1000; the server will coerce values above 1000. + // Optional. Requested page size. Server might return fewer results than + // requested. If unspecified, returns at most 100 Offers. The maximum value is + // 1000; the server will coerce values above 1000. int32 page_size = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token for a page of results other than the first page. @@ -2394,7 +2575,8 @@ message RegisterSubscriberRequest { // Required. Resource name of the account. string account = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. Service account that provides subscriber access to the registered topic. + // Required. Service account that provides subscriber access to the registered + // topic. string service_account = 2 [(google.api.field_behavior) = REQUIRED]; } @@ -2409,7 +2591,8 @@ message UnregisterSubscriberRequest { // Required. Resource name of the account. string account = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. Service account to unregister from subscriber access to the topic. + // Required. Service account to unregister from subscriber access to the + // topic. string service_account = 2 [(google.api.field_behavior) = REQUIRED]; } @@ -2424,10 +2607,10 @@ message ListSubscribersRequest { // Required. Resource name of the account. string account = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. The maximum number of service accounts to return. The service may return - // fewer than this value. - // If unspecified, returns at most 100 service accounts. - // The maximum value is 1000; the server will coerce values above 1000. + // Optional. The maximum number of service accounts to return. The service may + // return fewer than this value. If unspecified, returns at most 100 service + // accounts. The maximum value is 1000; the server will coerce values above + // 1000. int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. A page token, received from a previous `ListSubscribers` call. @@ -2449,4 +2632,4 @@ message ListSubscribersResponse { // A token that can be sent as `page_token` to retrieve the next page. // If this field is omitted, there are no subsequent pages. string next_page_token = 3; -} +} \ No newline at end of file diff --git a/google/cloud/channel/v1/subscriber_event.proto b/google/cloud/channel/v1/subscriber_event.proto index 3c67216ed6..0135c066f4 100644 --- a/google/cloud/channel/v1/subscriber_event.proto +++ b/google/cloud/channel/v1/subscriber_event.proto @@ -40,8 +40,8 @@ message CustomerEvent { // Resource name of the customer. // Format: accounts/{account_id}/customers/{customer_id} string customer = 1 [(google.api.resource_reference) = { - type: "cloudchannel.googleapis.com/Customer" - }]; + type: "cloudchannel.googleapis.com/Customer" + }]; // Type of event which happened on the customer. Type event_type = 2; @@ -97,8 +97,8 @@ message EntitlementEvent { // Resource name of an entitlement of the form: // accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id} string entitlement = 1 [(google.api.resource_reference) = { - type: "cloudchannel.googleapis.com/Entitlement" - }]; + type: "cloudchannel.googleapis.com/Entitlement" + }]; // Type of event which happened on the entitlement. Type event_type = 2; @@ -116,4 +116,4 @@ message SubscriberEvent { // Entitlement event sent as part of Pub/Sub event to partners. EntitlementEvent entitlement_event = 2; } -} +} \ No newline at end of file