Method: accounts.customers.entitlements.transfer

Transfers the entitlements to the reseller of the customer. This is called by the new reseller the entitlements will be transferred to.

HTTP request

POST https://cloudchannel.googleapis.com/v1alpha1/{parent=accounts/*/customers/*}/entitlements:transfer

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

The resource name of reseller's customer account where the entitlements transfer to. Parent takes the format: 'accounts/{account_id}/customers/{customer_id}'

Request body

The request body contains data with the following structure:

JSON representation 
{
  "entitlements": [
    {
      object(Entitlement)
    }
  ],
  "enableDelegatedAdmin": boolean,
  "channelPartnerId": string,
  "authToken": string,
  "externalCorrelationId": string
}
Fields
entitlements[]

object(Entitlement)

The entitlements to be transferred. This is the new offer_ids suggested.

enableDelegatedAdmin

boolean

If true, grants delegated admin rights to the channel partner for fulfilled entitlements. Applicable only if channelPartnerId is provided.

channelPartnerId

string

Cloud identity ID of a channel partner who will be the distributor authorized reseller (DAR) for the customer's entitlement. A DAR should have accepted an invitation from the top-level distributor, sent by calling CloudChannelService.CreateChannelPartnerLink. This field is generally used in 2-tier entitlement purchase where the purchase is placed by a top-level distributor on behalf of their DAR. If specified, cost allocation for this entitlement can be done for the partner in reports and DAR will have delegated admin access to the customer. Required for entitlement purchase for a distributor account only. If no partner should be assigned to this customer, distributor's own cloud identity ID should be used.

authToken

string

Optional. An auth token needed if it is not a customer of the reseller or disti.

externalCorrelationId

string

An optional identifier in the external system that partners can use to correlate a Channel Services purchase transaction for the entitlement.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires one of the following OAuth scopes:

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

For more information, see the Authentication Overview.

Try it!