reports

POST /{merchantId}/reports/search

Retrieves merchant performance metrics matching the search query and optionally segmented by selected dimensions.

Request

  • Base URL
    https://shoppingcontent.googleapis.com/content/v2.1
  • Auth
    OAuth 2 and OAuth 2
    Implicithttps://accounts.google.com/o/oauth2/auth
    Scopeshttps://www.googleapis.com/auth/content
    Authorization codehttps://accounts.google.com/o/oauth2/auth
    Token URLhttps://accounts.google.com/o/oauth2/token
    Scopeshttps://www.googleapis.com/auth/content
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

merchantIdstring required

Required. Id of the merchant making the call. Must be a standalone account or an MCA subaccount.

Request body

pageSizeinteger

Number of ReportRows to retrieve in a single page. Defaults to 1000. Values above 5000 are coerced to 5000.

pageTokenstring

Token of the page to retrieve. If not specified, the first page of results is returned. In order to request the next page of results, the value obtained from next_page_token in the previous response should be used.

querystring

Required. Query that defines performance metrics to retrieve and dimensions according to which the metrics are to be segmented. For details on how to construct your query, see the Query Language guide.

Response

Successful response

nextPageTokenstring

Token which can be sent as page_token to retrieve the next page. If omitted, there are no subsequent pages.

Changes

No recorded changes to this operation across all 1 revision of this API.