Accounttax: custombatch

Requires authorization

Retrieves and updates tax settings of multiple accounts in a single request. Try it now.

Request

HTTP request

POST https://www.googleapis.com/content/v2/accounttax/batch

Parameters

Parameter name Value Description
Optional query parameters
dryRun boolean Flag to run the request in dry-run mode.

Authorization

This request requires authorization with the following scope (read more about authentication and authorization).

Scope
https://www.googleapis.com/auth/content

Request body

In the request body, supply data with the following structure:

JSON

{
  "entries": [
    {
      "batchId": unsigned integer,
      "merchantId": unsigned long,
      "method": string,
      "accountId": unsigned long,
      "accountTax": accounttax Resource
    }
  ]
}
Property name Value Description Notes
entries[] list The request entries to be processed in the batch.
entries[].batchId unsigned integer An entry ID, unique within the batch request.
entries[].merchantId unsigned long The ID of the managing account.
entries[].method string

Acceptable values are:
  • "get"
  • "update"
entries[].accountId unsigned long The ID of the account for which to get/update account tax settings.
entries[].accountTax nested object The account tax settings to update. Only defined if the method is update.

XML

<batch>
  (foreach)
    <entry batch_id="unsigned integer" method="string">
      <merchant_id>
        unsigned long
      </merchant_id>
      <account_id>
        unsigned long
      </account_id>
      accounttax Resource
    </entry>
  (/foreach)
</batch>
Property name Value Description Notes
batch object
batch/entry object A batch entry encoding a single non-batch accounttax request.
batch/entry/batch_id unsigned integer An entry ID, unique within the batch request.
batch/entry/method string The method of the batch entry.

Acceptable values are:
  • "get"
  • "update"
batch/entry/merchant_id unsigned long The ID of the managing account.
batch/entry/account_id unsigned long The ID of the account for which to get/update account tax settings.
batch/entry/account_tax nested object The account tax settings to update. Only defined if the method is update. The tax settings of a merchant account.

Response

If successful, this method returns a response body with the following structure:

JSON

{
  "kind": "content#accounttaxCustomBatchResponse",
  "entries": [
    {
      "kind": "content#accounttaxCustomBatchResponseEntry",
      "batchId": unsigned integer,
      "accountTax": accounttax Resource,
      "errors": {
        "errors": [
          {
            "domain": string,
            "reason": string,
            "message": string
          }
        ],
        "code": unsigned integer,
        "message": string
      }
    }
  ]
}
Property name Value Description Notes
kind string Identifies what kind of resource this is. Value: the fixed string "content#accounttaxCustomBatchResponse".
entries[] list The result of the execution of the batch requests.
entries[].kind string Identifies what kind of resource this is. Value: the fixed string "content#accounttaxCustomBatchResponseEntry".
entries[].batchId unsigned integer The ID of the request entry this entry responds to.
entries[].accountTax nested object The retrieved or updated account tax settings.
entries[].errors nested object A list of errors defined if and only if the request failed.
entries[].errors.errors[] list A list of errors.
entries[].errors.errors[].domain string The domain of the error.
entries[].errors.errors[].reason string The error code.
entries[].errors.errors[].message string A description of the error.
entries[].errors.code unsigned integer The HTTP status of the first error in errors.
entries[].errors.message string The message of the first error in errors.

XML

<batch>
  (foreach)
    <entry batch_id="unsigned integer">
      accounttax Resource
      <errors xmlns="http://schemas.google.com/g/2005">
        (foreach)
          <error>
            <domain>
              GData
              string
            </domain>
            <code>
              string
            </code>
            <internalReason>
              string
            </internalReason>
          </error>
        (/foreach)
      </errors>
    </entry>
  (/foreach)
</batch>
Property name Value Description Notes
batch object
batch/entry object A batch entry encoding a single non-batch accounttax response.
batch/entry/batch_id unsigned integer The ID of the request entry this entry responds to.
batch/entry/account_tax nested object The retrieved or updated account tax settings. The tax settings of a merchant account.
batch/entry/errors nested object A list of errors defined if and only if the request failed. A list of errors returned by a failed batch entry.
batch/entry/errors/error object A list of errors. An error returned by the API.
batch/entry/errors/error/domain string A list of errors. An error returned by the API.
batch/entry/errors/error/code string The error code.
batch/entry/errors/error/internalReason string A description of the error.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.

Send feedback about...

Content API for Shopping