- [Resource: ReportRow](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ReportRow)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ReportRow.SCHEMA_REPRESENTATION)
- [ProductPerformanceView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ProductPerformanceView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ProductPerformanceView.SCHEMA_REPRESENTATION)
- [MarketingMethodEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#MarketingMethodEnum)
- [StoreTypeEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#StoreTypeEnum)
- [NetworkEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#NetworkEnum)
- [NonProductPerformanceView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#NonProductPerformanceView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#NonProductPerformanceView.SCHEMA_REPRESENTATION)
- [ProductView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ProductView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ProductView.SCHEMA_REPRESENTATION)
- [AggregatedReportingContextStatus](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#AggregatedReportingContextStatus)
- [StatusPerReportingContext](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#StatusPerReportingContext)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#StatusPerReportingContext.SCHEMA_REPRESENTATION)
- [ItemIssue](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ItemIssue)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ItemIssue.SCHEMA_REPRESENTATION)
- [ItemIssueType](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ItemIssueType)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ItemIssueType.SCHEMA_REPRESENTATION)
- [ItemIssueSeverity](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ItemIssueSeverity)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ItemIssueSeverity.SCHEMA_REPRESENTATION)
- [IssueSeverityPerReportingContext](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#IssueSeverityPerReportingContext)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#IssueSeverityPerReportingContext.SCHEMA_REPRESENTATION)
- [AggregatedIssueSeverity](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#AggregatedIssueSeverity)
- [ItemIssueResolution](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ItemIssueResolution)
- [ClickPotential](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ClickPotential)
- [PriceCompetitivenessProductView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#PriceCompetitivenessProductView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#PriceCompetitivenessProductView.SCHEMA_REPRESENTATION)
- [PriceInsightsProductView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#PriceInsightsProductView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#PriceInsightsProductView.SCHEMA_REPRESENTATION)
- [Effectiveness](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#Effectiveness)
- [BestSellersProductClusterView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#BestSellersProductClusterView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#BestSellersProductClusterView.SCHEMA_REPRESENTATION)
- [ReportGranularityEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ReportGranularityEnum)
- [InventoryStatus](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#InventoryStatus)
- [RelativeDemandEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#RelativeDemandEnum)
- [RelativeDemandChangeTypeEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#RelativeDemandChangeTypeEnum)
- [BestSellersBrandView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#BestSellersBrandView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#BestSellersBrandView.SCHEMA_REPRESENTATION)
- [CompetitiveVisibilityCompetitorView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#CompetitiveVisibilityCompetitorView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#CompetitiveVisibilityCompetitorView.SCHEMA_REPRESENTATION)
- [TrafficSourceEnum](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#TrafficSourceEnum)
- [CompetitiveVisibilityTopMerchantView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#CompetitiveVisibilityTopMerchantView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#CompetitiveVisibilityTopMerchantView.SCHEMA_REPRESENTATION)
- [CompetitiveVisibilityBenchmarkView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#CompetitiveVisibilityBenchmarkView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#CompetitiveVisibilityBenchmarkView.SCHEMA_REPRESENTATION)
- [YoutubeCreatorPerformanceView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeCreatorPerformanceView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeCreatorPerformanceView.SCHEMA_REPRESENTATION)
- [YoutubeContentPerformanceView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeContentPerformanceView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeContentPerformanceView.SCHEMA_REPRESENTATION)
- [ContentType](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#ContentType)
- [YoutubeProductPerformanceView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeProductPerformanceView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeProductPerformanceView.SCHEMA_REPRESENTATION)
- [YoutubeProductSoldStatsView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeProductSoldStatsView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeProductSoldStatsView.SCHEMA_REPRESENTATION)
- [YoutubeProductTaggedStatsView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeProductTaggedStatsView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeProductTaggedStatsView.SCHEMA_REPRESENTATION)
- [YoutubeCampaignsStatsView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeCampaignsStatsView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeCampaignsStatsView.SCHEMA_REPRESENTATION)
- [YoutubeIndividualCampaignStatsView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeIndividualCampaignStatsView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeIndividualCampaignStatsView.SCHEMA_REPRESENTATION)
- [YoutubeCampaignVideosStatsView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeCampaignVideosStatsView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeCampaignVideosStatsView.SCHEMA_REPRESENTATION)
- [YoutubeCampaignProductsStatsView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeCampaignProductsStatsView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeCampaignProductsStatsView.SCHEMA_REPRESENTATION)
- [UcpAgenticPerformanceView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#UcpAgenticPerformanceView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#UcpAgenticPerformanceView.SCHEMA_REPRESENTATION)
- [UcpAgenticProductPerformanceView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#UcpAgenticProductPerformanceView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#UcpAgenticProductPerformanceView.SCHEMA_REPRESENTATION)
- [YoutubeProductCategoryTaggedStatsView](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeProductCategoryTaggedStatsView)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#YoutubeProductCategoryTaggedStatsView.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/merchant/api/reference/rest/reports_v1alpha/accounts.reports.md.txt#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 (`ProductPerformanceView`) }, "nonProductPerformanceView": { object (`NonProductPerformanceView`) }, "productView": { object (`ProductView`) }, "priceCompetitivenessProductView": { object (`PriceCompetitivenessProductView`) }, "priceInsightsProductView": { object (`PriceInsightsProductView`) }, "bestSellersProductClusterView": { object (`BestSellersProductClusterView`) }, "bestSellersBrandView": { object (`BestSellersBrandView`) }, "competitiveVisibilityCompetitorView": { object (`CompetitiveVisibilityCompetitorView`) }, "competitiveVisibilityTopMerchantView": { object (`CompetitiveVisibilityTopMerchantView`) }, "competitiveVisibilityBenchmarkView": { object (`CompetitiveVisibilityBenchmarkView`) }, "youtubeCreatorPerformanceView": { object (`YoutubeCreatorPerformanceView`) }, "youtubeContentPerformanceView": { object (`YoutubeContentPerformanceView`) }, "youtubeProductPerformanceView": { object (`YoutubeProductPerformanceView`) }, "youtubeProductSoldStatsView": { object (`YoutubeProductSoldStatsView`) }, "youtubeProductTaggedStatsView": { object (`YoutubeProductTaggedStatsView`) }, "youtubeCampaignsStatsView": { object (`YoutubeCampaignsStatsView`) }, "youtubeIndividualCampaignStatsView": { object (`YoutubeIndividualCampaignStatsView`) }, "youtubeCampaignVideosStatsView": { object (`YoutubeCampaignVideosStatsView`) }, "youtubeCampaignProductsStatsView": { object (`YoutubeCampaignProductsStatsView`) }, "ucpAgenticPerformanceView": { object (`UcpAgenticPerformanceView`) }, "ucpAgenticProductPerformanceView": { object (`UcpAgenticProductPerformanceView`) }, "youtubeProductCategoryTaggedStatsView": { object (`YoutubeProductCategoryTaggedStatsView`) } } ``` |

| Fields ||
|---|---|
| `productPerformanceView` | ``object (`ProductPerformanceView`)`` Fields available for query in `productPerformanceView` table. |
| `nonProductPerformanceView` | ``object (`NonProductPerformanceView`)`` Fields available for query in `nonProductPerformanceView` table. |
| `productView` | ``object (`ProductView`)`` Fields available for query in `productView` table. |
| `priceCompetitivenessProductView` | ``object (`PriceCompetitivenessProductView`)`` Fields available for query in `priceCompetitivenessProductView` table. |
| `priceInsightsProductView` | ``object (`PriceInsightsProductView`)`` Fields available for query in `priceInsightsProductView` table. |
| `bestSellersProductClusterView` | ``object (`BestSellersProductClusterView`)`` Fields available for query in `bestSellersProductClusterView` table. |
| `bestSellersBrandView` | ``object (`BestSellersBrandView`)`` Fields available for query in `bestSellersBrandView` table. |
| `competitiveVisibilityCompetitorView` | ``object (`CompetitiveVisibilityCompetitorView`)`` Fields available for query in `competitiveVisibilityCompetitorView` table. |
| `competitiveVisibilityTopMerchantView` | ``object (`CompetitiveVisibilityTopMerchantView`)`` Fields available for query in `competitiveVisibilityTopMerchantView` table. |
| `competitiveVisibilityBenchmarkView` | ``object (`CompetitiveVisibilityBenchmarkView`)`` Fields available for query in `competitiveVisibilityBenchmarkView` table. |
| `youtubeCreatorPerformanceView` | ``object (`YoutubeCreatorPerformanceView`)`` Fields available for query in `youtubeCreatorPerformanceView` table. |
| `youtubeContentPerformanceView` | ``object (`YoutubeContentPerformanceView`)`` Fields available for query in `youtubeContentPerformanceView` table. |
| `youtubeProductPerformanceView (deprecated)` | ``object (`YoutubeProductPerformanceView`)`` > [!WARNING] > This item is deprecated! Deprecated: Use `youtubeProductSoldStatsView` or `youtubeProductTaggedStatsView` instead. Fields available for query in `youtubeProductPerformanceView` table. |
| `youtubeProductSoldStatsView` | ``object (`YoutubeProductSoldStatsView`)`` Fields available for query in `youtubeProductSoldStatsView` table. |
| `youtubeProductTaggedStatsView` | ``object (`YoutubeProductTaggedStatsView`)`` Fields available for query in `youtubeProductTaggedStatsView` table. |
| `youtubeCampaignsStatsView` | ``object (`YoutubeCampaignsStatsView`)`` Fields available for query in `youtubeCampaignsStatsView` table. |
| `youtubeIndividualCampaignStatsView` | ``object (`YoutubeIndividualCampaignStatsView`)`` Fields available for query in `youtubeIndividualCampaignStatsView` table. |
| `youtubeCampaignVideosStatsView` | ``object (`YoutubeCampaignVideosStatsView`)`` Fields available for query in `youtubeCampaignVideosStatsView` table. |
| `youtubeCampaignProductsStatsView` | ``object (`YoutubeCampaignProductsStatsView`)`` Fields available for query in `youtubeCampaignProductsStatsView` table. |
| `ucpAgenticPerformanceView` | ``object (`UcpAgenticPerformanceView`)`` Fields available for query in `ucpAgenticPerformanceView` table. |
| `ucpAgenticProductPerformanceView` | ``object (`UcpAgenticProductPerformanceView`)`` Fields available for query in `ucpAgenticProductPerformanceView` table. |
| `youtubeProductCategoryTaggedStatsView` | ``object (`YoutubeProductCategoryTaggedStatsView`)`` Fields available for query in `youtubeProductCategoryTaggedStatsView` 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 (`Date`) }, "week": { object (`Date`) }, "conversionValue": { object (`Price`) }, "marketingMethod": enum (`MarketingMethodEnum`), "customerCountryCode": string, "storeType": enum (`StoreTypeEnum`), "network": enum (`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 (`Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Condition on `date` is required in the `WHERE` clause. |
| `week` | ``object (`Date`)`` First day of the week (Monday) of the metrics date in the Merchant Center account timezone. Segment. |
| `conversionValue` | ``object (`Price`)`` Value of conversions attributed to the product, reported on the conversion date. Metric. Available only for the `FREE` traffic source. |
| `marketingMethod` | ``enum (`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 (`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 (`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.md.txt#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.md.txt#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.md.txt#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.md.txt#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.md.txt#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.md.txt#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.md.txt#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.md.txt#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.md.txt#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.md.txt#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 (int64 format)` Number of clicks. Metric. |
| `impressions` | `string (int64 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 (`Date`) }, "week": { object (`Date`) }, "clicks": string, "impressions": string, "clickThroughRate": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Condition on `date` is required in the `WHERE` clause. |
| `week` | ``object (`Date`)`` First day of the week (Monday) of the metrics date in the Merchant Center account timezone. Segment. |
| `clicks` | `string (int64 format)` Number of clicks on images and online store links leading to your non-product pages. Metric. |
| `impressions` | `string (int64 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.md.txt) 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 (`Price`) }, "gtin": [ string ], "creationTime": string, "expirationDate": { object (`Date`) }, "statusPerReportingContext": [ { object (`StatusPerReportingContext`) } ], "itemIssues": [ { object (`ItemIssue`) } ], "clickPotential": enum (`ClickPotential`), "id": string, "channel": enum (`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 (`AggregatedReportingContextStatus`), "reportingContext": enum (`ReportingContextEnum`), "clickPotentialRank": string } ``` |

| Fields ||
|---|---|
| `price` | ``object (`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 (`Timestamp` format)`` The time the merchant created the product in timestamp seconds. |
| `expirationDate` | ``object (`Date`)`` Expiration date for the product, specified on insertion. |
| `statusPerReportingContext[]` | ``object (`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 `` `ProductStatus.destination_statuses` `` in Products API. **This field cannot be used for sorting or filtering the results.** |
| `itemIssues[]` | ``object (`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 (`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 (`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 (`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 (`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 (int64 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 `` `DestinationStatus` `` in Products API.

| JSON representation |
|---|
| ``` { "approvedCountries": [ string ], "disapprovedCountries": [ string ], "pendingCountries": [ string ], "reportingContext": enum (`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 (`ReportingContextEnum`)`` Reporting context the status applies to. |

## ItemIssue

Item issue associated with the product.

| JSON representation |
|---|
| ``` { "type": { object (`ItemIssueType`) }, "severity": { object (`ItemIssueSeverity`) }, "resolution": enum (`ItemIssueResolution`) } ``` |

| Fields ||
|---|---|
| `type` | ``object (`ItemIssueType`)`` Item issue type. |
| `severity` | ``object (`ItemIssueSeverity`)`` Item issue severity. |
| `resolution` | ``enum (`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.md.txt). |
| `canonicalAttribute` | `string` Canonical attribute name for attribute-specific issues. |

## ItemIssueSeverity

How the issue affects the serving of the product.

| JSON representation |
|---|
| ``` { "severityPerReportingContext": [ { object (`IssueSeverityPerReportingContext`) } ], "aggregatedSeverity": enum (`AggregatedIssueSeverity`) } ``` |

| Fields ||
|---|---|
| `severityPerReportingContext[]` | ``object (`IssueSeverityPerReportingContext`)`` Issue severity per reporting context. Reporting contexts included in this list can be restricted using a filter on the `reportingContext` field. |
| `aggregatedSeverity` | ``enum (`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 (`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 (`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 (`Price`) }, "benchmarkPrice": { object (`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 (`Price`)`` Current price of the product. |
| `benchmarkPrice` | ``object (`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 (`Price`) }, "suggestedPrice": { object (`Price`) }, "effectiveness": enum (`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 (`Price`)`` Current price of the product. |
| `suggestedPrice` | ``object (`Price`)`` Latest suggested price for the product. |
| `effectiveness` | ``enum (`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 (`Date`) }, "variantGtins": [ string ], "reportGranularity": enum (`ReportGranularityEnum`), "reportCountryCode": string, "reportCategoryId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "inventoryStatus": enum (`InventoryStatus`), "brandInventoryStatus": enum (`InventoryStatus`), "rank": string, "previousRank": string, "relativeDemand": enum (`RelativeDemandEnum`), "previousRelativeDemand": enum (`RelativeDemandEnum`), "relativeDemandChange": enum (`RelativeDemandChangeTypeEnum`) } ``` |

| Fields ||
|---|---|
| `reportDate` | ``object (`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 (`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 (int64 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 (`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 (`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 (int64 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 (int64 format)` Popularity rank in the previous week or month. |
| `relativeDemand` | ``enum (`RelativeDemandEnum`)`` Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country. |
| `previousRelativeDemand` | ``enum (`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 (`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 (`Date`) }, "reportGranularity": enum (`ReportGranularityEnum`), "reportCountryCode": string, "reportCategoryId": string, "brand": string, "rank": string, "previousRank": string, "relativeDemand": enum (`RelativeDemandEnum`), "previousRelativeDemand": enum (`RelativeDemandEnum`), "relativeDemandChange": enum (`RelativeDemandChangeTypeEnum`) } ``` |

| Fields ||
|---|---|
| `reportDate` | ``object (`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 (`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 (int64 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 (int64 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 (int64 format)` Popularity rank in the previous week or month. |
| `relativeDemand` | ``enum (`RelativeDemandEnum`)`` Estimated demand in relation to the brand with the highest popularity rank in the same category and country. |
| `previousRelativeDemand` | ``enum (`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 (`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 (`Date`) }, "domain": string, "isYourDomain": boolean, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (`TrafficSourceEnum`), "rank": string, "adsOrganicRatio": number, "pageOverlapRate": number, "higherPositionRate": number, "relativeVisibility": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`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 (int64 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 (`TrafficSourceEnum`)`` Traffic source of impressions. Required in the `SELECT` clause. |
| `rank` | `string (int64 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 (`Date`) }, "domain": string, "isYourDomain": boolean, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (`TrafficSourceEnum`), "rank": string, "adsOrganicRatio": number, "pageOverlapRate": number, "higherPositionRate": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`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 (int64 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 (`TrafficSourceEnum`)`` Traffic source of impressions. Required in the `SELECT` clause. |
| `rank` | `string (int64 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 (`Date`) }, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (`TrafficSourceEnum`), "yourDomainVisibilityTrend": number, "categoryBenchmarkVisibilityTrend": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`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 (int64 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 (`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. |

## YoutubeCreatorPerformanceView

Fields available for query in `youtubeCreatorPerformanceView` table.

[YouTube creator performance data](https://support.google.com/merchants/answer/14947975) for your account. This data is only available if an account is enrolled in the [YouTube Shopping Affiliate program](https://support.google.com/merchants/answer/14815513).

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

| JSON representation |
|---|
| ``` { "date": { object (`Date`) }, "title": string, "channelId": string, "grossSales": { object (`Price`) }, "commissions": { object (`Price`) }, "orders": string, "views": string, "clicks": string, "netSales": { object (`Price`) }, "conversionRate": number, "subscriberCount": string } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Cannot be selected in the `SELECT` clause. Condition on `date` is required in the `WHERE` clause. When using date-range, reduce the range if `RESOURCE_EXHAUSTED` is returned. |
| `title` | `string` The title of the creator channel. |
| `channelId` | `string` The id for the creator channel. |
| `grossSales` | ``object (`Price`)`` The gross sales amount, before refunds. |
| `commissions` | ``object (`Price`)`` The commissions amount (pending and paid). |
| `orders` | `string (int64 format)` The number of orders. |
| `views` | `string (int64 format)` The number of YouTube views. |
| `clicks` | `string (int64 format)` The number of product clicks. |
| `netSales` | ``object (`Price`)`` The net sales amount (includes both purchase and refunds). |
| `conversionRate` | `number` The conversion rate for the creator channel. |
| `subscriberCount` | `string (int64 format)` Optional. The number of subscribers of the creator channel. See [YouTube creator performance data](https://support.google.com/merchants/answer/14947975) for more details. |

## YoutubeContentPerformanceView

Fields available for query in `youtubeContentPerformanceView` table.

[YouTube content performance data](https://support.google.com/merchants/answer/14947975) for your account. This data is only available if an account is enrolled in the [YouTube Shopping Affiliate program](https://support.google.com/merchants/answer/14815513).

Values are only set for fields requested explicitly in the request's search query. See the [API guide](https://developers.google.com/merchant/api/guides/reports/analyze-youtube-affiliate-performance.md.txt#expandable-2) for the query example.

| JSON representation |
|---|
| ``` { "date": { object (`Date`) }, "taggedProductIds": [ string ], "accountId": string, "title": string, "videoId": string, "channelTitle": string, "channelId": string, "grossSales": { object (`Price`) }, "commissions": { object (`Price`) }, "sellerCommissions": { object (`Price`) }, "platformCommissions": { object (`Price`) }, "orders": string, "views": string, "clicks": string, "netSales": { object (`Price`) }, "conversionRate": number, "publishedDate": { object (`Date`) }, "contentType": enum (`ContentType`), "subscriberCount": string, "impressions": string } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Cannot be selected in the `SELECT` clause. Condition on `date` is required in the `WHERE` clause. When using date-range, reduce the range if `RESOURCE_EXHAUSTED` is returned. |
| `taggedProductIds[]` | `string` Set of unique [product IDs](https://support.google.com/merchants/answer/188494#id) tagged on the YouTube video. These IDs correspond to the `offerId` in the Products API. |
| `accountId` | `string (int64 format)` Optional. Merchant Center Account ID. Can be stand alone account or a sub-account. **This field cannot be used for filtering the results.** |
| `title` | `string` The video title. |
| `videoId` | `string` The video id. |
| `channelTitle` | `string` The channel title. |
| `channelId` | `string` The channel id. |
| `grossSales` | ``object (`Price`)`` The gross sales amount, before refunds. |
| `commissions` | ``object (`Price`)`` The commissions amount (pending and paid). |
| `sellerCommissions` | ``object (`Price`)`` Optional. The commissions amount funded by sellers (pending and paid). |
| `platformCommissions` | ``object (`Price`)`` Optional. The commissions amount funded by the platform (pending and paid). |
| `orders` | `string (int64 format)` The number of orders. |
| `views` | `string (int64 format)` The number of YouTube views. |
| `clicks` | `string (int64 format)` The number of product clicks. |
| `netSales` | ``object (`Price`)`` The net sales amount (includes both purchase and refunds). |
| `conversionRate` | `number` The conversion rate. This measures the ratio of orders to clicks. |
| `publishedDate` | ``object (`Date`)`` The published date of the creator content. |
| `contentType` | ``enum (`ContentType`)`` The content type of the creator content. |
| `subscriberCount` | `string (int64 format)` The number of subscribers of the creator channel. |
| `impressions` | `string (int64 format)` The number of product impressions. |

## ContentType

Content type of the creator content.

| Enums ||
|---|---|
| `CONTENT_TYPE_UNSPECIFIED` | Not specified. |
| `LIVE_STREAM` | Video content streamed in real-time. |
| `SHORTS` | Short-form, vertical video format, typically up to 60 seconds. |
| `STORY` | Ephemeral, short-form video or image collections. Note: YouTube Stories are deprecated. |
| `VIDEO` | Standard on-demand video format (VOD). This includes pre-recorded uploads that are not classified as SHORTS or LIVE_STREAM. |
| `POST` | Community updates which can include text, images, polls, or videos, shared with channel subscribers. |

## YoutubeProductPerformanceView

> [!WARNING]
> This item is deprecated!

Deprecated: Use `YoutubeProductSoldStatsView` or `YoutubeProductTaggedStatsView` instead.

Fields available for query in `youtubeProductPerformanceView` table.

[YouTube product performance data](https://support.google.com/merchants/answer/14947975) for your account. This data is only available if an account is enrolled in the [YouTube Shopping Affiliate program](https://support.google.com/merchants/answer/14815513).

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

| JSON representation |
|---|
| ``` { "date": { object (`Date`) }, "title": string, "offerId": string, "distinctVideoCount": string, "distinctCreatorCount": string, "grossSales": { object (`Price`) }, "commissions": { object (`Price`) }, "orders": string, "views": string, "clicks": string, "netSales": { object (`Price`) }, "taggedCreatorCount": string, "taggedVideoCount": string } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Cannot be selected in the `SELECT` clause. Condition on `date` is required in the `WHERE` clause. When using date-range, reduce the range if `RESOURCE_EXHAUSTED` is returned. |
| `title` | `string` The product title. |
| `offerId` | `string` The merchant-provided product id. |
| `distinctVideoCount` | `string (int64 format)` The number of distinct videos the product was shown on. |
| `distinctCreatorCount` | `string (int64 format)` The number of distinct creator channels the product was shown on. |
| `grossSales` | ``object (`Price`)`` The gross sales amount, before refunds. |
| `commissions` | ``object (`Price`)`` The commissions amount (pending and paid). |
| `orders` | `string (int64 format)` The number of orders. |
| `views` | `string (int64 format)` The number of YouTube views. |
| `clicks` | `string (int64 format)` The number of product clicks. |
| `netSales` | ``object (`Price`)`` The net sales amount (includes both purchase and refunds). |
| `taggedCreatorCount` | `string (int64 format)` The number of distinct creators that tagged the product. |
| `taggedVideoCount` | `string (int64 format)` The number of distinct videos that tagged the product. |

## YoutubeProductSoldStatsView

Fields available for query in `youtubeProductSoldStatsView` table.

[YouTube product sold data](https://support.google.com/merchants/answer/14947975) for your account. This data is only available if an account is enrolled in the [YouTube Shopping Affiliate program](https://support.google.com/merchants/answer/14815513).

This view focuses exclusively on products that were sold through the affiliate program. In contrast, `YoutubeProductTaggedStatsView` focuses on products a merchant has tagged in YouTube videos, and their subsequent performance in terms of both engagement (views, clicks) and sales.

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

| JSON representation |
|---|
| ``` { "date": { object (`Date`) }, "offerId": string, "title": string, "grossSales": { object (`Price`) }, "netSales": { object (`Price`) }, "commissions": { object (`Price`) }, "orders": string, "productType": string } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Cannot be present in the `SELECT` clause. Required in the `WHERE` clause. |
| `offerId` | `string` Merchant-provided product id. |
| `title` | `string` Title of the product. |
| `grossSales` | ``object (`Price`)`` Gross sales amount, excluding refunds. |
| `netSales` | ``object (`Price`)`` Net sales amount (includes both purchase and refunds). |
| `commissions` | ``object (`Price`)`` Net commission amount (includes both purchase and refunds). |
| `orders` | `string (int64 format)` Number of orders. |
| `productType` | `string` Category in merchant's own product taxonomy. |

## YoutubeProductTaggedStatsView

Fields available for query in `youtubeProductTaggedStatsView` table.

[YouTube product tagged data](https://support.google.com/merchants/answer/14947975) for your account. This data is only available if an account is enrolled in the [YouTube Shopping Affiliate program](https://support.google.com/merchants/answer/14815513).

This view focuses on products a merchant has tagged in YouTube videos, and their subsequent performance in terms of engagement (views, clicks) and sales. In contrast, `YoutubeProductSoldStatsView` focuses exclusively on products that were sold through the affiliate program.

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

| JSON representation |
|---|
| ``` { "date": { object (`Date`) }, "offerId": string, "title": string, "grossSales": { object (`Price`) }, "netSales": { object (`Price`) }, "commissions": { object (`Price`) }, "orders": string, "views": string, "clicks": string, "impressions": string, "conversionRate": number, "taggedVideoCount": string, "taggedCreatorCount": string, "productType": string } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Cannot be present in the `SELECT` clause. Required in the `WHERE` clause. |
| `offerId` | `string` Merchant-provided product ID. |
| `title` | `string` Title of the product. |
| `grossSales` | ``object (`Price`)`` Gross sales amount, excluding refunds. |
| `netSales` | ``object (`Price`)`` Net sales amount (includes both purchase and refunds). |
| `commissions` | ``object (`Price`)`` Net commission amount (includes both purchase and refunds). |
| `orders` | `string (int64 format)` Number of orders. |
| `views` | `string (int64 format)` Number of views. |
| `clicks` | `string (int64 format)` Number of clicks. |
| `impressions` | `string (int64 format)` Number of impressions. |
| `conversionRate` | `number` The conversion rate of the product. |
| `taggedVideoCount` | `string (int64 format)` The number of distinct videos that tagged the product. |
| `taggedCreatorCount` | `string (int64 format)` The number of distinct creators that tagged the product. |
| `productType` | `string` Category in merchant's own product taxonomy. |

## YoutubeCampaignsStatsView

Fields available for query in `youtubeCampaignsStatsView` table.

| JSON representation |
|---|
| ``` { "date": { object (`Date`) }, "startDate": { object (`Date`) }, "endDate": { object (`Date`) }, "campaignId": string, "campaignName": string, "activeCreators": string, "grossSales": { object (`Price`) }, "netSales": { object (`Price`) }, "commissions": { object (`Price`) }, "orders": string, "views": string, "clicks": string, "impressions": string, "conversionRate": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Required in the `WHERE` clause. Cannot be selected. |
| `startDate` | ``object (`Date`)`` The start date of the campaign. |
| `endDate` | ``object (`Date`)`` The end date of the campaign. |
| `campaignId` | `string` The ID of the campaign. |
| `campaignName` | `string` The name of the campaign. |
| `activeCreators` | `string (int64 format)` The number of active creators in the campaign. |
| `grossSales` | ``object (`Price`)`` Gross sales amount, excluding refunds. |
| `netSales` | ``object (`Price`)`` Net sales amount. Includes both purchase and refunds. |
| `commissions` | ``object (`Price`)`` Net commission amount. Includes both purchase and refunds. |
| `orders` | `string (int64 format)` Number of orders. |
| `views` | `string (int64 format)` Number of YouTube views. |
| `clicks` | `string (int64 format)` Number of product clicks. |
| `impressions` | `string (int64 format)` Number of impressions. |
| `conversionRate` | `number` Conversion rate. |

## YoutubeIndividualCampaignStatsView

Fields available for query in `youtubeIndividualCampaignStatsView` table.

| JSON representation |
|---|
| ``` { "date": { object (`Date`) }, "campaignId": string, "channelId": string, "channelTitle": string, "channelAvatarUri": string, "videoCount": string, "shortsCount": string, "storyCount": string, "liveCount": string, "productTitles": string, "grossSales": { object (`Price`) }, "netSales": { object (`Price`) }, "commissions": { object (`Price`) }, "orders": string, "views": string, "clicks": string, "impressions": string, "conversionRate": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Required in the `WHERE` clause. Cannot be selected. |
| `campaignId` | `string` The ID of the campaign. **Condition on `campaignId` is required in the `WHERE` clause.** |
| `channelId` | `string` The ID of the creator channel. |
| `channelTitle` | `string` The title of the creator channel. |
| `channelAvatarUri` | `string` The avatar URI of the creator channel. |
| `videoCount` | `string (int64 format)` Total video count. Includes videos, shorts, live streams, and stories. |
| `shortsCount` | `string (int64 format)` Number of Shorts. |
| `storyCount` | `string (int64 format)` Number of Stories. |
| `liveCount` | `string (int64 format)` Number of Live streams. |
| `productTitles` | `string` A string containing all product titles, separated by newlines ('\\n'). |
| `grossSales` | ``object (`Price`)`` Gross sales amount, excluding refunds. |
| `netSales` | ``object (`Price`)`` Net sales amount includes both purchase and refunds. |
| `commissions` | ``object (`Price`)`` Net commission amount includes both purchase and refunds. |
| `orders` | `string (int64 format)` Number of orders. |
| `views` | `string (int64 format)` Number of YouTube views. |
| `clicks` | `string (int64 format)` Number of product clicks. |
| `impressions` | `string (int64 format)` Number of impressions. |
| `conversionRate` | `number` Conversion rate. |

## YoutubeCampaignVideosStatsView

Fields available for query in `youtubeCampaignVideosStatsView` table.

| JSON representation |
|---|
| ``` { "date": { object (`Date`) }, "campaignId": string, "channelId": string, "videoId": string, "videoTitle": string, "productTitles": string, "contentType": enum (`ContentType`), "grossSales": { object (`Price`) }, "netSales": { object (`Price`) }, "commissions": { object (`Price`) }, "orders": string, "views": string, "clicks": string, "impressions": string, "conversionRate": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Required in the `WHERE` clause. Cannot be selected. |
| `campaignId` | `string` The ID of the campaign. Required filter in `WHERE` clause. |
| `channelId` | `string` The ID of the creator channel. Required filter in `WHERE` clause. |
| `videoId` | `string` The ID of the video. |
| `videoTitle` | `string` The title of the video. |
| `productTitles` | `string` Set of unique [product titles](https://support.google.com/merchants/answer/188494#id) tagged in the video. |
| `contentType` | ``enum (`ContentType`)`` Video format (e.g. video, shorts, live stream). |
| `grossSales` | ``object (`Price`)`` Gross sales amount, excluding refunds. |
| `netSales` | ``object (`Price`)`` Net sales amount includes both purchase and refunds. |
| `commissions` | ``object (`Price`)`` Net commission amount includes both purchase and refunds. |
| `orders` | `string (int64 format)` Number of orders. |
| `views` | `string (int64 format)` Number of YouTube views. |
| `clicks` | `string (int64 format)` Number of product clicks. |
| `impressions` | `string (int64 format)` Number of impressions. |
| `conversionRate` | `number` Conversion rate. |

## YoutubeCampaignProductsStatsView

Fields available for query in `youtubeCampaignProductsStatsView` table.

| JSON representation |
|---|
| ``` { "date": { object (`Date`) }, "grossSales": { object (`Price`) }, "netSales": { object (`Price`) }, "commissions": { object (`Price`) }, "campaignId": string, "channelTitle": string, "videoId": string, "videoUrl": string, "videoTitle": string, "productTitle": string, "contentType": enum (`ContentType`), "orders": string, "views": string, "clicks": string, "impressions": string, "conversionRate": number } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Required. Date in the Merchant Center account timezone to which metrics apply. Segment. Required in the `WHERE` clause. Cannot be selected. |
| `grossSales` | ``object (`Price`)`` Optional. Gross sales amount, excluding refunds. |
| `netSales` | ``object (`Price`)`` Optional. Net sales amount includes both purchases and refunds. |
| `commissions` | ``object (`Price`)`` Optional. Net commission amount includes both purchases and refunds. |
| `campaignId` | `string` Required. The id of the campaign. Required filter in `WHERE` clause. |
| `channelTitle` | `string` Optional. The title of the creator channel. |
| `videoId` | `string` Optional. The id of the video. |
| `videoUrl` | `string` Optional. The URL of the video. |
| `videoTitle` | `string` Optional. The title of the video. |
| `productTitle` | `string` Optional. The title of the product. |
| `contentType` | ``enum (`ContentType`)`` Optional. The format of the video. |
| `orders` | `string (int64 format)` Optional. Number of orders. |
| `views` | `string (int64 format)` Optional. Number of YouTube views. |
| `clicks` | `string (int64 format)` Optional. Number of product clicks. |
| `impressions` | `string (int64 format)` Optional. Number of impressions. |
| `conversionRate` | `number` Optional. Conversion rate. |

## UcpAgenticPerformanceView

Fields available for query in `ucpAgenticPerformanceView` table.

Funnel performance data for your Universal Commerce Protocol (UCP) integration, including metrics (for example, `buyButtonClicks`) and dimensions according to which the metrics are segmented (for example, `customerCountryCode`).

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.

For more information about how to Monitor and optimize your UCP integration, see [Monitor and optimize your integration](https://developers.google.com/merchant/ucp/guides/tools/merchant-center/analytics).

| JSON representation |
|---|
| ``` { "date": { object (`Date`) }, "accountId": string, "customerCountryCode": string, "buyButtonClicks": string, "accountsLinked": string, "accountLinkingAttempts": string, "accountLinkingRate": number, "purchaseCount": string, "purchaseValue": { object (`Price`) }, "averageOrderValue": { object (`Price`) }, "cancellations": string, "averagePurchaseProductCount": number, "averagePurchaseProductValue": { object (`Price`) }, "cartTransfers": string, "averageCartValue": { object (`Price`) }, "averageCartProductCount": number, "averageCartProductValue": { object (`Price`) } } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Date in the merchant timezone to which metrics apply. Segment. Condition on `date` is required in the `WHERE` clause. |
| `accountId` | `string (int64 format)` Leaf Merchant Center ID to which metrics apply. Unique (primary key) in the table. 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. |
| `buyButtonClicks` | `string (int64 format)` Number of buy button clicks performed directly from Google. Equivalent to Buy Button Clicks in UCP Analytics in Merchant Center. Metric. |
| `accountsLinked` | `string (int64 format)` Number of times a customer successfully linked their Google account to their merchant account. Equivalent to Accounts Linked in UCP Analytics in Merchant Center. Metric. |
| `accountLinkingAttempts` | `string (int64 format)` Number of times a customer attempted to link their Google account to their merchant account. Equivalent to Account Linking Attempts under Account Linking in UCP Analytics in Merchant Center. Metric. |
| `accountLinkingRate` | `number` Percentage of times a customer successfully linked their Google account to their merchant account. Equivalent to Account Linking Rate under Account Linking in UCP Analytics in Merchant Center. Metric. |
| `purchaseCount` | `string (int64 format)` Number of fully completed purchases performed directly from Google. Equivalent to Purchase Count in UCP Analytics in Merchant Center. Metric. |
| `purchaseValue` | ``object (`Price`)`` Value of fully completed purchases performed directly from Google. Metric. |
| `averageOrderValue` | ``object (`Price`)`` Average amount spent on a single order, excluding cancellations and refunds. A single order may contain the purchase of multiple products. Equivalent to Average Order Value in UCP Analytics in Merchant Center. Metric. |
| `cancellations` | `string (int64 format)` Number of times either a merchant or a customer cancelled an order. Equivalent to Cancellations in UCP Analytics in Merchant Center. Metric. |
| `averagePurchaseProductCount` | `number` Average number of products in an order. Equivalent to Average Product Count under Native Checkout in UCP Analytics in Merchant Center. Metric. |
| `averagePurchaseProductValue` | ``object (`Price`)`` Average value of the products in an order. Equivalent to Average Product Value under Native Checkout in UCP Analytics in Merchant Center. Metric. |
| `cartTransfers` | `string (int64 format)` Number of times a user transfers the cart to checkout on the merchant's website. Equivalent to Cart Transfers in UCP Analytics in Merchant Center. Metric. |
| `averageCartValue` | ``object (`Price`)`` Average value of the cart at the time of transfer to merchant's website. Equivalent to Average Cart Value in UCP Analytics in Merchant Center. Metric. |
| `averageCartProductCount` | `number` Average number of products in the cart at the time of transfer to merchant's website. Equivalent to Average Product Count under Transfers to Merchant Cart in UCP Analytics in Merchant Center. Metric. |
| `averageCartProductValue` | ``object (`Price`)`` Average product value in the cart at the time of transfer to merchant's website. Equivalent to Average Product Value under Transfers to Merchant Cart in UCP Analytics in Merchant Center. Metric. |

## UcpAgenticProductPerformanceView

Fields available for query in `ucpAgenticProductPerformanceView` table.

Product performance data for your UCP integration, including metrics (for example, `purchases`) and dimensions according to which the metrics are segmented (for example, `offerId`, `customerCountryCode`).

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.

For more information about how to Monitor and optimize your UCP integration, see [Monitor and optimize your integration](https://developers.google.com/merchant/ucp/guides/tools/merchant-center/analytics).

| JSON representation |
|---|
| ``` { "date": { object (`Date`) }, "accountId": string, "customerCountryCode": string, "offerId": string, "title": string, "buyButtonClicks": string } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Date in the merchant timezone to which metrics apply. Segment. Cannot be selected in the `SELECT` clause. Condition on `date` is required in the `WHERE` clause. |
| `accountId` | `string (int64 format)` Leaf Merchant Center ID 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. |
| `offerId` | `string` Merchant-provided ID of the product. Unique (primary key) in the table. Segment. |
| `title` | `string` Title of the product. Equivalent to Product under Most popular UCP products in UCP Analytics in Merchant Center. Segment. |
| `buyButtonClicks` | `string (int64 format)` Number of buy button clicks performed directly from Google. Equivalent to Buy Button Clicks under Most popular UCP products in UCP Analytics in Merchant Center. Metric. |

## YoutubeProductCategoryTaggedStatsView

Fields available for query in `youtubeProductCategoryTaggedStatsView` table.

[YouTube product category tagged data](https://support.google.com/merchants/answer/14947975) for your account. This data is only available if an account is enrolled in the [YouTube Shopping Affiliate program](https://support.google.com/merchants/answer/14815513).

Values are populated only for fields explicitly requested in the query.

| JSON representation |
|---|
| ``` { "date": { object (`Date`) }, "productType": string, "grossSales": { object (`Price`) }, "netSales": { object (`Price`) }, "commissions": { object (`Price`) }, "orders": string, "views": string, "clicks": string, "impressions": string, "conversionRate": number, "taggedVideoCount": string, "taggedCreatorCount": string } ``` |

| Fields ||
|---|---|
| `date` | ``object (`Date`)`` Date in the Merchant Center account timezone to which metrics apply. Segment. Cannot be present in the `SELECT` clause. Required in the `WHERE` clause. |
| `productType` | `string` Category in merchant's own product taxonomy. |
| `grossSales` | ``object (`Price`)`` Gross sales amount, excluding refunds. |
| `netSales` | ``object (`Price`)`` Net sales amount (includes both purchase and refunds). |
| `commissions` | ``object (`Price`)`` Net commission amount (includes both purchase and refunds). |
| `orders` | `string (int64 format)` Number of orders. |
| `views` | `string (int64 format)` Number of views. |
| `clicks` | `string (int64 format)` Number of clicks. |
| `impressions` | `string (int64 format)` Number of impressions. |
| `conversionRate` | `number` Conversion rate of the product category. |
| `taggedVideoCount` | `string (int64 format)` Number of distinct videos that tagged products in this category. |
| `taggedCreatorCount` | `string (int64 format)` Number of distinct creators that tagged products in this category. |

| ## Methods ||
|---|---|
| ### `search` | Retrieves a report defined by a search query. |