v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1346141211.8 KB
accounts

Lists the following: * Offers that you can purchase for a customer. * Offers that you can change for an entitlement. Possible error codes: * PERMISSION_DENIED: * The customer doesn't belong to the reseller * The reseller is not authorized to transact on this Product. See https://support.google.com/channelservices/answer/9759265 * INVALID_ARGUMENT: Required request parameters are missing or invalid.

get/v1/{+customer}:listPurchasableOffers

Path parameters

customerstring required

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

Query parameters

changeOfferPurchase.billingAccountstring

Optional. Resource name of the new target Billing Account. Provide this Billing Account when setting up billing for a trial subscription. Format: accounts/{account_id}/billingAccounts/{billing_account_id}. This field is only relevant for multi-currency accounts. It should be left empty for single currency accounts.

changeOfferPurchase.entitlementstring

Required. Resource name of the entitlement. Format: accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id}

changeOfferPurchase.newSkustring

Optional. Resource name of the new target SKU. Provide this SKU when upgrading or downgrading an entitlement. Format: products/{product_id}/skus/{sku_id}

createEntitlementPurchase.billingAccountstring

Optional. Billing account that the result should be restricted to. Format: accounts/{account_id}/billingAccounts/{billing_account_id}.

createEntitlementPurchase.skustring

Required. SKU that the result should be restricted to. Format: products/{product_id}/skus/{sku_id}.

languageCodestring

Optional. The BCP-47 language code. For example, "en-US". The response will localize in the corresponding language code, if specified. The default value is "en-US".

pageSizeinteger

Optional. Requested page size. Server might return fewer results than requested. If unspecified, returns at most 100 Offers. The maximum value is 1000; the server will coerce values above 1000.

pageTokenstring

Optional. A token for a page of results other than the first page.

Response

Successful response