1<html><body> 2<style> 3 4body, h1, h2, h3, div, span, p, pre, a { 5 margin: 0; 6 padding: 0; 7 border: 0; 8 font-weight: inherit; 9 font-style: inherit; 10 font-size: 100%; 11 font-family: inherit; 12 vertical-align: baseline; 13} 14 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, h2, h3 { 50 border-bottom: solid #CCC 1px; 51} 52 53.toc_element { 54 margin-top: 0.5em; 55} 56 57.firstline { 58 margin-left: 2 em; 59} 60 61.method { 62 margin-top: 1em; 63 border: solid 1px #CCC; 64 padding: 1em; 65 background: #EEE; 66} 67 68.details { 69 font-weight: bold; 70 font-size: 14px; 71} 72 73</style> 74 75<h1><a href="content_v2_1.html">Content API for Shopping</a> . <a href="content_v2_1.accounttax.html">accounttax</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#close">close()</a></code></p> 79<p class="firstline">Close httplib2 connections.</p> 80<p class="toc_element"> 81 <code><a href="#custombatch">custombatch(body=None, x__xgafv=None)</a></code></p> 82<p class="firstline">Retrieves and updates tax settings of multiple accounts in a single request.</p> 83<p class="toc_element"> 84 <code><a href="#get">get(merchantId, accountId, x__xgafv=None)</a></code></p> 85<p class="firstline">Retrieves the tax settings of the account.</p> 86<p class="toc_element"> 87 <code><a href="#list">list(merchantId, maxResults=None, pageToken=None, x__xgafv=None)</a></code></p> 88<p class="firstline">Lists the tax settings of the sub-accounts in your Merchant Center account.</p> 89<p class="toc_element"> 90 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 91<p class="firstline">Retrieves the next page of results.</p> 92<p class="toc_element"> 93 <code><a href="#update">update(merchantId, accountId, body=None, x__xgafv=None)</a></code></p> 94<p class="firstline">Updates the tax settings of the account. Any fields that are not provided are deleted from the resource.</p> 95<h3>Method Details</h3> 96<div class="method"> 97 <code class="details" id="close">close()</code> 98 <pre>Close httplib2 connections.</pre> 99</div> 100 101<div class="method"> 102 <code class="details" id="custombatch">custombatch(body=None, x__xgafv=None)</code> 103 <pre>Retrieves and updates tax settings of multiple accounts in a single request. 104 105Args: 106 body: object, The request body. 107 The object takes the form of: 108 109{ 110 "entries": [ # The request entries to be processed in the batch. 111 { # A batch entry encoding a single non-batch accounttax request. 112 "accountId": "A String", # The ID of the account for which to get/update account tax settings. 113 "accountTax": { # The tax settings of a merchant account. All methods require the admin role. # The account tax settings to update. Only defined if the method is `update`. 114 "accountId": "A String", # Required. The ID of the account to which these account tax settings belong. 115 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accountTax`". 116 "rules": [ # Tax rules. Updating the tax rules will enable US taxes (not reversible). Defining no rules is equivalent to not charging tax at all. 117 { # Tax calculation rule to apply in a state or province (USA only). 118 "country": "A String", # Country code in which tax is applicable. 119 "locationId": "A String", # Required. State (or province) is which the tax is applicable, described by its location ID (also called criteria ID). 120 "ratePercent": "A String", # Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative. 121 "shippingTaxed": True or False, # If true, shipping charges are also taxed. 122 "useGlobalRate": True or False, # Whether the tax rate is taken from a global tax table or specified explicitly. 123 }, 124 ], 125 }, 126 "batchId": 42, # An entry ID, unique within the batch request. 127 "merchantId": "A String", # The ID of the managing account. 128 "method": "A String", # The method of the batch entry. Acceptable values are: - "`get`" - "`update`" 129 }, 130 ], 131} 132 133 x__xgafv: string, V1 error format. 134 Allowed values 135 1 - v1 error format 136 2 - v2 error format 137 138Returns: 139 An object of the form: 140 141 { 142 "entries": [ # The result of the execution of the batch requests. 143 { # A batch entry encoding a single non-batch accounttax response. 144 "accountTax": { # The tax settings of a merchant account. All methods require the admin role. # The retrieved or updated account tax settings. 145 "accountId": "A String", # Required. The ID of the account to which these account tax settings belong. 146 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accountTax`". 147 "rules": [ # Tax rules. Updating the tax rules will enable US taxes (not reversible). Defining no rules is equivalent to not charging tax at all. 148 { # Tax calculation rule to apply in a state or province (USA only). 149 "country": "A String", # Country code in which tax is applicable. 150 "locationId": "A String", # Required. State (or province) is which the tax is applicable, described by its location ID (also called criteria ID). 151 "ratePercent": "A String", # Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative. 152 "shippingTaxed": True or False, # If true, shipping charges are also taxed. 153 "useGlobalRate": True or False, # Whether the tax rate is taken from a global tax table or specified explicitly. 154 }, 155 ], 156 }, 157 "batchId": 42, # The ID of the request entry this entry responds to. 158 "errors": { # A list of errors returned by a failed batch entry. # A list of errors defined if and only if the request failed. 159 "code": 42, # The HTTP status of the first error in `errors`. 160 "errors": [ # A list of errors. 161 { # An error returned by the API. 162 "domain": "A String", # The domain of the error. 163 "message": "A String", # A description of the error. 164 "reason": "A String", # The error code. 165 }, 166 ], 167 "message": "A String", # The message of the first error in `errors`. 168 }, 169 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accounttaxCustomBatchResponseEntry`" 170 }, 171 ], 172 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accounttaxCustomBatchResponse`". 173}</pre> 174</div> 175 176<div class="method"> 177 <code class="details" id="get">get(merchantId, accountId, x__xgafv=None)</code> 178 <pre>Retrieves the tax settings of the account. 179 180Args: 181 merchantId: string, The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and `accountId` must be the ID of a sub-account of this account. (required) 182 accountId: string, The ID of the account for which to get/update account tax settings. (required) 183 x__xgafv: string, V1 error format. 184 Allowed values 185 1 - v1 error format 186 2 - v2 error format 187 188Returns: 189 An object of the form: 190 191 { # The tax settings of a merchant account. All methods require the admin role. 192 "accountId": "A String", # Required. The ID of the account to which these account tax settings belong. 193 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accountTax`". 194 "rules": [ # Tax rules. Updating the tax rules will enable US taxes (not reversible). Defining no rules is equivalent to not charging tax at all. 195 { # Tax calculation rule to apply in a state or province (USA only). 196 "country": "A String", # Country code in which tax is applicable. 197 "locationId": "A String", # Required. State (or province) is which the tax is applicable, described by its location ID (also called criteria ID). 198 "ratePercent": "A String", # Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative. 199 "shippingTaxed": True or False, # If true, shipping charges are also taxed. 200 "useGlobalRate": True or False, # Whether the tax rate is taken from a global tax table or specified explicitly. 201 }, 202 ], 203}</pre> 204</div> 205 206<div class="method"> 207 <code class="details" id="list">list(merchantId, maxResults=None, pageToken=None, x__xgafv=None)</code> 208 <pre>Lists the tax settings of the sub-accounts in your Merchant Center account. 209 210Args: 211 merchantId: string, The ID of the managing account. This must be a multi-client account. (required) 212 maxResults: integer, The maximum number of tax settings to return in the response, used for paging. 213 pageToken: string, The token returned by the previous request. 214 x__xgafv: string, V1 error format. 215 Allowed values 216 1 - v1 error format 217 2 - v2 error format 218 219Returns: 220 An object of the form: 221 222 { 223 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accounttaxListResponse`". 224 "nextPageToken": "A String", # The token for the retrieval of the next page of account tax settings. 225 "resources": [ 226 { # The tax settings of a merchant account. All methods require the admin role. 227 "accountId": "A String", # Required. The ID of the account to which these account tax settings belong. 228 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accountTax`". 229 "rules": [ # Tax rules. Updating the tax rules will enable US taxes (not reversible). Defining no rules is equivalent to not charging tax at all. 230 { # Tax calculation rule to apply in a state or province (USA only). 231 "country": "A String", # Country code in which tax is applicable. 232 "locationId": "A String", # Required. State (or province) is which the tax is applicable, described by its location ID (also called criteria ID). 233 "ratePercent": "A String", # Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative. 234 "shippingTaxed": True or False, # If true, shipping charges are also taxed. 235 "useGlobalRate": True or False, # Whether the tax rate is taken from a global tax table or specified explicitly. 236 }, 237 ], 238 }, 239 ], 240}</pre> 241</div> 242 243<div class="method"> 244 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 245 <pre>Retrieves the next page of results. 246 247Args: 248 previous_request: The request for the previous page. (required) 249 previous_response: The response from the request for the previous page. (required) 250 251Returns: 252 A request object that you can call 'execute()' on to request the next 253 page. Returns None if there are no more items in the collection. 254 </pre> 255</div> 256 257<div class="method"> 258 <code class="details" id="update">update(merchantId, accountId, body=None, x__xgafv=None)</code> 259 <pre>Updates the tax settings of the account. Any fields that are not provided are deleted from the resource. 260 261Args: 262 merchantId: string, The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and `accountId` must be the ID of a sub-account of this account. (required) 263 accountId: string, The ID of the account for which to get/update account tax settings. (required) 264 body: object, The request body. 265 The object takes the form of: 266 267{ # The tax settings of a merchant account. All methods require the admin role. 268 "accountId": "A String", # Required. The ID of the account to which these account tax settings belong. 269 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accountTax`". 270 "rules": [ # Tax rules. Updating the tax rules will enable US taxes (not reversible). Defining no rules is equivalent to not charging tax at all. 271 { # Tax calculation rule to apply in a state or province (USA only). 272 "country": "A String", # Country code in which tax is applicable. 273 "locationId": "A String", # Required. State (or province) is which the tax is applicable, described by its location ID (also called criteria ID). 274 "ratePercent": "A String", # Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative. 275 "shippingTaxed": True or False, # If true, shipping charges are also taxed. 276 "useGlobalRate": True or False, # Whether the tax rate is taken from a global tax table or specified explicitly. 277 }, 278 ], 279} 280 281 x__xgafv: string, V1 error format. 282 Allowed values 283 1 - v1 error format 284 2 - v2 error format 285 286Returns: 287 An object of the form: 288 289 { # The tax settings of a merchant account. All methods require the admin role. 290 "accountId": "A String", # Required. The ID of the account to which these account tax settings belong. 291 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accountTax`". 292 "rules": [ # Tax rules. Updating the tax rules will enable US taxes (not reversible). Defining no rules is equivalent to not charging tax at all. 293 { # Tax calculation rule to apply in a state or province (USA only). 294 "country": "A String", # Country code in which tax is applicable. 295 "locationId": "A String", # Required. State (or province) is which the tax is applicable, described by its location ID (also called criteria ID). 296 "ratePercent": "A String", # Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative. 297 "shippingTaxed": True or False, # If true, shipping charges are also taxed. 298 "useGlobalRate": True or False, # Whether the tax rate is taken from a global tax table or specified explicitly. 299 }, 300 ], 301}</pre> 302</div> 303 304</body></html>