Method: projects.locations.catalogs.branches.products.export

Exports multiple Products.

HTTP request

POST https://retail.googleapis.com/v2beta/{parent=projects/*/locations/*/catalogs/*/branches/*}/products:export

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Resource name of a Branch, and default_branch for branchId component is supported. For example projects/1234/locations/global/catalogs/default_catalog/branches/default_branch

Request body

The request body contains data with the following structure:

JSON representation 
{
  "outputConfig": {
    object (OutputConfig)
  },
  "filter": string
}
Fields
outputConfig

object (OutputConfig)

Required. The output location of the data.
filter

string

A filtering expression to specify restrictions on returned events. The expression is a sequence of terms. Each term applies a restriction to the returned products. Use this expression to restrict results to a specific time range, tag, or stock state or to filter products by product type. For example, lastModifiedTime > "2012-04-23T18:25:43.511Z" lastModifiedTime<"2012-04-23T18:25:43.511Z" productType=primary

We expect only four types of fields:

  • lastModifiedTime: This can be specified twice, once with a less than operator and once with a greater than operator. The lastModifiedTime restriction should result in one, contiguous, valid, last-modified, time range.

  • productType: Supported values are primary and variant. The Boolean operators OR and NOT are supported if the expression is enclosed in parentheses and must be separated from the productType values by a space.

  • availability: Supported values are IN_STOCK, OUT_OF_STOCK, PREORDER, and BACKORDER. Boolean operators OR and NOT are supported if the expression is enclosed in parentheses and must be separated from the availability values by a space.

  • Tag expressions: Restricts output to products that match all of the specified tags. Boolean operators OR and NOT are supported if the expression is enclosed in parentheses and the operators are separated from the tag values by a space. Also supported is '-"tagA"', which is equivalent to 'NOT "tagA"'. Tag values must be double-quoted, UTF-8 encoded strings and have a size limit of 1,000 characters.

Some examples of valid filters expressions:

  • Example 1: lastModifiedTime > "2012-04-23T18:25:43.511Z" lastModifiedTime < "2012-04-23T18:30:43.511Z"
  • Example 2: lastModifiedTime > "2012-04-23T18:25:43.511Z" productType = "variant"
  • Example 3: tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional") productType = "primary" lastModifiedTime < "2018-04-23T18:30:43.511Z"
  • Example 4: lastModifiedTime > "2012-04-23T18:25:43.511Z"
  • Example 5: availability = (IN_STOCK OR BACKORDER)

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • retail.products.export

For more information, see the IAM documentation.