Datafeeds: custombatch

Deletes, fetches, gets, inserts and updates multiple datafeeds in a single request. Try it now.


HTTP request



Parameter name Value Description
Optional query parameters
dryRun boolean Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).


This request requires authorization with the following scope:


For more information, see the authentication and authorization page.

Request body

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

  "entries": [
      "batchId": unsigned integer,
      "merchantId": unsigned long,
      "method": string,
      "datafeedId": unsigned long,
      "datafeed": datafeeds 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:
  • "delete"
  • "fetchNow"
  • "get"
  • "insert"
  • "update"
entries[].datafeedId unsigned long The ID of the data feed to get, delete or fetch.
entries[].datafeed nested object The data feed to insert.


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

  "kind": "content#datafeedsCustomBatchResponse",
  "entries": [
      "batchId": unsigned integer,
      "datafeed": datafeeds 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#datafeedsCustomBatchResponse".
entries[] list The result of the execution of the batch requests.
entries[].batchId unsigned integer The ID of the request entry this entry responds to.
entries[].datafeed nested object The requested data feed. Defined if and only if the request was successful.
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.

Try it!

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