Method: accounts.customers.orders.create

Creates Order on behalf of a customer. Orders can be initiated based on a valid reseller offerId. An order creation is a long running operation. When an order succeeds, entitlements are created as a result of fulfillment. For SaaS, an order fulfillment typically results in a billing subscription being created. For IaaS offer, an order fulfillment typically results in a billing container being created that can be used for consumption billing.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

The resource name of reseller's customer account in which to create the order. Parent takes the format: 'accounts/{account_id}/customers/{customer_id}'

Query parameters

Parameters
enableDelegatedAdmin

boolean

If true, grants delegated admin rights to channel partner for fulfilled entitlements. Required to be true for G Suite order placements.

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.

Request body

The request body contains an instance of Order.

Response body

If successful, the response body contains a newly created 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!