- [Resource: ReportRow](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ReportRow)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ReportRow.SCHEMA_REPRESENTATION)
- [ProductPerformanceView](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ProductPerformanceView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ProductPerformanceView.SCHEMA_REPRESENTATION)
- [MarketingMethodEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#MarketingMethodEnum)
- [StoreTypeEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#StoreTypeEnum)
- [NetworkEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#NetworkEnum)
- [NonProductPerformanceView](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#NonProductPerformanceView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#NonProductPerformanceView.SCHEMA_REPRESENTATION)
- [ProductView](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ProductView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ProductView.SCHEMA_REPRESENTATION)
- [AggregatedReportingContextStatus](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#AggregatedReportingContextStatus)
- [StatusPerReportingContext](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#StatusPerReportingContext)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#StatusPerReportingContext.SCHEMA_REPRESENTATION)
- [ItemIssue](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssue)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssue.SCHEMA_REPRESENTATION)
- [ItemIssueType](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssueType)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssueType.SCHEMA_REPRESENTATION)
- [ItemIssueSeverity](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssueSeverity)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssueSeverity.SCHEMA_REPRESENTATION)
- [IssueSeverityPerReportingContext](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#IssueSeverityPerReportingContext)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#IssueSeverityPerReportingContext.SCHEMA_REPRESENTATION)
- [AggregatedIssueSeverity](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#AggregatedIssueSeverity)
- [ItemIssueResolution](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssueResolution)
- [ClickPotential](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ClickPotential)
- [PriceCompetitivenessProductView](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#PriceCompetitivenessProductView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#PriceCompetitivenessProductView.SCHEMA_REPRESENTATION)
- [PriceInsightsProductView](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#PriceInsightsProductView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#PriceInsightsProductView.SCHEMA_REPRESENTATION)
- [Effectiveness](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#Effectiveness)
- [BestSellersProductClusterView](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#BestSellersProductClusterView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#BestSellersProductClusterView.SCHEMA_REPRESENTATION)
- [ReportGranularityEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ReportGranularityEnum)
- [InventoryStatus](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#InventoryStatus)
- [RelativeDemandEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandEnum)
- [RelativeDemandChangeTypeEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandChangeTypeEnum)
- [BestSellersBrandView](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#BestSellersBrandView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#BestSellersBrandView.SCHEMA_REPRESENTATION)
- [CompetitiveVisibilityCompetitorView](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityCompetitorView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityCompetitorView.SCHEMA_REPRESENTATION)
- [TrafficSourceEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#TrafficSourceEnum)
- [CompetitiveVisibilityTopMerchantView](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityTopMerchantView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityTopMerchantView.SCHEMA_REPRESENTATION)
- [CompetitiveVisibilityBenchmarkView](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityBenchmarkView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityBenchmarkView.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#METHODS_SUMMARY)

## Resource: ReportRow

Result row returned from the search query.

Only the message corresponding to the queried table is populated in the response. Within the populated message, only the fields requested explicitly in the query are populated.

| JSON representation |
|---|
| ``` { "productPerformanceView": { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ProductPerformanceView`) }, "nonProductPerformanceView": { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#NonProductPerformanceView`) }, "productView": { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ProductView`) }, "priceCompetitivenessProductView": { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#PriceCompetitivenessProductView`) }, "priceInsightsProductView": { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#PriceInsightsProductView`) }, "bestSellersProductClusterView": { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#BestSellersProductClusterView`) }, "bestSellersBrandView": { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#BestSellersBrandView`) }, "competitiveVisibilityCompetitorView": { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityCompetitorView`) }, "competitiveVisibilityTopMerchantView": { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityTopMerchantView`) }, "competitiveVisibilityBenchmarkView": { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityBenchmarkView`) } } ``` |

| Fields ||
|---|---|
| `productPerformanceView` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ProductPerformanceView`)`` Fields available for query in `productPerformanceView` table. |
| `nonProductPerformanceView` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#NonProductPerformanceView`)`` Fields available for query in `nonProductPerformanceView` table. |
| `productView` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ProductView`)`` Fields available for query in `productView` table. |
| `priceCompetitivenessProductView` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#PriceCompetitivenessProductView`)`` Fields available for query in `priceCompetitivenessProductView` table. |
| `priceInsightsProductView` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#PriceInsightsProductView`)`` Fields available for query in `priceInsightsProductView` table. |
| `bestSellersProductClusterView` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#BestSellersProductClusterView`)`` Fields available for query in `bestSellersProductClusterView` table. |
| `bestSellersBrandView` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#BestSellersBrandView`)`` Fields available for query in `bestSellersBrandView` table. |
| `competitiveVisibilityCompetitorView` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityCompetitorView`)`` Fields available for query in `competitiveVisibilityCompetitorView` table. |
| `competitiveVisibilityTopMerchantView` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityTopMerchantView`)`` Fields available for query in `competitiveVisibilityTopMerchantView` table. |
| `competitiveVisibilityBenchmarkView` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityBenchmarkView`)`` Fields available for query in `competitiveVisibilityBenchmarkView` table. |

## ProductPerformanceView

Fields available for query in `productPerformanceView` table.

Product performance data for your account, including performance metrics (for example, `clicks`) and dimensions according to which performance metrics are segmented (for example, `offerId`). Values of product dimensions, such as `offerId`, reflect the state of a product at the time of the impression.

Segment fields cannot be selected in queries without also selecting at least one metric field.

Values are only set for fields requested explicitly in the request's search query.

| JSON representation |
|---|
| ``` { "date": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`) }, "week": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`) }, "conversionValue": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Price`) }, "marketingMethod": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#MarketingMethodEnum`), "customerCountryCode": string, "storeType": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#StoreTypeEnum`), "network": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#NetworkEnum`), "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "customLabel0": string, "customLabel1": string, "customLabel2": string, "customLabel3": string, "customLabel4": string, "clicks": string, "impressions": string, "clickThroughRate": number, "conversions": number, "conversionRate": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Condition on `date` is required in the `WHERE` clause. |
| `week` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`)`` First day of the week (Monday) of the metrics date in the Merchant Center account timezone. Segment. |
| `conversionValue` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Price`)`` Value of conversions attributed to the product, reported on the conversion date. Metric. Available only for the `FREE` traffic source. |
| `marketingMethod` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#MarketingMethodEnum`)`` Marketing method to which metrics apply. Segment. |
| `customerCountryCode` | `string` Code of the country where the customer is located at the time of the event. Represented in the ISO 3166 format. Segment. If the customer country cannot be determined, a special 'ZZ' code is returned. |
| `storeType` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#StoreTypeEnum`)`` Store type to which metrics apply. Can be `ONLINE_STORE` or `LOCAL_STORES`. Segment. For `LOCAL_STORES` store type, further segmentation by a specific store is not available. |
| `network` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#NetworkEnum`)`` Network to which metrics apply. Segment. |
| `offerId` | `string` Merchant-provided id of the product. Segment. |
| `title` | `string` Title of the product. Segment. |
| `brand` | `string` Brand of the product. Segment. |
| `categoryL1` | `string` [Product category (1st level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment. |
| `categoryL2` | `string` [Product category (2nd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment. |
| `categoryL3` | `string` [Product category (3rd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment. |
| `categoryL4` | `string` [Product category (4th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment. |
| `categoryL5` | `string` [Product category (5th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment. |
| `productTypeL1` | `string` [Product type (1st level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment. |
| `productTypeL2` | `string` [Product type (2nd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment. |
| `productTypeL3` | `string` [Product type (3rd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment. |
| `productTypeL4` | `string` [Product type (4th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment. |
| `productTypeL5` | `string` [Product type (5th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy. Segment. |
| `customLabel0` | `string` Custom label 0 for custom grouping of products. Segment. |
| `customLabel1` | `string` Custom label 1 for custom grouping of products. Segment. |
| `customLabel2` | `string` Custom label 2 for custom grouping of products. Segment. |
| `customLabel3` | `string` Custom label 3 for custom grouping of products. Segment. |
| `customLabel4` | `string` Custom label 4 for custom grouping of products. Segment. |
| `clicks` | `string (https://developers.google.com/discovery/v1/type-format format)` Number of clicks. Metric. |
| `impressions` | `string (https://developers.google.com/discovery/v1/type-format format)` Number of times merchant's products are shown. Metric. |
| `clickThroughRate` | `number` Click-through rate - the number of clicks merchant's products receive (clicks) divided by the number of times the products are shown (impressions). Metric. |
| `conversions` | `number` Number of conversions attributed to the product, reported on the conversion date. Depending on the attribution model, a conversion might be distributed across multiple clicks, where each click gets its own credit assigned. This metric is a sum of all such credits. Metric. Available only for the `FREE` traffic source. |
| `conversionRate` | `number` Number of conversions divided by the number of clicks, reported on the impression date. Metric. Available only for the `FREE` traffic source. |

## MarketingMethodEnum

Marketing method values.

| Enums ||
|---|---|
| `MARKETING_METHOD_ENUM_UNSPECIFIED` | Not specified. |
| `ORGANIC` | Organic marketing. |
| `ADS` | Ads-based marketing. |
| `AFFILIATE` | [YouTube Shopping Affiliate marketing](https://support.google.com/merchants/answer/14815513). |

## StoreTypeEnum

Store types.

| Enums ||
|---|---|
| `STORE_TYPE_ENUM_UNSPECIFIED` | Not specified. |
| `ONLINE_STORE` | Online store. |
| `LOCAL_STORES` | Local (physical) stores. |

## NetworkEnum

Network values.

This enum is not frozen; values may be added in the future.

| Enums ||
|---|---|
| `NETWORK_ENUM_UNSPECIFIED` | Not specified. |
| `UNKNOWN` | The value is unknown in this version. |
| `SEARCH` | Google search. |
| `SEARCH_PARTNERS` | reports.search partners. |
| `CONTENT` | Display Network. |
| `MIXED` | Cross-network. |
| `YOUTUBE` | YouTube |
| `GOOGLE_TV` | Google TV |
| `GOOGLE_OWNED_CHANNELS` | This network is used for Google Owned channels such as Discover feed, Gmail, YouTube. Demand Gen stats are attributed to more granular network types such as GMAIL, DISCOVER, MAPS, YOUTUBE; this value is only used for historical data. |
| `GMAIL` | Gmail |
| `DISCOVER` | Discover Feed |
| `MAPS` | Maps |

## NonProductPerformanceView

Fields available for query in `nonProductPerformanceView` table.

Performance data on images and online store links leading to your non-product pages. This includes performance metrics (for example, `clicks`) and dimensions according to which performance metrics are segmented (for example, `date`).

Segment fields cannot be selected in queries without also selecting at least one metric field.

Values are only set for fields requested explicitly in the request's search query.

| JSON representation |
|---|
| ``` { "date": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`) }, "week": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`) }, "clicks": string, "impressions": string, "clickThroughRate": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Condition on `date` is required in the `WHERE` clause. |
| `week` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`)`` First day of the week (Monday) of the metrics date in the Merchant Center account timezone. Segment. |
| `clicks` | `string (https://developers.google.com/discovery/v1/type-format format)` Number of clicks on images and online store links leading to your non-product pages. Metric. |
| `impressions` | `string (https://developers.google.com/discovery/v1/type-format format)` Number of times images and online store links leading to your non-product pages were shown. Metric. |
| `clickThroughRate` | `number` Click-through rate - the number of clicks (`clicks`) divided by the number of impressions (`impressions`) of images and online store links leading to your non-product pages. Metric. |

## ProductView

Fields available for query in `productView` table.

Products in the current inventory. Products in this table are the same as a [Product resource in Products sub-API](https://developers.google.com/merchant/api/reference/rest/products_v1/accounts.products) but not all product attributes from Products sub-API are available for query in this table. In contrast to Products sub-API, this table allows to filter the returned list of products by product attributes. To retrieve a single product by `id` or list all products, Products sub-API should be used.

Values are only set for fields requested explicitly in the request's search query.

| JSON representation |
|---|
| ``` { "price": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Price`) }, "gtin": [ string ], "creationTime": string, "expirationDate": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`) }, "statusPerReportingContext": [ { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#StatusPerReportingContext`) } ], "itemIssues": [ { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssue`) } ], "clickPotential": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ClickPotential`), "id": string, "channel": enum (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/ChannelEnum`), "languageCode": string, "feedLabel": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "condition": string, "availability": string, "shippingLabel": string, "itemGroupId": string, "thumbnailLink": string, "aggregatedReportingContextStatus": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#AggregatedReportingContextStatus`), "reportingContext": enum (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/ReportingContextEnum`), "clickPotentialRank": string } ``` |

| Fields ||
|---|---|
| `price` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Price`)`` Product price. Absent if the information about the price of the product is not available. |
| `gtin[]` | `string` List of Global Trade Item Numbers (GTINs) of the product. |
| `creationTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` The time the merchant created the product in timestamp seconds. |
| `expirationDate` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`)`` Expiration date for the product, specified on insertion. |
| `statusPerReportingContext[]` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#StatusPerReportingContext`)`` Detailed product status per reporting context. Reporting contexts included in this list can be restricted using a filter on the `reportingContext` field. Equivalent to `https://developers.google.com/merchant/api/reference/rest/products_v1/accounts.products#ProductStatus` in Products API. **This field cannot be used for sorting or filtering the results.** |
| `itemIssues[]` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssue`)`` List of item issues for the product. **This field cannot be used for sorting the results.** **Only selected attributes of this field (for example, `itemIssues.severity.aggregated_severity`) can be used for filtering the results.** |
| `clickPotential` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ClickPotential`)`` Estimated performance potential compared to highest performing products of the merchant. |
| `id` | `string` REST ID of the product, in the form of `channel~languageCode~feedLabel~offerId`. Merchant API methods that operate on products take this as their `name` parameter. Required in the `SELECT` clause. |
| `channel` | ``enum (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/ChannelEnum`)`` Channel of the product. Can be `ONLINE` or `LOCAL`. |
| `languageCode` | `string` Language code of the product in BCP 47 format. |
| `feedLabel` | `string` Feed label of the product. |
| `offerId` | `string` Merchant-provided id of the product. |
| `title` | `string` Title of the product. |
| `brand` | `string` Brand of the product. |
| `categoryL1` | `string` Product category (1st level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL2` | `string` Product category (2nd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL3` | `string` Product category (3rd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL4` | `string` Product category (4th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL5` | `string` Product category (5th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `productTypeL1` | `string` Product type (1st level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `productTypeL2` | `string` Product type (2nd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `productTypeL3` | `string` Product type (3rd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `productTypeL4` | `string` Product type (4th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `productTypeL5` | `string` Product type (5th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `condition` | `string` [Condition](https://support.google.com/merchants/answer/6324469) of the product. |
| `availability` | `string` [Availability](https://support.google.com/merchants/answer/6324448) of the product. |
| `shippingLabel` | `string` Normalized [shipping label](https://support.google.com/merchants/answer/6324504) specified in the data source. |
| `itemGroupId` | `string` Item group id provided by the merchant for grouping variants together. |
| `thumbnailLink` | `string` Link to the processed image of the product, hosted on the Google infrastructure. |
| `aggregatedReportingContextStatus` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#AggregatedReportingContextStatus`)`` Aggregated status across all reporting contexts. Reporting contexts included in the computation of the aggregated status can be restricted using a filter on the `reportingContext` field. |
| `reportingContext` | ``enum (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/ReportingContextEnum`)`` Reporting context to restrict the query to. Restricts the reporting contexts returned in `statusPerReportingContext` and `itemIssues`, and used to compute `aggregatedReportingContextStatus`. **This field can only be used in the `WHERE` clause and cannot be selected in the `SELECT` clause.** |
| `clickPotentialRank` | `string (https://developers.google.com/discovery/v1/type-format format)` Normalized click potential of the product. Values range from 1 to 1000, where 1 is the highest click potential and 1000 is the theoretical lowest. |

## AggregatedReportingContextStatus

Status of the product aggregated for all reporting contexts.

Reporting contexts included in the computation of the aggregated status can be restricted using a filter on the `reportingContext` field.

Here's an example of how the aggregated status is computed:

| Free listings | Shopping ads | Status |
|---|---|---|
| Approved | Approved | ELIGIBLE |
| Approved | Pending | ELIGIBLE |
| Approved | Disapproved | ELIGIBLE_LIMITED |
| Pending | Pending | PENDING |
| Disapproved | Disapproved | NOT_ELIGIBLE_OR_DISAPPROVED |

| Enums ||
|---|---|
| `AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED` | Not specified. |
| `NOT_ELIGIBLE_OR_DISAPPROVED` | Product is not eligible or is disapproved for all reporting contexts and countries. |
| `PENDING` | Product's status is pending in all reporting contexts and countries. |
| `ELIGIBLE_LIMITED` | Product is eligible for some (but not all) reporting contexts and countries. |
| `ELIGIBLE` | Product is eligible for all reporting contexts and countries. |

## StatusPerReportingContext

Status of the product for a specific reporting context.

Equivalent to `https://developers.google.com/merchant/api/reference/rest/products_v1/accounts.products#DestinationStatus` in Products API.

| JSON representation |
|---|
| ``` { "approvedCountries": [ string ], "disapprovedCountries": [ string ], "pendingCountries": [ string ], "reportingContext": enum (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/ReportingContextEnum`) } ``` |

| Fields ||
|---|---|
| `approvedCountries[]` | `string` List of approved countries in the reporting context, represented in [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format, for example, `US`. |
| `disapprovedCountries[]` | `string` List of disapproved countries in the reporting context, represented in [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format, for example, `US`. |
| `pendingCountries[]` | `string` List of pending countries in the reporting context, represented in [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format, for example, `US`. |
| `reportingContext` | ``enum (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/ReportingContextEnum`)`` Reporting context the status applies to. |

## ItemIssue

Item issue associated with the product.

| JSON representation |
|---|
| ``` { "type": { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssueType`) }, "severity": { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssueSeverity`) }, "resolution": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssueResolution`) } ``` |

| Fields ||
|---|---|
| `type` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssueType`)`` Item issue type. |
| `severity` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssueSeverity`)`` Item issue severity. |
| `resolution` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ItemIssueResolution`)`` Item issue resolution. |

## ItemIssueType

Issue type.

| JSON representation |
|---|
| ``` { "code": string, "canonicalAttribute": string } ``` |

| Fields ||
|---|---|
| `code` | `string` Error code of the issue, equivalent to the `code` of [Product issues](https://developers.google.com/shopping-content/guides/product-issues). |
| `canonicalAttribute` | `string` Canonical attribute name for attribute-specific issues. |

## ItemIssueSeverity

How the issue affects the serving of the product.

| JSON representation |
|---|
| ``` { "severityPerReportingContext": [ { object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#IssueSeverityPerReportingContext`) } ], "aggregatedSeverity": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#AggregatedIssueSeverity`) } ``` |

| Fields ||
|---|---|
| `severityPerReportingContext[]` | ``object (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#IssueSeverityPerReportingContext`)`` Issue severity per reporting context. Reporting contexts included in this list can be restricted using a filter on the `reportingContext` field. |
| `aggregatedSeverity` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#AggregatedIssueSeverity`)`` Aggregated severity of the issue for all reporting contexts it affects. Reporting contexts included in the computation of the aggregated severity can be restricted using a filter on the `reportingContext` field. **This field can be used for filtering the results.** |

## IssueSeverityPerReportingContext

Issue severity per reporting context.

| JSON representation |
|---|
| ``` { "disapprovedCountries": [ string ], "demotedCountries": [ string ], "reportingContext": enum (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/ReportingContextEnum`) } ``` |

| Fields ||
|---|---|
| `disapprovedCountries[]` | `string` List of disapproved countries in the reporting context, represented in ISO 3166 format. |
| `demotedCountries[]` | `string` List of demoted countries in the reporting context, represented in ISO 3166 format. |
| `reportingContext` | ``enum (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/ReportingContextEnum`)`` Reporting context the issue applies to. |

## AggregatedIssueSeverity

Issue severity aggregated for all reporting contexts.

| Enums ||
|---|---|
| `AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED` | Not specified. |
| `DISAPPROVED` | Issue disapproves the product in at least one reporting context. |
| `DEMOTED` | Issue demotes the product in all reporting contexts it affects. |
| `PENDING` | Issue resolution is `PENDING_PROCESSING`. |

## ItemIssueResolution

How to resolve the issue.

| Enums ||
|---|---|
| `ITEM_ISSUE_RESOLUTION_UNSPECIFIED` | Not specified. |
| `MERCHANT_ACTION` | The merchant has to fix the issue. |
| `PENDING_PROCESSING` | The issue will be resolved automatically (for example, image crawl) or through a Google review. No merchant action is required now. Resolution might lead to another issue (for example, if crawl fails). |

## ClickPotential

A product's [click potential](https://support.google.com/merchants/answer/188488) estimates its performance potential compared to highest performing products of the merchant. Click potential of a product helps merchants to prioritize which products to fix and helps them understand how products are performing against their potential.

| Enums ||
|---|---|
| `CLICK_POTENTIAL_UNSPECIFIED` | Unknown predicted clicks impact. |
| `LOW` | Potential to receive a low number of clicks compared to the highest performing products of the merchant. |
| `MEDIUM` | Potential to receive a moderate number of clicks compared to the highest performing products of the merchant. |
| `HIGH` | Potential to receive a similar number of clicks as the highest performing products of the merchant. |

## PriceCompetitivenessProductView

Fields available for query in `priceCompetitivenessProductView` table.

[Price competitiveness](https://support.google.com/merchants/answer/9626903) report.

Values are only set for fields requested explicitly in the request's search query.

| JSON representation |
|---|
| ``` { "price": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Price`) }, "benchmarkPrice": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Price`) }, "reportCountryCode": string, "id": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string } ``` |

| Fields ||
|---|---|
| `price` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Price`)`` Current price of the product. |
| `benchmarkPrice` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Price`)`` Latest available price benchmark for the product's catalog in the benchmark country. |
| `reportCountryCode` | `string` Country of the price benchmark. Represented in the ISO 3166 format. Required in the `SELECT` clause. |
| `id` | `string` REST ID of the product, in the form of `channel~languageCode~feedLabel~offerId`. Can be used to join data with the `productView` table. Required in the `SELECT` clause. |
| `offerId` | `string` Merchant-provided id of the product. |
| `title` | `string` Title of the product. |
| `brand` | `string` Brand of the product. |
| `categoryL1` | `string` Product category (1st level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL2` | `string` Product category (2nd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL3` | `string` Product category (3rd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL4` | `string` Product category (4th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL5` | `string` Product category (5th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `productTypeL1` | `string` Product type (1st level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `productTypeL2` | `string` Product type (2nd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `productTypeL3` | `string` Product type (3rd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `productTypeL4` | `string` Product type (4th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `productTypeL5` | `string` Product type (5th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |

## PriceInsightsProductView

Fields available for query in `priceInsightsProductView` table.

[Price insights](https://support.google.com/merchants/answer/11916926) report.

Values are only set for fields requested explicitly in the request's search query.

| JSON representation |
|---|
| ``` { "price": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Price`) }, "suggestedPrice": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Price`) }, "effectiveness": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#Effectiveness`), "id": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "predictedImpressionsChangeFraction": number, "predictedClicksChangeFraction": number, "predictedConversionsChangeFraction": number } ``` |

| Fields ||
|---|---|
| `price` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Price`)`` Current price of the product. |
| `suggestedPrice` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Price`)`` Latest suggested price for the product. |
| `effectiveness` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#Effectiveness`)`` The predicted effectiveness of applying the price suggestion, bucketed. |
| `id` | `string` REST ID of the product, in the form of `channel~languageCode~feedLabel~offerId`. Can be used to join data with the `productView` table. Required in the `SELECT` clause. |
| `offerId` | `string` Merchant-provided id of the product. |
| `title` | `string` Title of the product. |
| `brand` | `string` Brand of the product. |
| `categoryL1` | `string` Product category (1st level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL2` | `string` Product category (2nd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL3` | `string` Product category (3rd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL4` | `string` Product category (4th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL5` | `string` Product category (5th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `productTypeL1` | `string` Product type (1st level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `productTypeL2` | `string` Product type (2nd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `productTypeL3` | `string` Product type (3rd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `productTypeL4` | `string` Product type (4th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `productTypeL5` | `string` Product type (5th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). |
| `predictedImpressionsChangeFraction` | `number` Predicted change in impressions as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in impressions. |
| `predictedClicksChangeFraction` | `number` Predicted change in clicks as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in clicks. |
| `predictedConversionsChangeFraction` | `number` Predicted change in conversions as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in conversions). |

## Effectiveness

Predicted effectiveness bucket.

Effectiveness indicates which products would benefit most from price changes. This rating takes into consideration the performance boost predicted by adjusting the sale price and the difference between your current price and the suggested price. Price suggestions with `HIGH` effectiveness are predicted to drive the largest increase in performance.

| Enums ||
|---|---|
| `EFFECTIVENESS_UNSPECIFIED` | Effectiveness is unknown. |
| `LOW` | Effectiveness is low. |
| `MEDIUM` | Effectiveness is medium. |
| `HIGH` | Effectiveness is high. |

## BestSellersProductClusterView

Fields available for query in `bestSellersProductClusterView` table.

[Best sellers](https://support.google.com/merchants/answer/9488679) report with top product clusters. A product cluster is a grouping for different offers and variants that represent the same product, for example, Google Pixel 7.

Values are only set for fields requested explicitly in the request's search query.

| JSON representation |
|---|
| ``` { "reportDate": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`) }, "variantGtins": [ string ], "reportGranularity": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ReportGranularityEnum`), "reportCountryCode": string, "reportCategoryId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "inventoryStatus": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#InventoryStatus`), "brandInventoryStatus": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#InventoryStatus`), "rank": string, "previousRank": string, "relativeDemand": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandEnum`), "previousRelativeDemand": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandEnum`), "relativeDemandChange": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandChangeTypeEnum`) } ``` |

| Fields ||
|---|---|
| `reportDate` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`)`` Report date. The value of this field can only be one of the following: - The first day of the week (Monday) for weekly reports, - The first day of the month for monthly reports. Required in the `SELECT` clause. If a `WHERE` condition on `reportDate` is not specified in the query, the latest available weekly or monthly report is returned. |
| `variantGtins[]` | `string` GTINs of example variants of the product cluster. |
| `reportGranularity` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ReportGranularityEnum`)`` Granularity of the report. The ranking can be done over a week or a month timeframe. Required in the `SELECT` clause. Condition on `reportGranularity` is required in the `WHERE` clause. |
| `reportCountryCode` | `string` Country where the ranking is calculated. Represented in the ISO 3166 format. Required in the `SELECT` clause. Condition on `reportCountryCode` is required in the `WHERE` clause. |
| `reportCategoryId` | `string (https://developers.google.com/discovery/v1/type-format format)` Google product category ID to calculate the ranking for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. If a `WHERE` condition on `reportCategoryId` is not specified in the query, rankings for all top-level categories are returned. |
| `title` | `string` Title of the product cluster. |
| `brand` | `string` Brand of the product cluster. |
| `categoryL1` | `string` Product category (1st level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL2` | `string` Product category (2nd level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL3` | `string` Product category (3rd level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL4` | `string` Product category (4th level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `categoryL5` | `string` Product category (5th level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). |
| `inventoryStatus` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#InventoryStatus`)`` Whether the product cluster is `IN_STOCK` in your product data source in at least one of the countries, `OUT_OF_STOCK` in your product data source in all countries, or `NOT_IN_INVENTORY` at all. The field doesn't take the Best sellers report country filter into account. |
| `brandInventoryStatus` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#InventoryStatus`)`` Whether there is at least one product of the brand currently `IN_STOCK` in your product data source in at least one of the countries, all products are `OUT_OF_STOCK` in your product data source in all countries, or `NOT_IN_INVENTORY`. The field doesn't take the Best sellers report country filter into account. |
| `rank` | `string (https://developers.google.com/discovery/v1/type-format format)` Popularity of the product cluster on Ads and organic surfaces, in the selected category and country, based on the estimated number of units sold. |
| `previousRank` | `string (https://developers.google.com/discovery/v1/type-format format)` Popularity rank in the previous week or month. |
| `relativeDemand` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandEnum`)`` Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country. |
| `previousRelativeDemand` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandEnum`)`` Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country in the previous week or month. |
| `relativeDemandChange` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandChangeTypeEnum`)`` Change in the estimated demand. Whether it rose, sank or remained flat. |

## ReportGranularityEnum

Report granularity values.

| Enums ||
|---|---|
| `REPORT_GRANULARITY_ENUM_UNSPECIFIED` | Not specified. |
| `WEEKLY` | Report is computed over a week timeframe. |
| `MONTHLY` | Report is computed over a month timeframe. |

## InventoryStatus

Status of the product cluster or brand in your inventory.

| Enums ||
|---|---|
| `INVENTORY_STATUS_UNSPECIFIED` | Not specified. |
| `IN_STOCK` | You have a product for this product cluster or brand in stock. |
| `OUT_OF_STOCK` | You have a product for this product cluster or brand in inventory but it is currently out of stock. |
| `NOT_IN_INVENTORY` | You do not have a product for this product cluster or brand in inventory. |

## RelativeDemandEnum

Relative demand values.

| Enums ||
|---|---|
| `RELATIVE_DEMAND_ENUM_UNSPECIFIED` | Not specified. |
| `VERY_LOW` | Demand is 0-5% of the demand of the highest ranked product cluster or brand. |
| `LOW` | Demand is 6-10% of the demand of the highest ranked product cluster or brand. |
| `MEDIUM` | Demand is 11-20% of the demand of the highest ranked product cluster or brand. |
| `HIGH` | Demand is 21-50% of the demand of the highest ranked product cluster or brand. |
| `VERY_HIGH` | Demand is 51-100% of the demand of the highest ranked product cluster or brand. |

## RelativeDemandChangeTypeEnum

Relative demand change type values.

| Enums ||
|---|---|
| `RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED` | Not specified. |
| `SINKER` | Relative demand is lower than the previous time period. |
| `FLAT` | Relative demand is equal to the previous time period. |
| `RISER` | Relative demand is higher than the previous time period. |

## BestSellersBrandView

Fields available for query in `bestSellersBrandView` table.

[Best sellers](https://support.google.com/merchants/answer/9488679) report with top brands.

Values are only set for fields requested explicitly in the request's search query.

| JSON representation |
|---|
| ``` { "reportDate": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`) }, "reportGranularity": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ReportGranularityEnum`), "reportCountryCode": string, "reportCategoryId": string, "brand": string, "rank": string, "previousRank": string, "relativeDemand": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandEnum`), "previousRelativeDemand": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandEnum`), "relativeDemandChange": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandChangeTypeEnum`) } ``` |

| Fields ||
|---|---|
| `reportDate` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`)`` Report date. The value of this field can only be one of the following: - The first day of the week (Monday) for weekly reports, - The first day of the month for monthly reports. Required in the `SELECT` clause. If a `WHERE` condition on `reportDate` is not specified in the query, the latest available weekly or monthly report is returned. |
| `reportGranularity` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#ReportGranularityEnum`)`` Granularity of the report. The ranking can be done over a week or a month timeframe. Required in the `SELECT` clause. Condition on `reportGranularity` is required in the `WHERE` clause. |
| `reportCountryCode` | `string` Country where the ranking is calculated. Represented in the ISO 3166 format. Required in the `SELECT` clause. Condition on `reportCountryCode` is required in the `WHERE` clause. |
| `reportCategoryId` | `string (https://developers.google.com/discovery/v1/type-format format)` Google product category ID to calculate the ranking for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. If a `WHERE` condition on `reportCategoryId` is not specified in the query, rankings for all top-level categories are returned. |
| `brand` | `string` Name of the brand. |
| `rank` | `string (https://developers.google.com/discovery/v1/type-format format)` Popularity of the brand on Ads and organic surfaces, in the selected category and country, based on the estimated number of units sold. |
| `previousRank` | `string (https://developers.google.com/discovery/v1/type-format format)` Popularity rank in the previous week or month. |
| `relativeDemand` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandEnum`)`` Estimated demand in relation to the brand with the highest popularity rank in the same category and country. |
| `previousRelativeDemand` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandEnum`)`` Estimated demand in relation to the brand with the highest popularity rank in the same category and country in the previous week or month. |
| `relativeDemandChange` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#RelativeDemandChangeTypeEnum`)`` Change in the estimated demand. Whether it rose, sank or remained flat. |

## CompetitiveVisibilityCompetitorView

Fields available for query in `competitiveVisibilityCompetitorView` table.

[Competitive visibility](https://support.google.com/merchants/answer/11366442) report with businesses with similar visibility.

Values are only set for fields requested explicitly in the request's search query.

| JSON representation |
|---|
| ``` { "date": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`) }, "domain": string, "isYourDomain": boolean, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#TrafficSourceEnum`), "rank": string, "adsOrganicRatio": number, "pageOverlapRate": number, "higherPositionRate": number, "relativeVisibility": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`)`` Date of this row. A condition on `date` is required in the `WHERE` clause. |
| `domain` | `string` Domain of your competitor or your domain, if `isYourDomain` is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause. |
| `isYourDomain` | `boolean` True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause. |
| `reportCountryCode` | `string` Country where impressions appeared. Required in the `SELECT` clause. A condition on `reportCountryCode` is required in the `WHERE` clause. |
| `reportCategoryId` | `string (https://developers.google.com/discovery/v1/type-format format)` Google product category ID to calculate the report for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. A condition on `reportCategoryId` is required in the `WHERE` clause. |
| `trafficSource` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#TrafficSourceEnum`)`` Traffic source of impressions. Required in the `SELECT` clause. |
| `rank` | `string (https://developers.google.com/discovery/v1/type-format format)` Position of the domain in the similar businesses ranking for the selected keys (`date`, `reportCategoryId`, `reportCountryCode`, `trafficSource`) based on impressions. 1 is the highest. Cannot be filtered on in the 'WHERE' clause. |
| `adsOrganicRatio` | `number` [Ads / organic ratio](https://support.google.com/merchants/answer/11366442#zippy=%2Cads-free-ratio) shows how often the domain receives impressions from Shopping ads compared to organic traffic. The number is rounded and bucketed. Cannot be filtered on in the 'WHERE' clause. |
| `pageOverlapRate` | `number` [Page overlap rate](https://support.google.com/merchants/answer/11366442#zippy=%2Cpage-overlap-rate) shows how frequently competing retailers' offers are shown together with your offers on the same page. Cannot be filtered on in the 'WHERE' clause. |
| `higherPositionRate` | `number` [Higher position rate](https://support.google.com/merchants/answer/11366442#zippy=%2Chigher-position-rate) shows how often a competitor's offer got placed in a higher position on the page than your offer. Cannot be filtered on in the 'WHERE' clause. |
| `relativeVisibility` | `number` [Relative visibility](https://support.google.com/merchants/answer/11366442#zippy=%2Crelative-visibility) shows how often your competitors' offers are shown compared to your offers. In other words, this is the number of displayed impressions of a competitor retailer divided by the number of your displayed impressions during a selected time range for a selected product category and country. Cannot be filtered on in the 'WHERE' clause. |

## TrafficSourceEnum

Traffic source values.

| Enums ||
|---|---|
| `TRAFFIC_SOURCE_ENUM_UNSPECIFIED` | Not specified. |
| `ORGANIC` | Organic traffic. |
| `ADS` | Traffic from ads. |
| `ALL` | Organic and ads traffic. |

## CompetitiveVisibilityTopMerchantView

Fields available for query in `competitiveVisibilityTopMerchantView` table.

[Competitive visibility](https://support.google.com/merchants/answer/11366442) report with business with highest visibility.

Values are only set for fields requested explicitly in the request's search query.

| JSON representation |
|---|
| ``` { "date": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`) }, "domain": string, "isYourDomain": boolean, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#TrafficSourceEnum`), "rank": string, "adsOrganicRatio": number, "pageOverlapRate": number, "higherPositionRate": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`)`` Date of this row. Cannot be selected in the `SELECT` clause. A condition on `date` is required in the `WHERE` clause. |
| `domain` | `string` Domain of your competitor or your domain, if `isYourDomain` is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause. |
| `isYourDomain` | `boolean` True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause. |
| `reportCountryCode` | `string` Country where impressions appeared. Required in the `SELECT` clause. A condition on `reportCountryCode` is required in the `WHERE` clause. |
| `reportCategoryId` | `string (https://developers.google.com/discovery/v1/type-format format)` Google product category ID to calculate the report for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. A condition on `reportCategoryId` is required in the `WHERE` clause. |
| `trafficSource` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#TrafficSourceEnum`)`` Traffic source of impressions. Required in the `SELECT` clause. |
| `rank` | `string (https://developers.google.com/discovery/v1/type-format format)` Position of the domain in the top merchants ranking for the selected keys (`date`, `reportCategoryId`, `reportCountryCode`, `trafficSource`) based on impressions. 1 is the highest. Cannot be filtered on in the 'WHERE' clause. |
| `adsOrganicRatio` | `number` [Ads / organic ratio](https://support.google.com/merchants/answer/11366442#zippy=%2Cads-free-ratio) shows how often the domain receives impressions from Shopping ads compared to organic traffic. The number is rounded and bucketed. Cannot be filtered on in the 'WHERE' clause. |
| `pageOverlapRate` | `number` [Page overlap rate](https://support.google.com/merchants/answer/11366442#zippy=%2Cpage-overlap-rate) shows how frequently competing retailers' offers are shown together with your offers on the same page. Cannot be filtered on in the 'WHERE' clause. |
| `higherPositionRate` | `number` [Higher position rate](https://support.google.com/merchants/answer/11366442#zippy=%2Chigher-position-rate) shows how often a competitor's offer got placed in a higher position on the page than your offer. Cannot be filtered on in the 'WHERE' clause. |

## CompetitiveVisibilityBenchmarkView

Fields available for query in `competitiveVisibilityBenchmarkView` table.

[Competitive visibility](https://support.google.com/merchants/answer/11366442) report with the category benchmark.

Values are only set for fields requested explicitly in the request's search query.

| JSON representation |
|---|
| ``` { "date": { object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`) }, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#TrafficSourceEnum`), "yourDomainVisibilityTrend": number, "categoryBenchmarkVisibilityTrend": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`https://developers.google.com/merchant/api/reference/rest/Shared.Types/Date`)`` Date of this row. Required in the `SELECT` clause. A condition on `date` is required in the `WHERE` clause. |
| `reportCountryCode` | `string` Country where impressions appeared. Required in the `SELECT` clause. A condition on `reportCountryCode` is required in the `WHERE` clause. |
| `reportCategoryId` | `string (https://developers.google.com/discovery/v1/type-format format)` Google product category ID to calculate the report for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. A condition on `reportCategoryId` is required in the `WHERE` clause. |
| `trafficSource` | ``enum (`https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports#TrafficSourceEnum`)`` Traffic source of impressions. Required in the `SELECT` clause. |
| `yourDomainVisibilityTrend` | `number` Change in visibility based on impressions for your domain with respect to the start of the selected time range (or first day with non-zero impressions). Cannot be filtered on in the 'WHERE' clause. |
| `categoryBenchmarkVisibilityTrend` | `number` Change in visibility based on impressions with respect to the start of the selected time range (or first day with non-zero impressions) for a combined set of merchants with highest visibility approximating the market. Cannot be filtered on in the 'WHERE' clause. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/merchant/api/reference/rest/reports_v1/accounts.reports/search` | Retrieves a report defined by a search query. |