Method: accounts.customers.entitlements.assignChannelPartner

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

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:

JSON representation
{
  "enableDelegatedAdmin": boolean,
  "channelPartnerId": string
}
Fields
enableDelegatedAdmin

boolean

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.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/apps.order

For more information, see the Authentication Overview.