You can use the `Reports` service to retrieve [performance
metrics](https://support.google.com/merchants/answer/10265167) for your account.

See the [`metrics` documentation](https://developers.google.com/shopping-content/reference/rest/v2.1/reports/search#Metrics) for the
complete list of available metrics.

## Requirements

You need the [Reporting manager
role](https://support.google.com/merchants/answer/11935402) to retrieve this report.

To give an account the Reporting manager role, use
[`accounts.update`](https://developers.google.com/shopping-content/reference/rest/v2.1/accounts/update) to
set the `reportingManager` field to `true`. The Reporting manager role is
equivalent to the Performance and insights role in Merchant Center.

`accounts.update` replaces the entire `Account` resource. Use [`accounts.get`](https://developers.google.com/shopping-content/reference/rest/v2.1/accounts/get) to
get the full `Account` resource, then provide all fields in your
`accounts.update` request so you don't lose information.

## Sample query

The following query retrieves the `impressions`, `clicks`, and `ctr` for all
products in your account during a specific 30-day period. To make the request,
pass the following Merchant Center Query Language statement to the
[`reports.search`](https://developers.google.com/shopping-content/reference/rest/v2.1/reports/search) method:

    SELECT
      metrics.impressions,
      metrics.clicks,
      metrics.ctr
    FROM MerchantPerformanceView
    WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'

[Run](https://developers.google.com/shopping-content/reference/rest/v2.1/reports/search?apix=true&apix_params=%7B%22merchantId%22:0,%22resource%22:%7B%22query%22:%22SELECT++metrics.impressions,++metrics.clicks,++metrics.ctr+FROM+MerchantPerformanceView+WHERE+segments.date+BETWEEN+'2020-12-01'+AND+'2020-12-30'%22%7D%7D)

Click **Run** to try the sample in the **API Explorer** . After you click
**Run** , update the merchant ID placeholder to your own merchant ID in the
request URL. You can modify the query. The full query must remain on one line to
work with the **API explorer**.

You can also [segment](https://developers.google.com/shopping-content/guides/reports/segmentation) the
metrics in the query for more granular performance reports.

See the [Products guide](https://developers.google.com/shopping-content/guides/reports/products) to learn how
to retrieve and filter products with the `Reports` service.