Method: accounts.customers.queryEligibleBillingAccounts

Lists the billing accounts that are eligible to purchase particular SKUs for a given 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: Based on the provided list of SKUs, returns a list of SKU groups that must be purchased using the same billing account and the billing accounts eligible to purchase each SKU group.

HTTP request

GET https://cloudchannel.googleapis.com/v1alpha1/{customer=accounts/*/customers/*}:queryEligibleBillingAccounts

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customer

string

Required. The resource name of the customer to list eligible billing accounts for. Format: accounts/{account_id}/customers/{customer_id}.

Query parameters

Parameters
skus[]

string

Required. List of SKUs to list eligible billing accounts for. At least one SKU is required. Format: products/{productId}/skus/{skuId}.

Request body

The request body must be empty.

Response body

Response message for customers.queryEligibleBillingAccounts.

If successful, the response body contains data with the following structure:

JSON representation
{
  "skuPurchaseGroups": [
    {
      object (SkuPurchaseGroup)
    }
  ]
}
Fields
skuPurchaseGroups[]

object (SkuPurchaseGroup)

List of SKU purchase groups where each group represents a set of SKUs that must be purchased using the same billing account. Each SKU from [QueryEligibleBillingAccountsRequest.skus] will appear in exactly one SKU group.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.

SkuPurchaseGroup

Represents a set of SKUs that must be purchased using the same billing account.

JSON representation
{
  "skus": [
    string
  ],
  "billingAccountPurchaseInfos": [
    {
      object (BillingAccountPurchaseInfo)
    }
  ]
}
Fields
skus[]

string

Resource names of the SKUs included in this group. Format: products/{productId}/skus/{skuId}.

billingAccountPurchaseInfos[]

object (BillingAccountPurchaseInfo)

List of billing accounts that are eligible to purhcase these SKUs.

BillingAccountPurchaseInfo

Represents a billing account that can be used to make a purchase.

JSON representation
{
  "billingAccount": {
    object (BillingAccount)
  }
}
Fields
billingAccount

object (BillingAccount)

The billing account resource.

BillingAccount

Represents a billing account.

JSON representation
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "currencyCode": string,
  "regionCode": string
}
Fields
name

string

Output only. Resource name of the billing account. Format: accounts/{account_id}/billingAccounts/{billing_account_id}.

displayName

string

Display name of the billing account.

createTime

string (Timestamp format)

Output only. The time when this billing account was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

currencyCode

string

Output only. The 3-letter currency code defined in ISO 4217.

regionCode

string

Output only. The CLDR region code.