- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- SkuPurchaseGroup
- BillingAccountPurchaseInfo
- BillingAccount
- Try it!
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/v1/{customer=accounts/*/customers/*}:queryEligibleBillingAccounts
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
customer |
Required. The resource name of the customer to list eligible billing accounts for. Format: accounts/{account_id}/customers/{customer_id}. |
Query parameters
Parameters | |
---|---|
skus[] |
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 ( |
Fields | |
---|---|
sku |
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 ( |
Fields | |
---|---|
skus[] |
Resource names of the SKUs included in this group. Format: products/{productId}/skus/{skuId}. |
billing |
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 ( |
Fields | |
---|---|
billing |
The billing account resource. |
BillingAccount
Represents a billing account.
JSON representation |
---|
{ "name": string, "displayName": string, "createTime": string, "currencyCode": string, "regionCode": string } |
Fields | |
---|---|
name |
Output only. Resource name of the billing account. Format: accounts/{account_id}/billingAccounts/{billing_account_id}. |
display |
Display name of the billing account. |
create |
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: |
currency |
Output only. The 3-letter currency code defined in ISO 4217. |
region |
Output only. The CLDR region code. |