Method: datafeeds.custombatch

  • Enables batch operations (delete, fetch, get, insert, update) on multiple datafeeds using a single HTTP POST request.

  • Requires providing a DatafeedsCustomBatchRequest object in the request body, specifying individual operations within the batch.

  • Responses are structured as a DatafeedsCustomBatchResponse, containing individual DatafeedsCustomBatchResponseEntry objects for each operation.

  • Authorization is necessary using the https://www.googleapis.com/auth/content scope.

  • Each batch entry requires a unique batchId, merchantId, the desired method, and optionally datafeedId and/or datafeed object depending on the operation.

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

HTTP request

POST https://shoppingcontent.googleapis.com/content/v2.1/datafeeds/batch

Request body

The request body contains an instance of DatafeedsCustomBatchRequest.

Response body

If successful, the response body contains data with the following structure:

JSON representation 
{
  "entries": [
    {
      object (DatafeedsCustomBatchResponseEntry)
    }
  ],
  "kind": string
}
Fields
entries[]

object (DatafeedsCustomBatchResponseEntry)

The result of the execution of the batch requests.
kind

string

Identifies what kind of resource this is. Value: the fixed string "content#datafeedsCustomBatchResponse".

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the OAuth 2.0 Overview.

DatafeedsCustomBatchRequest

JSON representation 
{
  "entries": [
    {
      object (DatafeedsCustomBatchRequestEntry)
    }
  ]
}
Fields
entries[]

object (DatafeedsCustomBatchRequestEntry)

The request entries to be processed in the batch.

DatafeedsCustomBatchRequestEntry

A batch entry encoding a single non-batch datafeeds request.

JSON representation 
{
  "batchId": integer,
  "merchantId": string,
  "method": string,
  "datafeedId": string,
  "datafeed": {
    object (Datafeed)
  }
}
Fields
batchId

integer (uint32 format)

An entry ID, unique within the batch request.
merchantId

string

The ID of the managing account.
method

string

The method of the batch entry.

Acceptable values are:

  • "delete"
  • "fetchNow"
  • "get"
  • "insert"
  • "update"
datafeedId

string

The ID of the data feed to get, delete or fetch.
datafeed

object (Datafeed)

The data feed to insert.

DatafeedsCustomBatchResponseEntry

A batch entry encoding a single non-batch datafeeds response.

JSON representation 
{
  "batchId": integer,
  "datafeed": {
    object (Datafeed)
  },
  "errors": {
    object (Errors)
  }
}
Fields
batchId

integer (uint32 format)

The ID of the request entry this entry responds to.
datafeed

object (Datafeed)

The requested data feed. Defined if and only if the request was successful.
errors

object (Errors)

A list of errors for failed custombatch entries.