Method: accounts.productReviews.list

  • Lists product reviews for a specified Merchant Center account using the productReviews.list method.

  • Accepts optional pagination parameters (pageSize, pageToken) to control the results.

  • Returns a list of ProductReview objects and a nextPageToken for accessing further pages, if available.

  • Requires authorization with the https://www.googleapis.com/auth/content scope.

  • Uses a simple GET request with path and query parameters.

Lists product reviews.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The account to list product reviews for. Format: accounts/{account}

Query parameters

Parameters
pageSize

integer

Optional. The maximum number of products to return. The service may return fewer than this value.
pageToken

string

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

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

Request body

The request body must be empty.

Response body

response message for the productReviews.list method.

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

JSON representation 
{
  "productReviews": [
    {
      object (ProductReview)
    }
  ],
  "nextPageToken": string
}
Fields
productReviews[]

object (ProductReview)

The product review.
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.