Assigns a channel partner to an Entitlement resource. The assigned partner becomes the reseller for the entitlement and will gain delegated admin access to the customer's entitlement. 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: Entitlement or ChannelPartner resource not found. Usually because of an invalid channelPartnerId or entitlement name.
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 Entitlement resource with an updated channel partner.
HTTP request
POST https://cloudchannel.googleapis.com/v1alpha1/{name=accounts/*/customers/*/entitlements/*}:assignChannelPartner
Required. The resource name of the entitlement to assign. Name uses the format: accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id}
Request body
The request body contains data with the following structure:
Optional. If true, grants delegated admin rights to the channel partner for fulfilled entitlements. Applicable only if you provide a channelPartnerId.
channelPartnerId
string
Required. Cloud Identity ID of the channel partner who will be the indirect reseller for the customer's entitlement. An indirect reseller needs to accept an invitation from the top-level distributor, sent by calling CloudChannelService.CreateChannelPartnerLink. This field is used in 2-tier entitlement purchases, where the purchase is placed by a top-level distributor on behalf of their indirect reseller. Cost allocation for this entitlement can be done for the partner in reports, and the indirect reseller will have delegated admin access to the customer. Required for entitlement purchases for a distributor account only. If there is no partner to assign to this customer, use the distributor's own Cloud Identity ID.
Response body
If successful, the response body contains an instance of Entitlement.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-19 UTC."],[[["\u003cp\u003eThis API method allows a distributor to assign a channel partner as the reseller for a customer's entitlement, granting them delegated admin access.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the entitlement's resource name and the channel partner's Cloud Identity ID to be specified in the request body, along with an option to grant delegated admin rights.\u003c/p\u003e\n"],["\u003cp\u003ePossible errors include permission issues, invalid arguments, resource not found, and internal or unknown server errors, and distributors making a request on a reseller account will face permission issues.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return an updated Entitlement resource that now includes the newly assigned channel partner.\u003c/p\u003e\n"],["\u003cp\u003eThis method uses gRPC Transcoding for the HTTP request and requires the \u003ccode\u003ehttps://www.googleapis.com/auth/apps.order\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,[]]
