rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
Get the latest
on new Merchant API features, bug fixes, and updates.
add_alert
Note: Content API for Shopping will be sunset on August 18, 2026.
REST Resource: accounttax
Stay organized with collections
Save and categorize content based on your preferences.
Resource: AccountTax
The tax settings of a merchant account. All methods require the admin role.
| JSON representation |
{
"accountId": string,
"rules": [
{
object (AccountTaxTaxRule)
}
],
"kind": string
} |
| Fields |
accountId |
string
Required. The ID of the account to which these account tax settings belong.
|
rules[] |
object (AccountTaxTaxRule)
Tax rules. Updating the tax rules will enable "US" taxes (not reversible). Defining no rules is equivalent to not charging tax at all.
|
kind |
string
Identifies what kind of resource this is. Value: the fixed string "content#accountTax".
|
AccountTaxTaxRule
Tax calculation rule to apply in a state or province (US only).
| JSON representation |
{
"country": string,
"locationId": string,
"useGlobalRate": boolean,
"ratePercent": string,
"shippingTaxed": boolean
} |
| Fields |
country |
string
Country code in which tax is applicable.
|
locationId |
string
Required. State (or province) is which the tax is applicable, described by its location ID (also called criteria ID).
|
useGlobalRate |
boolean
Whether the tax rate is taken from a global tax table or specified explicitly.
|
ratePercent |
string
Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative.
|
shippingTaxed |
boolean
If true, shipping charges are also taxed.
|
Methods |
|
|
Retrieves and updates tax settings of multiple accounts in a single request. |
|
|
Retrieves the tax settings of the account. |
|
|
Lists the tax settings of the sub-accounts in your Merchant Center account. |
|
|
Updates the tax settings of the account. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-25 UTC.
[null,null,["Last updated 2025-02-25 UTC."],[[["\u003cp\u003eAccountTax resource allows management of tax settings for a merchant account, requiring admin access for all methods.\u003c/p\u003e\n"],["\u003cp\u003eTax rules can be defined for specific states/provinces within the US, impacting tax calculations for products.\u003c/p\u003e\n"],["\u003cp\u003eGlobal tax tables or custom rates can be utilized, with options to include shipping in tax calculations.\u003c/p\u003e\n"],["\u003cp\u003eMultiple methods, such as \u003ccode\u003eget\u003c/code\u003e, \u003ccode\u003elist\u003c/code\u003e, \u003ccode\u003eupdate\u003c/code\u003e, and \u003ccode\u003ecustombatch\u003c/code\u003e, are available for managing AccountTax settings.\u003c/p\u003e\n"],["\u003cp\u003eJSON representation provides structured data format for AccountTax and AccountTaxTaxRule resources, including fields like accountId, rules, country, locationId, and more.\u003c/p\u003e\n"]]],["AccountTax represents a merchant account's tax settings, modifiable only by admins. It contains `accountId`, `rules` (tax rules), and `kind`. `AccountTaxTaxRule` defines tax calculation rules per state or province in the US, specifying `country`, `locationId`, `useGlobalRate`, `ratePercent`, and `shippingTaxed`. Available methods include `custombatch` for bulk updates, `get` for retrieving settings, `list` for sub-account settings, and `update` for modifying account tax settings. Tax rules are only available in the US and, once enabled, cannot be disabled.\n"],null,["# REST Resource: accounttax\n\n- [Resource: AccountTax](#AccountTax)\n - [JSON representation](#AccountTax.SCHEMA_REPRESENTATION)\n- [AccountTaxTaxRule](#AccountTaxTaxRule)\n - [JSON representation](#AccountTaxTaxRule.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AccountTax\n--------------------\n\nThe tax settings of a merchant account. All methods require the admin role.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"accountId\": string, \"rules\": [ { object (/shopping-content/reference/rest/v2.1/accounttax#AccountTaxTaxRule) } ], \"kind\": string } ``` |\n\n| Fields ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `accountId` | `string` Required. The ID of the account to which these account tax settings belong. |\n| `rules[]` | `object (`[AccountTaxTaxRule](/shopping-content/reference/rest/v2.1/accounttax#AccountTaxTaxRule)`)` Tax rules. Updating the tax rules will enable \"US\" taxes (not reversible). Defining no rules is equivalent to not charging tax at all. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#accountTax`\". |\n\nAccountTaxTaxRule\n-----------------\n\nTax calculation rule to apply in a state or province (US only).\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"country\": string, \"locationId\": string, \"useGlobalRate\": boolean, \"ratePercent\": string, \"shippingTaxed\": boolean } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `country` | `string` Country code in which tax is applicable. |\n| `locationId` | `string` Required. State (or province) is which the tax is applicable, described by its [location ID](https://developers.google.com/adwords/api/docs/appendix/geotargeting) (also called criteria ID). |\n| `useGlobalRate` | `boolean` Whether the tax rate is taken from a global tax table or specified explicitly. |\n| `ratePercent` | `string` Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative. |\n| `shippingTaxed` | `boolean` If true, shipping charges are also taxed. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------|------------------------------------------------------------------------------|\n| ### [custombatch](/shopping-content/reference/rest/v2.1/accounttax/custombatch) | Retrieves and updates tax settings of multiple accounts in a single request. |\n| ### [get](/shopping-content/reference/rest/v2.1/accounttax/get) | Retrieves the tax settings of the account. |\n| ### [list](/shopping-content/reference/rest/v2.1/accounttax/list) | Lists the tax settings of the sub-accounts in your Merchant Center account. |\n| ### [update](/shopping-content/reference/rest/v2.1/accounttax/update) | Updates the tax settings of the account. |"]]