# Generated by the protocol buffer compiler. DO NOT EDIT!
# Source: google/cloud/channel/v1/service.proto for package 'google.cloud.channel.v1'
# Original file comments:
# Copyright 2020 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
require 'grpc'
require 'google/cloud/channel/v1/service_pb'
module Google
module Cloud
module Channel
module V1
module CloudChannelService
# CloudChannelService lets Google cloud resellers and distributors manage
# their customers, channel partners, entitlements, and reports.
#
# Using this service:
# 1. Resellers and distributors can manage a customer entity.
# 2. Distributors can register an authorized reseller in their channel and
# provide them with delegated admin access.
# 3. Resellers and distributors can manage customer entitlements.
#
# CloudChannelService exposes the following resources:
# - [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.
#
# - [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s: An
# entity that identifies links between distributors and their indirect
# resellers in a channel.
class Service
include ::GRPC::GenericService
self.marshal_class_method = :encode
self.unmarshal_class_method = :decode
self.service_name = 'google.cloud.channel.v1.CloudChannelService'
# List [Customer][google.cloud.channel.v1.Customer]s.
#
# 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.
#
# Return value:
# List of [Customer][google.cloud.channel.v1.Customer]s, or an empty list if
# there are no customers.
rpc :ListCustomers, ::Google::Cloud::Channel::V1::ListCustomersRequest, ::Google::Cloud::Channel::V1::ListCustomersResponse
# Returns the requested [Customer][google.cloud.channel.v1.Customer]
# resource.
#
# 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: The customer resource doesn't exist. Usually the result of an
# invalid name parameter.
#
# Return value:
# The [Customer][google.cloud.channel.v1.Customer] resource.
rpc :GetCustomer, ::Google::Cloud::Channel::V1::GetCustomerRequest, ::Google::Cloud::Channel::V1::Customer
# Confirms the existence of Cloud Identity accounts based on the domain and
# if the Cloud Identity accounts are owned by the reseller.
#
# 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.
# * 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)
#
# 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, ::Google::Cloud::Channel::V1::CheckCloudIdentityAccountsExistRequest, ::Google::Cloud::Channel::V1::CheckCloudIdentityAccountsExistResponse
# Creates a new [Customer][google.cloud.channel.v1.Customer] resource under
# the reseller or distributor account.
#
# Possible error codes:
#
# * 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.
# * Domain field value doesn't match the primary email domain.
#
# Return value:
# The newly created [Customer][google.cloud.channel.v1.Customer] resource.
rpc :CreateCustomer, ::Google::Cloud::Channel::V1::CreateCustomerRequest, ::Google::Cloud::Channel::V1::Customer
# 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.
#
# Return value:
# The updated [Customer][google.cloud.channel.v1.Customer] resource.
rpc :UpdateCustomer, ::Google::Cloud::Channel::V1::UpdateCustomerRequest, ::Google::Cloud::Channel::V1::Customer
# Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently.
#
# 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 customer has existing entitlements.
# * NOT_FOUND: No [Customer][google.cloud.channel.v1.Customer] resource found
# for the name in the request.
rpc :DeleteCustomer, ::Google::Cloud::Channel::V1::DeleteCustomerRequest, ::Google::Protobuf::Empty
# 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:
#
# * PERMISSION_DENIED: The reseller account making the request is different
# from the reseller account in the API request.
# * NOT_FOUND: Cloud Identity doesn't exist or was deleted.
# * INVALID_ARGUMENT: Required parameters are missing, or the auth_token is
# expired or invalid.
# * ALREADY_EXISTS: A customer already exists and has conflicting critical
# fields. Requires an overwrite.
#
# Return value:
# The [Customer][google.cloud.channel.v1.Customer].
rpc :ImportCustomer, ::Google::Cloud::Channel::V1::ImportCustomerRequest, ::Google::Cloud::Channel::V1::Customer
# Creates a Cloud Identity for the given customer using the customer's
# information, or the information provided here.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * NOT_FOUND: The customer was not found.
# * ALREADY_EXISTS: The customer's primary email already exists. Retry
# after changing the customer's primary contact email.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The ID of a long-running operation.
#
# 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, ::Google::Cloud::Channel::V1::ProvisionCloudIdentityRequest, ::Google::Longrunning::Operation
# Lists [Entitlement][google.cloud.channel.v1.Entitlement]s belonging to a
# customer.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller.
# * 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, ::Google::Cloud::Channel::V1::ListEntitlementsRequest, ::Google::Cloud::Channel::V1::ListEntitlementsResponse
# 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
# Cloud Identity ID or Customer Name.
#
# Possible error codes:
#
# * PERMISSION_DENIED:
# * The customer doesn't belong to the reseller and has no auth token.
# * The supplied auth token is invalid.
# * The reseller account making the request is different
# from the reseller account in the query.
# * 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, ::Google::Cloud::Channel::V1::ListTransferableSkusRequest, ::Google::Cloud::Channel::V1::ListTransferableSkusResponse
# List [TransferableOffer][google.cloud.channel.v1.TransferableOffer]s of a
# customer based on Cloud Identity ID or Customer Name in the request.
#
# Use this method when a reseller gets the entitlement information of an
# unowned customer. The reseller should provide the customer's
# Cloud Identity ID or Customer Name.
#
# Possible error codes:
#
# * PERMISSION_DENIED:
# * The customer doesn't belong to the reseller and has no auth token.
# * The customer provided incorrect reseller information when generating
# auth token.
# * The reseller account making the request is different
# from the reseller account in the query.
# * 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, ::Google::Cloud::Channel::V1::ListTransferableOffersRequest, ::Google::Cloud::Channel::V1::ListTransferableOffersResponse
# Returns the requested [Entitlement][google.cloud.channel.v1.Entitlement]
# resource.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * NOT_FOUND: The customer entitlement was not found.
#
# Return value:
# The requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
rpc :GetEntitlement, ::Google::Cloud::Channel::V1::GetEntitlementRequest, ::Google::Cloud::Channel::V1::Entitlement
# Creates an entitlement for a customer.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller.
# * INVALID_ARGUMENT:
# * Required request parameters are missing or invalid.
# * There is already a customer entitlement for a SKU from the same
# product family.
# * INVALID_VALUE: Make sure the OfferId is valid. If it is, contact
# Google Channel support for further troubleshooting.
# * NOT_FOUND: The customer or offer resource was not found.
# * ALREADY_EXISTS:
# * The SKU was already purchased for the customer.
# * The customer's primary email already exists. Retry
# after changing the customer's primary contact email.
# * CONDITION_NOT_MET or FAILED_PRECONDITION:
# * The domain required for purchasing a SKU has not been verified.
# * A pre-requisite SKU required to purchase an Add-On SKU is missing.
# For example, Google Workspace Business Starter is required to purchase
# Vault or Drive.
# * (Developer accounts only) Reseller and resold domain must meet the
# following naming requirements:
# * Domain names must start with goog-test.
# * Domain names must include the reseller domain.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The ID of a long-running operation.
#
# 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, ::Google::Cloud::Channel::V1::CreateEntitlementRequest, ::Google::Longrunning::Operation
# Change parameters of the entitlement.
#
# An entitlement update is a long-running operation and it updates the
# entitlement as a result of fulfillment.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# For example, the number of seats being changed is greater than the allowed
# number of max seats, or decreasing seats for a commitment based plan.
# * NOT_FOUND: Entitlement resource not found.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The ID of a long-running operation.
#
# 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, ::Google::Cloud::Channel::V1::ChangeParametersRequest, ::Google::Longrunning::Operation
# Updates the renewal settings for an existing customer entitlement.
#
# An entitlement update is a long-running operation and it updates the
# entitlement as a result of fulfillment.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * NOT_FOUND: Entitlement resource not found.
# * NOT_COMMITMENT_PLAN: Renewal Settings are only applicable for a
# commitment plan. Can't enable or disable renewals for non-commitment plans.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The ID of a long-running operation.
#
# 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, ::Google::Cloud::Channel::V1::ChangeRenewalSettingsRequest, ::Google::Longrunning::Operation
# Updates the Offer for an existing customer entitlement.
#
# An entitlement update is a long-running operation and it updates the
# entitlement as a result of fulfillment.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * NOT_FOUND: Offer or Entitlement resource not found.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The ID of a long-running operation.
#
# 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 :ChangeOffer, ::Google::Cloud::Channel::V1::ChangeOfferRequest, ::Google::Longrunning::Operation
# Starts paid service for a trial entitlement.
#
# Starts paid service for a trial entitlement immediately. This method is
# only applicable if a plan is set up for a trial entitlement but has some
# trial days remaining.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * NOT_FOUND: Entitlement resource not found.
# * FAILED_PRECONDITION/NOT_IN_TRIAL: This method only works for
# entitlement on trial plans.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The ID of a long-running operation.
#
# 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, ::Google::Cloud::Channel::V1::StartPaidServiceRequest, ::Google::Longrunning::Operation
# Suspends a previously fulfilled entitlement.
#
# An entitlement suspension is a long-running operation.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * NOT_FOUND: Entitlement resource not found.
# * NOT_ACTIVE: Entitlement is not active.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The ID of a long-running operation.
#
# 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, ::Google::Cloud::Channel::V1::SuspendEntitlementRequest, ::Google::Longrunning::Operation
# Cancels a previously fulfilled entitlement.
#
# An entitlement cancellation is a long-running operation.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The reseller account making the request is different
# from the reseller account in the API request.
# * FAILED_PRECONDITION: There are Google Cloud projects linked to the
# Google Cloud entitlement's Cloud Billing subaccount.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * NOT_FOUND: Entitlement resource not found.
# * DELETION_TYPE_NOT_ALLOWED: Cancel is only allowed for Google Workspace
# add-ons, or entitlements for Google Cloud's development platform.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The ID of a long-running operation.
#
# To get the results of the operation, call the GetOperation method of
# 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, ::Google::Cloud::Channel::V1::CancelEntitlementRequest, ::Google::Longrunning::Operation
# Activates a previously suspended entitlement. Entitlements suspended for
# pending ToS acceptance can't be activated using this method.
#
# An entitlement activation is a long-running operation and it updates
# the state of the customer entitlement.
#
# 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: Entitlement resource not found.
# * SUSPENSION_NOT_RESELLER_INITIATED: Can only activate reseller-initiated
# suspensions and entitlements that have accepted the TOS.
# * NOT_SUSPENDED: Can only activate suspended entitlements not in an ACTIVE
# state.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The ID of a long-running operation.
#
# 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, ::Google::Cloud::Channel::V1::ActivateEntitlementRequest, ::Google::Longrunning::Operation
# Transfers customer entitlements to new reseller.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * NOT_FOUND: The customer or offer resource was not found.
# * ALREADY_EXISTS: The SKU was already transferred for the customer.
# * CONDITION_NOT_MET or FAILED_PRECONDITION:
# * The SKU requires domain verification to transfer, but the domain is
# not verified.
# * An Add-On SKU (example, Vault or Drive) is missing the
# pre-requisite SKU (example, G Suite Basic).
# * (Developer accounts only) Reseller and resold domain must meet the
# following naming requirements:
# * Domain names must start with goog-test.
# * Domain names must include the reseller domain.
# * Specify all transferring entitlements.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The ID of a long-running operation.
#
# 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, ::Google::Cloud::Channel::V1::TransferEntitlementsRequest, ::Google::Longrunning::Operation
# Transfers customer entitlements from their current reseller to Google.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * NOT_FOUND: The customer or offer resource was not found.
# * ALREADY_EXISTS: The SKU was already transferred for the customer.
# * CONDITION_NOT_MET or FAILED_PRECONDITION:
# * The SKU requires domain verification to transfer, but the domain is
# not verified.
# * An Add-On SKU (example, Vault or Drive) is missing the
# pre-requisite SKU (example, G Suite Basic).
# * (Developer accounts only) Reseller and resold domain must meet the
# following naming requirements:
# * Domain names must start with goog-test.
# * Domain names must include the reseller domain.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The ID of a long-running operation.
#
# To get the results of the operation, call the GetOperation method of
# 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, ::Google::Cloud::Channel::V1::TransferEntitlementsToGoogleRequest, ::Google::Longrunning::Operation
# List [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]s
# belonging to a distributor. You must be a distributor to call this method.
#
# 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.
#
# Return value:
# The list of the distributor account's
# [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resources.
rpc :ListChannelPartnerLinks, ::Google::Cloud::Channel::V1::ListChannelPartnerLinksRequest, ::Google::Cloud::Channel::V1::ListChannelPartnerLinksResponse
# Returns the requested
# [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
# You must be a distributor to call this method.
#
# 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: ChannelPartnerLink resource not found because of an
# invalid channel partner link name.
#
# Return value:
# The [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]
# resource.
rpc :GetChannelPartnerLink, ::Google::Cloud::Channel::V1::GetChannelPartnerLinkRequest, ::Google::Cloud::Channel::V1::ChannelPartnerLink
# Initiates a channel partner link between a distributor and a reseller, or
# between resellers in an n-tier reseller channel.
# Invited partners need to follow the invite_link_uri provided in the
# response to accept. After accepting the invitation, a link is set up
# between the two parties.
# You must be a distributor to call this method.
#
# 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.
# * ALREADY_EXISTS: The ChannelPartnerLink sent in the request already
# exists.
# * NOT_FOUND: No Cloud Identity customer exists for provided domain.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The new [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]
# resource.
rpc :CreateChannelPartnerLink, ::Google::Cloud::Channel::V1::CreateChannelPartnerLinkRequest, ::Google::Cloud::Channel::V1::ChannelPartnerLink
# Updates a channel partner link. Distributors call this method to change a
# link's status. For example, to suspend a partner link.
# You must be a distributor to call this method.
#
# 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.
# * Link state cannot change from invited to active or suspended.
# * Cannot send reseller_cloud_identity_id, invite_url, or name in update
# mask.
# * NOT_FOUND: ChannelPartnerLink resource not found.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The updated
# [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
rpc :UpdateChannelPartnerLink, ::Google::Cloud::Channel::V1::UpdateChannelPartnerLinkRequest, ::Google::Cloud::Channel::V1::ChannelPartnerLink
# Gets information about how a Reseller modifies their bill before sending
# it to a Customer.
#
# Possible Error Codes:
#
# * 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.
# * 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, ::Google::Cloud::Channel::V1::GetCustomerRepricingConfigRequest, ::Google::Cloud::Channel::V1::CustomerRepricingConfig
# Lists information about how a Reseller modifies their bill before sending
# it to a Customer.
#
# Possible Error Codes:
#
# * 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.
# * 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:
# * 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, ::Google::Cloud::Channel::V1::ListCustomerRepricingConfigsRequest, ::Google::Cloud::Channel::V1::ListCustomerRepricingConfigsResponse
# 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.
#
# When creating a config for a future month, make sure there are no existing
# configs for that
# [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month].
#
# The following restrictions are for creating configs in the current month.
#
# * This functionality is reserved for recovering from an erroneous config,
# and should not be used for regular business cases.
# * The new config will not modify exports used with other configs.
# 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
# [RepricingConfig.EntitlementGranularity.entitlement][google.cloud.channel.v1.RepricingConfig.EntitlementGranularity.entitlement].
#
# Possible Error Codes:
#
# * PERMISSION_DENIED: If the account making the request and the account
# being queried are different.
# * 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.
# * 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, ::Google::Cloud::Channel::V1::CreateCustomerRepricingConfigRequest, ::Google::Cloud::Channel::V1::CustomerRepricingConfig
# Updates a CustomerRepricingConfig. Call this method to set modifications
# for a specific customer's bill. This method overwrites 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
# [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:
#
# * This config must already exist.
#
# Possible Error Codes:
#
# * PERMISSION_DENIED: If the account making the request and the account
# being queried are different.
# * 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.
# * 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, ::Google::Cloud::Channel::V1::UpdateCustomerRepricingConfigRequest, ::Google::Cloud::Channel::V1::CustomerRepricingConfig
# 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, ::Google::Cloud::Channel::V1::DeleteCustomerRepricingConfigRequest, ::Google::Protobuf::Empty
# Gets information about how a Distributor modifies their bill before sending
# it to a ChannelPartner.
#
# Possible Error Codes:
#
# * 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.
# * 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, ::Google::Cloud::Channel::V1::GetChannelPartnerRepricingConfigRequest, ::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig
# Lists information about how a Reseller modifies their bill before sending
# it to a ChannelPartner.
#
# Possible Error Codes:
#
# * 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.
# * 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:
# * 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, ::Google::Cloud::Channel::V1::ListChannelPartnerRepricingConfigsRequest, ::Google::Cloud::Channel::V1::ListChannelPartnerRepricingConfigsResponse
# 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.
#
# When creating a config for a future month, make sure there are no existing
# configs for that
# [RepricingConfig.effective_invoice_month][google.cloud.channel.v1.RepricingConfig.effective_invoice_month].
#
# The following restrictions are for creating configs in the current month.
#
# * This functionality is reserved for recovering from an erroneous config,
# and should not be used for regular business cases.
# * The new config will not modify exports used with other configs.
# 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
# ChannelPartner.
#
# Possible Error Codes:
#
# * PERMISSION_DENIED: If the account making the request and the account
# being queried are different.
# * 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.
# * 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, ::Google::Cloud::Channel::V1::CreateChannelPartnerRepricingConfigRequest, ::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig
# Updates a ChannelPartnerRepricingConfig. Call this method to set
# modifications for a specific ChannelPartner's bill. This method overwrites
# 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].
#
# When updating a config in the future:
#
# * This config must already exist.
#
# Possible Error Codes:
#
# * PERMISSION_DENIED: If the account making the request and the account
# being queried are different.
# * 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.
# * 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, ::Google::Cloud::Channel::V1::UpdateChannelPartnerRepricingConfigRequest, ::Google::Cloud::Channel::V1::ChannelPartnerRepricingConfig
# 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, ::Google::Cloud::Channel::V1::DeleteChannelPartnerRepricingConfigRequest, ::Google::Protobuf::Empty
# Returns the requested [Offer][google.cloud.channel.v1.Offer] resource.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The entitlement doesn't belong to the reseller.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * NOT_FOUND: Entitlement or offer was not found.
#
# Return value:
# The [Offer][google.cloud.channel.v1.Offer] resource.
rpc :LookupOffer, ::Google::Cloud::Channel::V1::LookupOfferRequest, ::Google::Cloud::Channel::V1::Offer
# Lists the Products the reseller is authorized to sell.
#
# Possible error codes:
#
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
rpc :ListProducts, ::Google::Cloud::Channel::V1::ListProductsRequest, ::Google::Cloud::Channel::V1::ListProductsResponse
# Lists the SKUs for a product the reseller is authorized to sell.
#
# Possible error codes:
#
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
rpc :ListSkus, ::Google::Cloud::Channel::V1::ListSkusRequest, ::Google::Cloud::Channel::V1::ListSkusResponse
# Lists the Offers the reseller can sell.
#
# Possible error codes:
#
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
rpc :ListOffers, ::Google::Cloud::Channel::V1::ListOffersRequest, ::Google::Cloud::Channel::V1::ListOffersResponse
# Lists the following:
#
# * SKUs that you can purchase for a customer
# * SKUs that you can upgrade or downgrade for an entitlement.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
rpc :ListPurchasableSkus, ::Google::Cloud::Channel::V1::ListPurchasableSkusRequest, ::Google::Cloud::Channel::V1::ListPurchasableSkusResponse
# Lists the following:
#
# * Offers that you can purchase for a customer.
# * Offers that you can change for an entitlement.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The customer doesn't belong to the reseller
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
rpc :ListPurchasableOffers, ::Google::Cloud::Channel::V1::ListPurchasableOffersRequest, ::Google::Cloud::Channel::V1::ListPurchasableOffersResponse
# Registers a service account with subscriber privileges on the Cloud Pub/Sub
# topic for this Channel Services account. After you create a
# subscriber, you get the events through
# [SubscriberEvent][google.cloud.channel.v1.SubscriberEvent]
#
# Possible error codes:
#
# * PERMISSION_DENIED: The reseller account making the request and the
# provided reseller account are different, or the impersonated user
# is not a super admin.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# The topic name with the registered service email address.
rpc :RegisterSubscriber, ::Google::Cloud::Channel::V1::RegisterSubscriberRequest, ::Google::Cloud::Channel::V1::RegisterSubscriberResponse
# Unregisters a service account with subscriber privileges on the Cloud
# Pub/Sub topic created for this Channel Services account. If there are no
# service accounts left with subscriber privileges, this deletes the topic.
# You can call ListSubscribers to check for these accounts.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The reseller account making the request and the
# provided reseller account are different, or the impersonated user
# is not a super admin.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * NOT_FOUND: The topic resource doesn't exist.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# 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, ::Google::Cloud::Channel::V1::UnregisterSubscriberRequest, ::Google::Cloud::Channel::V1::UnregisterSubscriberResponse
# Lists service accounts with subscriber privileges on the Cloud Pub/Sub
# topic created for this Channel Services account.
#
# Possible error codes:
#
# * PERMISSION_DENIED: The reseller account making the request and the
# provided reseller account are different, or the impersonated user
# is not a super admin.
# * INVALID_ARGUMENT: Required request parameters are missing or invalid.
# * NOT_FOUND: The topic resource doesn't exist.
# * INTERNAL: Any non-user error related to a technical issue in the
# backend. Contact Cloud Channel support.
# * UNKNOWN: Any non-user error related to a technical issue in the backend.
# Contact Cloud Channel support.
#
# Return value:
# A list of service email addresses.
rpc :ListSubscribers, ::Google::Cloud::Channel::V1::ListSubscribersRequest, ::Google::Cloud::Channel::V1::ListSubscribersResponse
end
Stub = Service.rpc_stub_class
end
end
end
end
end