Deletes records of specified feed type. Only performs basic validation (like malformed request) after which an appropriate response is returned to the partner immediately. Google performs business logic validation on the request asynchronously. This batch call does not guarantee atomicity.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Resource name, which has the format of - partners/{partner_id}/feeds/{feed_name}.

Request body

The request body contains data with the following structure:

JSON representation
  "records": [
      object (GenericDeleteRecord)

object (GenericDeleteRecord)

Records to be deleted. Maximum of 1000 records are allowed in one api call.

Response body

If successful, the response body is empty.

Authorization Scopes

Requires the following OAuth scope:



Record to be deleted of the feed type mentioned in url request.

JSON representation
  "deleteTime": string,

  // Union field record_type can be only one of the following:
  "dataRecord": string,
  "protoRecord": {
    "@type": string,
    field1: ...,
  // End of list of possible types for union field record_type.

string (Timestamp format)

Required. This timestamp is used to determine the order in which a delete will be applied to the inventory.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

Union field record_type. Encapsulate different types of feed (ndjson, proto-based, etc.) Partner can provide a full record similar to how a record is provided in a feed or BatchPush API. Partners also have the option to include only the essential fields of a record required to uniquely identify it. record_type can be only one of the following:

string (bytes format)

For non-proto based feeds.

A base64-encoded string.



For proto-based feeds.

An object containing fields of an arbitrary type. An additional field "@type" contains a URI identifying the type. Example: { "id": 1234, "@type": "" }.