Method: accounts.products.list

  • Lists processed products within your Merchant Center account, potentially requiring pagination for comprehensive retrieval.

  • Allows you to control the number of products returned per request using pageSize, with a maximum limit of 250.

  • Utilizes pageToken for navigating through multiple pages of results when the product list exceeds the specified pageSize.

  • Requires authorization with the https://www.googleapis.com/auth/content scope for accessing and retrieving product data.

  • Provides product data in JSON format, including an array of products and a nextPageToken for pagination.

Lists the processed products in your Merchant Center account. The response might contain fewer items than specified by pageSize. Rely on pageToken to determine if there are more items to be requested.

After inserting, updating, or deleting a product input, it may take several minutes before the updated processed product can be retrieved.

HTTP request

GET https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/products

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The account to list processed products for. Format: accounts/{account}

Query parameters

Parameters
pageSize

integer

The maximum number of products to return. The service may return fewer than this value. The maximum value is 1000; values above 1000 will be coerced to 1000. If unspecified, the default page size of 25 products will be returned.
pageToken

string

A page token, received from a previous products.list call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to products.list must match the call that provided the page token.

Request body

The request body must be empty.

Response body

Response message for the products.list method.

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

JSON representation 
{
  "products": [
    {
      object (Product)
    }
  ],
  "nextPageToken": string
}
Fields
products[]

object (Product)

The processed products from the specified account. These are your processed products after applying rules and supplemental data sources.
nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.