@maxim_mazurok/gapi.client.merchantapi-reports_v1 0.0.20250804

package/index.d.ts

@@ -0,0 +1,537 @@
+/* Type definitions for non-npm package Merchant API reports_v1 0.0 */
+// Project: https://developers.google.com/merchant/api
+// Definitions by: Maxim Mazurok <https://github.com/Maxim-Mazurok>
+//                 Nick Amoscato <https://github.com/namoscato>
+//                 Declan Vong <https://github.com/declanvong>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+// IMPORTANT
+// This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
+// In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
+// Generated from: https://merchantapi.googleapis.com/$discovery/rest?version=reports_v1
+// Revision: 20250804
+
+/// <reference types="gapi.client" />
+
+declare namespace gapi.client {
+  /** Load Merchant API reports_v1 */
+  function load(
+    urlOrObject: 'https://merchantapi.googleapis.com/$discovery/rest?version=reports_v1',
+  ): Promise<void>;
+  /** @deprecated Please load APIs with discovery documents. */
+  function load(name: 'merchantapi', version: 'reports_v1'): Promise<void>;
+  /** @deprecated Please load APIs with discovery documents. */
+  function load(
+    name: 'merchantapi',
+    version: 'reports_v1',
+    callback: () => any,
+  ): void;
+
+  namespace merchantapi {
+    interface BestSellersBrandView {
+      /** Name of the brand. */
+      brand?: string;
+      /** Popularity rank in the previous week or month. */
+      previousRank?: string;
+      /** Estimated demand in relation to the brand with the highest popularity rank in the same category and country in the previous week or month. */
+      previousRelativeDemand?: string;
+      /** Popularity of the brand on Ads and organic surfaces, in the selected category and country, based on the estimated number of units sold. */
+      rank?: string;
+      /** Estimated demand in relation to the brand with the highest popularity rank in the same category and country. */
+      relativeDemand?: string;
+      /** Change in the estimated demand. Whether it rose, sank or remained flat. */
+      relativeDemandChange?: string;
+      /** 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 `report_category_id` is not specified in the query, rankings for all top-level categories are returned. */
+      reportCategoryId?: string;
+      /** Country where the ranking is calculated. Represented in the ISO 3166 format. Required in the `SELECT` clause. Condition on `report_country_code` is required in the `WHERE` clause. */
+      reportCountryCode?: string;
+      /** 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 `report_date` is not specified in the query, the latest available weekly or monthly report is returned. */
+      reportDate?: Date;
+      /** Granularity of the report. The ranking can be done over a week or a month timeframe. Required in the `SELECT` clause. Condition on `report_granularity` is required in the `WHERE` clause. */
+      reportGranularity?: string;
+    }
+    interface BestSellersProductClusterView {
+      /** Brand of the product cluster. */
+      brand?: string;
+      /** 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. */
+      brandInventoryStatus?: string;
+      /** Product category (1st level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL1?: string;
+      /** Product category (2nd level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL2?: string;
+      /** Product category (3rd level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL3?: string;
+      /** Product category (4th level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL4?: string;
+      /** Product category (5th level) of the product cluster, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL5?: string;
+      /** 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. */
+      inventoryStatus?: string;
+      /** Popularity rank in the previous week or month. */
+      previousRank?: string;
+      /** 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. */
+      previousRelativeDemand?: string;
+      /** Popularity of the product cluster on Ads and organic surfaces, in the selected category and country, based on the estimated number of units sold. */
+      rank?: string;
+      /** Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country. */
+      relativeDemand?: string;
+      /** Change in the estimated demand. Whether it rose, sank or remained flat. */
+      relativeDemandChange?: string;
+      /** 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 `report_category_id` is not specified in the query, rankings for all top-level categories are returned. */
+      reportCategoryId?: string;
+      /** Country where the ranking is calculated. Represented in the ISO 3166 format. Required in the `SELECT` clause. Condition on `report_country_code` is required in the `WHERE` clause. */
+      reportCountryCode?: string;
+      /** 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 `report_date` is not specified in the query, the latest available weekly or monthly report is returned. */
+      reportDate?: Date;
+      /** Granularity of the report. The ranking can be done over a week or a month timeframe. Required in the `SELECT` clause. Condition on `report_granularity` is required in the `WHERE` clause. */
+      reportGranularity?: string;
+      /** Title of the product cluster. */
+      title?: string;
+      /** GTINs of example variants of the product cluster. */
+      variantGtins?: string[];
+    }
+    interface CompetitiveVisibilityBenchmarkView {
+      /** 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. */
+      categoryBenchmarkVisibilityTrend?: number;
+      /** Date of this row. Required in the `SELECT` clause. A condition on `date` is required in the `WHERE` clause. */
+      date?: Date;
+      /** 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 `report_category_id` is required in the `WHERE` clause. */
+      reportCategoryId?: string;
+      /** Country where impressions appeared. Required in the `SELECT` clause. A condition on `report_country_code` is required in the `WHERE` clause. */
+      reportCountryCode?: string;
+      /** Traffic source of impressions. Required in the `SELECT` clause. */
+      trafficSource?: string;
+      /** 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. */
+      yourDomainVisibilityTrend?: number;
+    }
+    interface CompetitiveVisibilityCompetitorView {
+      /** [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. */
+      adsOrganicRatio?: number;
+      /** Date of this row. A condition on `date` is required in the `WHERE` clause. */
+      date?: Date;
+      /** Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause. */
+      domain?: string;
+      /** [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. */
+      higherPositionRate?: number;
+      /** True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause. */
+      isYourDomain?: boolean;
+      /** [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. */
+      pageOverlapRate?: number;
+      /** Position of the domain in the similar businesses ranking for the selected keys (`date`, `report_category_id`, `report_country_code`, `traffic_source`) based on impressions. 1 is the highest. Cannot be filtered on in the 'WHERE' clause. */
+      rank?: string;
+      /** [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. */
+      relativeVisibility?: number;
+      /** 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 `report_category_id` is required in the `WHERE` clause. */
+      reportCategoryId?: string;
+      /** Country where impressions appeared. Required in the `SELECT` clause. A condition on `report_country_code` is required in the `WHERE` clause. */
+      reportCountryCode?: string;
+      /** Traffic source of impressions. Required in the `SELECT` clause. */
+      trafficSource?: string;
+    }
+    interface CompetitiveVisibilityTopMerchantView {
+      /** [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. */
+      adsOrganicRatio?: number;
+      /** Date of this row. Cannot be selected in the `SELECT` clause. A condition on `date` is required in the `WHERE` clause. */
+      date?: Date;
+      /** Domain of your competitor or your domain, if 'is_your_domain' is true. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause. */
+      domain?: string;
+      /** [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. */
+      higherPositionRate?: number;
+      /** True if this row contains data for your domain. Cannot be filtered on in the 'WHERE' clause. */
+      isYourDomain?: boolean;
+      /** [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. */
+      pageOverlapRate?: number;
+      /** Position of the domain in the top merchants ranking for the selected keys (`date`, `report_category_id`, `report_country_code`, `traffic_source`) based on impressions. 1 is the highest. Cannot be filtered on in the 'WHERE' clause. */
+      rank?: string;
+      /** 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 `report_category_id` is required in the `WHERE` clause. */
+      reportCategoryId?: string;
+      /** Country where impressions appeared. Required in the `SELECT` clause. A condition on `report_country_code` is required in the `WHERE` clause. */
+      reportCountryCode?: string;
+      /** Traffic source of impressions. Required in the `SELECT` clause. */
+      trafficSource?: string;
+    }
+    interface Date {
+      /** Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. */
+      day?: number;
+      /** Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. */
+      month?: number;
+      /** Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. */
+      year?: number;
+    }
+    interface IssueSeverityPerReportingContext {
+      /** List of demoted countries in the reporting context, represented in ISO 3166 format. */
+      demotedCountries?: string[];
+      /** List of disapproved countries in the reporting context, represented in ISO 3166 format. */
+      disapprovedCountries?: string[];
+      /** Reporting context the issue applies to. */
+      reportingContext?: string;
+    }
+    interface ItemIssue {
+      /** Item issue resolution. */
+      resolution?: string;
+      /** Item issue severity. */
+      severity?: ItemIssueSeverity;
+      /** Item issue type. */
+      type?: ItemIssueType;
+    }
+    interface ItemIssueSeverity {
+      /** Aggregated severity of the issue for all reporting contexts it affects. **This field can be used for filtering the results.** */
+      aggregatedSeverity?: string;
+      /** Issue severity per reporting context. */
+      severityPerReportingContext?: IssueSeverityPerReportingContext[];
+    }
+    interface ItemIssueType {
+      /** Canonical attribute name for attribute-specific issues. */
+      canonicalAttribute?: string;
+      /** Error code of the issue, equivalent to the `code` of [Product issues](https://developers.google.com/shopping-content/guides/product-issues). */
+      code?: string;
+    }
+    interface NonProductPerformanceView {
+      /** Number of clicks on images and online store links leading to your non-product pages. Metric. */
+      clicks?: string;
+      /** 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. */
+      clickThroughRate?: number;
+      /** Date in the merchant timezone to which metrics apply. Segment. Condition on `date` is required in the `WHERE` clause. */
+      date?: Date;
+      /** Number of times images and online store links leading to your non-product pages were shown. Metric. */
+      impressions?: string;
+      /** First day of the week (Monday) of the metrics date in the merchant timezone. Segment. */
+      week?: Date;
+    }
+    interface Price {
+      /** The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). */
+      amountMicros?: string;
+      /** The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). */
+      currencyCode?: string;
+    }
+    interface PriceCompetitivenessProductView {
+      /** Latest available price benchmark for the product's catalog in the benchmark country. */
+      benchmarkPrice?: Price;
+      /** Brand of the product. */
+      brand?: string;
+      /** Product category (1st level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL1?: string;
+      /** Product category (2nd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL2?: string;
+      /** Product category (3rd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL3?: string;
+      /** Product category (4th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL4?: string;
+      /** Product category (5th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL5?: string;
+      /** REST ID of the product, in the form of `channel~languageCode~feedLabel~offerId`. Can be used to join data with the `product_view` table. Required in the `SELECT` clause. */
+      id?: string;
+      /** Merchant-provided id of the product. */
+      offerId?: string;
+      /** Current price of the product. */
+      price?: Price;
+      /** Product type (1st level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL1?: string;
+      /** Product type (2nd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL2?: string;
+      /** Product type (3rd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL3?: string;
+      /** Product type (4th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL4?: string;
+      /** Product type (5th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL5?: string;
+      /** Country of the price benchmark. Represented in the ISO 3166 format. Required in the `SELECT` clause. */
+      reportCountryCode?: string;
+      /** Title of the product. */
+      title?: string;
+    }
+    interface PriceInsightsProductView {
+      /** Brand of the product. */
+      brand?: string;
+      /** Product category (1st level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL1?: string;
+      /** Product category (2nd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL2?: string;
+      /** Product category (3rd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL3?: string;
+      /** Product category (4th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL4?: string;
+      /** Product category (5th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL5?: string;
+      /** The predicted effectiveness of applying the price suggestion, bucketed. */
+      effectiveness?: string;
+      /** REST ID of the product, in the form of `channel~languageCode~feedLabel~offerId`. Can be used to join data with the `product_view` table. Required in the `SELECT` clause. */
+      id?: string;
+      /** Merchant-provided id of the product. */
+      offerId?: string;
+      /** 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. */
+      predictedClicksChangeFraction?: 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). */
+      predictedConversionsChangeFraction?: 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. */
+      predictedImpressionsChangeFraction?: number;
+      /** Current price of the product. */
+      price?: Price;
+      /** Product type (1st level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL1?: string;
+      /** Product type (2nd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL2?: string;
+      /** Product type (3rd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL3?: string;
+      /** Product type (4th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL4?: string;
+      /** Product type (5th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL5?: string;
+      /** Latest suggested price for the product. */
+      suggestedPrice?: Price;
+      /** Title of the product. */
+      title?: string;
+    }
+    interface ProductChange {
+      /** The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``) */
+      newValue?: string;
+      /** The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``) */
+      oldValue?: string;
+      /** Countries that have the change (if applicable). Represented in the ISO 3166 format. */
+      regionCode?: string;
+      /** Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum) */
+      reportingContext?: string;
+    }
+    interface ProductPerformanceView {
+      /** Brand of the product. Segment. */
+      brand?: string;
+      /** [Product category (1st level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment. */
+      categoryL1?: string;
+      /** [Product category (2nd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment. */
+      categoryL2?: string;
+      /** [Product category (3rd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment. */
+      categoryL3?: string;
+      /** [Product category (4th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment. */
+      categoryL4?: string;
+      /** [Product category (5th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy. Segment. */
+      categoryL5?: string;
+      /** Number of clicks. Metric. */
+      clicks?: string;
+      /** Click-through rate - the number of clicks merchant's products receive (clicks) divided by the number of times the products are shown (impressions). Metric. */
+      clickThroughRate?: number;
+      /** Number of conversions divided by the number of clicks, reported on the impression date. Metric. Available only for the `FREE` traffic source. */
+      conversionRate?: 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. */
+      conversions?: number;
+      /** Value of conversions attributed to the product, reported on the conversion date. Metric. Available only for the `FREE` traffic source. */
+      conversionValue?: Price;
+      /** 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. */
+      customerCountryCode?: string;
+      /** Custom label 0 for custom grouping of products. Segment. */
+      customLabel0?: string;
+      /** Custom label 1 for custom grouping of products. Segment. */
+      customLabel1?: string;
+      /** Custom label 2 for custom grouping of products. Segment. */
+      customLabel2?: string;
+      /** Custom label 3 for custom grouping of products. Segment. */
+      customLabel3?: string;
+      /** Custom label 4 for custom grouping of products. Segment. */
+      customLabel4?: string;
+      /** Date in the merchant timezone to which metrics apply. Segment. Condition on `date` is required in the `WHERE` clause. */
+      date?: Date;
+      /** Number of times merchant's products are shown. Metric. */
+      impressions?: string;
+      /** Marketing method to which metrics apply. Segment. */
+      marketingMethod?: string;
+      /** Merchant-provided id of the product. Segment. */
+      offerId?: 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. */
+      productTypeL1?: 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. */
+      productTypeL2?: 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. */
+      productTypeL3?: 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. */
+      productTypeL4?: 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. */
+      productTypeL5?: string;
+      /** Title of the product. Segment. */
+      title?: string;
+      /** First day of the week (Monday) of the metrics date in the merchant timezone. Segment. */
+      week?: Date;
+    }
+    interface ProductStatusChangeMessage {
+      /** The target account that owns the entity that changed. Format : `accounts/{merchant_id}` */
+      account?: string;
+      /** The attribute in the resource that changed, in this case it will be always `Status`. */
+      attribute?: string;
+      /** A message to describe the change that happened to the product */
+      changes?: ProductChange[];
+      /** The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications. */
+      eventTime?: string;
+      /** Optional. The product expiration time. This field will not be set if the notification is sent for a product deletion event. */
+      expirationTime?: string;
+      /** The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id}` */
+      managingAccount?: string;
+      /** The product name. Format: `accounts/{account}/products/{product}` */
+      resource?: string;
+      /** The product id. */
+      resourceId?: string;
+      /** The resource that changed, in this case it will always be `Product`. */
+      resourceType?: string;
+    }
+    interface ProductView {
+      /** Aggregated status. */
+      aggregatedReportingContextStatus?: string;
+      /** [Availability](https://support.google.com/merchants/answer/6324448) of the product. */
+      availability?: string;
+      /** Brand of the product. */
+      brand?: string;
+      /** Product category (1st level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL1?: string;
+      /** Product category (2nd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL2?: string;
+      /** Product category (3rd level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL3?: string;
+      /** Product category (4th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL4?: string;
+      /** Product category (5th level) in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). */
+      categoryL5?: string;
+      /** Channel of the product. Can be `ONLINE` or `LOCAL`. */
+      channel?: string;
+      /** Estimated performance potential compared to highest performing products of the merchant. */
+      clickPotential?: string;
+      /** Rank of the product based on its click potential. A product with `click_potential_rank` 1 has the highest click potential among the merchant's products that fulfill the search query conditions. */
+      clickPotentialRank?: string;
+      /** [Condition](https://support.google.com/merchants/answer/6324469) of the product. */
+      condition?: string;
+      /** The time the merchant created the product in timestamp seconds. */
+      creationTime?: string;
+      /** Expiration date for the product, specified on insertion. */
+      expirationDate?: Date;
+      /** Feed label of the product. */
+      feedLabel?: string;
+      /** List of Global Trade Item Numbers (GTINs) of the product. */
+      gtin?: 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. */
+      id?: string;
+      /** Item group id provided by the merchant for grouping variants together. */
+      itemGroupId?: string;
+      /** List of item issues for the product. **This field cannot be used for sorting the results.** **Only selected attributes of this field (for example, `item_issues.severity.aggregated_severity`) can be used for filtering the results.** */
+      itemIssues?: ItemIssue[];
+      /** Language code of the product in BCP 47 format. */
+      languageCode?: string;
+      /** Merchant-provided id of the product. */
+      offerId?: string;
+      /** Product price. Absent if the information about the price of the product is not available. */
+      price?: Price;
+      /** Product type (1st level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL1?: string;
+      /** Product type (2nd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL2?: string;
+      /** Product type (3rd level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL3?: string;
+      /** Product type (4th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL4?: string;
+      /** Product type (5th level) in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324406). */
+      productTypeL5?: string;
+      /** Normalized [shipping label](https://support.google.com/merchants/answer/6324504) specified in the data source. */
+      shippingLabel?: string;
+      /** Link to the processed image of the product, hosted on the Google infrastructure. */
+      thumbnailLink?: string;
+      /** Title of the product. */
+      title?: string;
+    }
+    interface ReportRow {
+      /** Fields available for query in `best_sellers_brand_view` table. */
+      bestSellersBrandView?: BestSellersBrandView;
+      /** Fields available for query in `best_sellers_product_cluster_view` table. */
+      bestSellersProductClusterView?: BestSellersProductClusterView;
+      /** Fields available for query in `competitive_visibility_benchmark_view` table. */
+      competitiveVisibilityBenchmarkView?: CompetitiveVisibilityBenchmarkView;
+      /** Fields available for query in `competitive_visibility_competitor_view` table. */
+      competitiveVisibilityCompetitorView?: CompetitiveVisibilityCompetitorView;
+      /** Fields available for query in `competitive_visibility_top_merchant_view` table. */
+      competitiveVisibilityTopMerchantView?: CompetitiveVisibilityTopMerchantView;
+      /** Fields available for query in `non_product_performance_view` table. */
+      nonProductPerformanceView?: NonProductPerformanceView;
+      /** Fields available for query in `price_competitiveness_product_view` table. */
+      priceCompetitivenessProductView?: PriceCompetitivenessProductView;
+      /** Fields available for query in `price_insights_product_view` table. */
+      priceInsightsProductView?: PriceInsightsProductView;
+      /** Fields available for query in `product_performance_view` table. */
+      productPerformanceView?: ProductPerformanceView;
+      /** Fields available for query in `product_view` table. */
+      productView?: ProductView;
+    }
+    interface SearchRequest {
+      /** Optional. Number of `ReportRows` to retrieve in a single page. Defaults to 1000. Values above 5000 are coerced to 5000. */
+      pageSize?: number;
+      /** Optional. Token of the page to retrieve. If not specified, the first page of results is returned. In order to request the next page of results, the value obtained from `next_page_token` in the previous response should be used. */
+      pageToken?: string;
+      /** Required. Query that defines a report to be retrieved. For details on how to construct your query, see the [Query Language guide](/merchant/api/guides/reports/query-language). For the full list of available tables and fields, see the [Available fields](/merchant/api/reference/rest/reports_v1beta/accounts.reports). */
+      query?: string;
+    }
+    interface SearchResponse {
+      /** Token which can be sent as `page_token` to retrieve the next page. If omitted, there are no subsequent pages. */
+      nextPageToken?: string;
+      /** Rows that matched the search query. */
+      results?: ReportRow[];
+    }
+    interface ReportsResource {
+      /** Retrieves a report defined by a search query. The response might contain fewer rows than specified by `page_size`. Rely on `next_page_token` to determine if there are more rows to be requested. */
+      search(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Required. Id of the account making the call. Must be a standalone account or an MCA subaccount. Format: accounts/{account} */
+        parent: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: SearchRequest;
+      }): Request<SearchResponse>;
+      search(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Required. Id of the account making the call. Must be a standalone account or an MCA subaccount. Format: accounts/{account} */
+          parent: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: SearchRequest,
+      ): Request<SearchResponse>;
+    }
+    interface AccountsResource {
+      reports: ReportsResource;
+    }
+
+    const accounts: AccountsResource;
+  }
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@maxim_mazurok/gapi.client.merchantapi-reports_v1",
+  "version": "0.0.20250804",
+  "description": "TypeScript typings for Merchant API reports_v1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Maxim-Mazurok/google-api-typings-generator.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Maxim Mazurok",
+    "email": "maxim@mazurok.com",
+    "url": "https://maxim.mazurok.com"
+  },
+  "types": "index.d.ts",
+  "dependencies": {
+    "@types/gapi.client": "*",
+    "@types/gapi.client.discovery-v1": "*"
+  }
+}

package/readme.md

@@ -0,0 +1,73 @@
+# TypeScript typings for Merchant API reports_v1
+
+Programmatically manage your Merchant Center Accounts.
+For detailed description please check [documentation](https://developers.google.com/merchant/api).
+
+## Installing
+
+Install typings for Merchant API:
+
+```
+npm install @types/gapi.client.merchantapi-reports_v1 --save-dev
+```
+
+## Usage
+
+You need to initialize Google API client in your code:
+
+```typescript
+gapi.load('client', () => {
+  // now we can use gapi.client
+  // ...
+});
+```
+
+Then load api client wrapper:
+
+```typescript
+gapi.client.load(
+  'https://merchantapi.googleapis.com/$discovery/rest?version=reports_v1',
+  () => {
+    // now we can use:
+    // gapi.client.merchantapi
+  },
+);
+```
+
+```typescript
+// Deprecated, use discovery document URL, see https://github.com/google/google-api-javascript-client/blob/master/docs/reference.md#----gapiclientloadname----version----callback--
+gapi.client.load('merchantapi', 'reports_v1', () => {
+  // now we can use:
+  // gapi.client.merchantapi
+});
+```
+
+Don't forget to authenticate your client before sending any request to resources:
+
+```typescript
+// declare client_id registered in Google Developers Console
+var client_id = '',
+  scope = [
+    // Manage your product listings and accounts for Google Shopping
+    'https://www.googleapis.com/auth/content',
+  ],
+  immediate = true;
+// ...
+
+gapi.auth.authorize(
+  {client_id: client_id, scope: scope, immediate: immediate},
+  authResult => {
+    if (authResult && !authResult.error) {
+      /* handle successful authorization */
+    } else {
+      /* handle authorization error */
+    }
+  },
+);
+```
+
+After that you can use Merchant API resources: <!-- TODO: make this work for multiple namespaces -->
+
+```typescript
+
+```