此页面由 Cloud Translation API 翻译。

Package google.shopping.merchant.reports.v1beta

索引

ReportService（接口）
BestSellersBrandView（消息）
BestSellersProductClusterView（消息）
BestSellersProductClusterView.InventoryStatus（枚举）
CompetitiveVisibilityBenchmarkView（消息）
CompetitiveVisibilityCompetitorView（消息）
CompetitiveVisibilityTopMerchantView（消息）
MarketingMethod（消息）
MarketingMethod.MarketingMethodEnum（枚举）
NonProductPerformanceView（消息）
PriceCompetitivenessProductView（消息）
PriceInsightsProductView（消息）
PriceInsightsProductView.Effectiveness（枚举）
ProductPerformanceView（消息）
ProductView（消息）
ProductView.AggregatedReportingContextStatus（枚举）
ProductView.ClickPotential（枚举）
ProductView.ItemIssue（消息）
ProductView.ItemIssue.ItemIssueResolution（枚举）
ProductView.ItemIssue.ItemIssueSeverity（消息）
ProductView.ItemIssue.ItemIssueSeverity.AggregatedIssueSeverity（枚举）
ProductView.ItemIssue.ItemIssueSeverity.IssueSeverityPerReportingContext（消息）
ProductView.ItemIssue.ItemIssueType（消息）
RelativeDemand（消息）
RelativeDemand.RelativeDemandEnum（枚举）
RelativeDemandChangeType（消息）
RelativeDemandChangeType.RelativeDemandChangeTypeEnum（枚举）
ReportGranularity（消息）
ReportGranularity.ReportGranularityEnum（枚举）
ReportRow（消息）
SearchRequest（消息）
SearchResponse（消息）
TrafficSource（消息）
TrafficSource.TrafficSourceEnum（枚举）

ReportService

用于检索有关商品、其表现和 Google 上的竞争环境的报告和数据分析的服务。

搜索

搜索
`rpc Search(SearchRequest) returns (SearchResponse)` 检索由搜索查询定义的报告。响应中包含的行数可能少于 `page_size` 指定的行数。依赖 `next_page_token` 来确定是否有更多行要请求。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/content` 如需了解详情，请参阅 OAuth 2.0 Overview。

rpc Search(SearchRequest) returns (SearchResponse)

检索由搜索查询定义的报告。响应中包含的行数可能少于 page_size 指定的行数。依赖 next_page_token 来确定是否有更多行要请求。

授权范围

需要以下 OAuth 范围：

https://www.googleapis.com/auth/content

如需了解详情，请参阅 OAuth 2.0 Overview。

BestSellersBrandView

best_sellers_brand_view 表中可供查询的字段。

畅销商品报告，其中包含热门品牌。

系统仅为请求的搜索查询中明确请求的字段设置值。

字段
`report_date`	`Date` 报告日期。此字段的值只能是以下值之一：每周报告的第一天（星期一），每月报告的开始日期（即当月第一天）。 `SELECT` 子句中必需的。如果查询中未指定对 `report_date` 的 `WHERE` 条件，则会返回最新的可用周报或月报。
`report_granularity`	`ReportGranularityEnum` 报告的粒度。排名可以按一周或一个月的时间范围进行。 `SELECT` 子句中必需的。`WHERE` 子句中必须包含对 `report_granularity` 的条件。
`report_country_code`	`string` 计算排名时所采用的国家/地区。采用 ISO 3166 格式表示。 `SELECT` 子句中必需的。`WHERE` 子句中必须包含对 `report_country_code` 的条件。
`report_category_id`	`int64` 用于计算排名的 Google 商品类别 ID，以 Google 商品类目中的表示法表示。 `SELECT` 子句中必需的。如果查询中未指定对 `report_category_id` 的 `WHERE` 条件，则系统会返回所有顶级类别的排名。
`brand`	`string` 品牌名称。
`rank`	`int64` 在选定的类别和国家/地区中，品牌在广告和自然途径中的热门程度（以品牌售出的估算单位数量为准）。
`previous_rank`	`int64` 前一周或前一个月的热门程度排名。
`relative_demand`	`RelativeDemandEnum` 相对于同一类别和国家/地区中热门程度排名最高的品牌的预计需求量。
`previous_relative_demand`	`RelativeDemandEnum` 与同一类别和国家/地区中热门程度排名最高的品牌相比，品牌的预计需求量。
`relative_demand_change`	`RelativeDemandChangeTypeEnum` 预计需求的变化。是上涨、下跌还是持平。

BestSellersProductClusterView

best_sellers_product_cluster_view 表中可供查询的字段。

畅销商品报告，其中包含热门商品集合。商品集群是指代表同一商品（例如 Google Pixel 7）的不同商品和款式/规格的分组。

系统只会为请求的搜索查询中明确请求的字段设置值。

字段
`report_date`	`Date` 报告日期。此字段的值只能是以下值之一：每周报告的第一天（星期一），每月报告的开始日期（即当月第一天）。 `SELECT` 子句中必需的。如果查询中未指定对 `report_date` 的 `WHERE` 条件，则会返回最新的可用周报或月报。
`variant_gtins[]`	`string` 商品集合示例款式/规格的 GTIN。
`report_granularity`	`ReportGranularityEnum` 报告的粒度。排名可以按一周或一个月的时间范围进行。 `SELECT` 子句中必需的。`WHERE` 子句中必须包含对 `report_granularity` 的条件。
`report_country_code`	`string` 计算排名时所采用的国家/地区。采用 ISO 3166 格式表示。 `SELECT` 子句中必需的。`WHERE` 子句中必须包含对 `report_country_code` 的条件。
`report_category_id`	`int64` 用于计算排名的 Google 商品类别 ID，以 Google 商品类目中的表示法表示。 `SELECT` 子句中必需的。如果查询中未指定对 `report_category_id` 的 `WHERE` 条件，则系统会返回所有顶级类别的排名。
`title`	`string` 商品集群的名称。
`brand`	`string` 商品集合的品牌。
`category_l1`	`string` 商品集群的商品类别（第 1 级），以 Google 商品类目表示。
`category_l2`	`string` 商品集群的商品类别（第 2 级），以 Google 商品类目中的表示方式表示。
`category_l3`	`string` 商品集群的商品类别（第 3 级），以 Google 的商品类目表示。
`category_l4`	`string` 商品集群的商品类别（第 4 级），以 Google 商品类目中的表示方式表示。
`category_l5`	`string` 商品集群的商品类别（第 5 级），以 Google 的商品类目表示。
`inventory_status`	`InventoryStatus` 商品集群在至少一个国家/地区的商品数据源中的状态是否为 `IN_STOCK`，在所有国家/地区的商品数据源中的状态是否为 `OUT_OF_STOCK`，或者是否为 `NOT_IN_INVENTORY`。此字段不考虑畅销商品报告的国家/地区过滤条件。
`brand_inventory_status`	`InventoryStatus` 您的商品数据源中是否至少有一个国家/地区的品牌商品当前处于 `IN_STOCK` 状态，所有国家/地区的品牌商品均处于 `OUT_OF_STOCK` 状态，或者 `NOT_IN_INVENTORY`。此字段不考虑畅销商品报告的国家/地区过滤条件。
`rank`	`int64` 在选定的类别和国家/地区中，商品集群在广告和自然途径中的热门程度（以商品售出的估算单位数量为准）。
`previous_rank`	`int64` 前一周或前一个月的热门程度排名。
`relative_demand`	`RelativeDemandEnum` 相对于同一类别和国家/地区中热门程度排名最高的商品集群的预计需求量。
`previous_relative_demand`	`RelativeDemandEnum` 相对于同一类别和国家/地区中热门程度排名最高的商品集群，商品集群的预计需求量。
`relative_demand_change`	`RelativeDemandChangeTypeEnum` 预计需求的变化。是上涨、下跌还是持平。

InventoryStatus

商品集合或品牌在您的商品目录中的状态。

枚举
`INVENTORY_STATUS_UNSPECIFIED`	未指定。
`IN_STOCK`	您有此商品集合或品牌的商品在售。
`OUT_OF_STOCK`	您的商品目录中包含此商品集群或品牌的商品，但该商品目前缺货。
`NOT_IN_INVENTORY`	您的商品目录中没有此产品集群或品牌的商品。

CompetitiveVisibilityBenchmarkView

competitive_visibility_benchmark_view 表中可供查询的字段。

竞争洞察报告，其中包含类别基准。

系统只会为请求的搜索查询中明确请求的字段设置值。

字段
`date`	`Date` 此行的日期。 `SELECT` 子句中必需的。`WHERE` 子句中必须包含对 `date` 的条件。
`report_country_code`	`string` 展示发生的国家/地区。 `SELECT` 子句中必需的。`WHERE` 子句中必须包含 `report_country_code` 的条件。
`report_category_id`	`int64` 要为其计算报告的 Google 商品类别 ID，以 Google 商品类目中的表示法表示。 `SELECT` 子句中必需的。`WHERE` 子句中必须包含对 `report_category_id` 的条件。
`traffic_source`	`TrafficSourceEnum` 展示的流量来源。在 `SELECT` 子句中是必需的。
`your_domain_visibility_trend`	`double` 与所选时间范围的开始日期（或展示次数不为零的第一天）相比，网域曝光度的变化情况（以展示次数为依据）。无法在“WHERE”子句中进行过滤。
`category_benchmark_visibility_trend`	`double` 与所选时间范围的开始日期（或展示次数不为零的第一天）相比，曝光度变化（基于展示次数）。此指标基于一组曝光度最高且接近市场平均水平的商家计算得出。无法在“WHERE”子句中进行过滤。

CompetitiveVisibilityCompetitorView

competitive_visibility_competitor_view 表中可供查询的字段。

竞争洞察报告，其中包含与您曝光度相近的商家。

系统仅为请求的搜索查询中明确请求的字段设置值。

字段
`date`	`Date` 此行的日期。 `WHERE` 子句中必须包含对 `date` 的条件。
`domain`	`string` 竞争对手的域名，或您的域名（如果“is_your_domain”为 true）。 `SELECT` 子句中必需的。无法在“WHERE”子句中进行过滤。
`is_your_domain`	`bool` 如果此行包含您的网域的数据，则为 True。无法在“WHERE”子句中进行过滤。
`report_country_code`	`string` 展示发生的国家/地区。 `SELECT` 子句中必需的。`WHERE` 子句中必须包含对 `report_country_code` 的条件。
`report_category_id`	`int64` 要为其计算报告的 Google 商品类别 ID，以 Google 商品类目中的表示法表示。 `SELECT` 子句中必需的。`WHERE` 子句中必须包含对 `report_category_id` 的条件。
`traffic_source`	`TrafficSourceEnum` 展示的流量来源。在 `SELECT` 子句中是必需的。
`rank`	`int64` 在根据展示次数对所选关键字（`date`、`report_category_id`、`report_country_code`、`traffic_source`）进行的类似商家排名中，域名的排名。1 表示最高。无法在“WHERE”子句中进行过滤。
`ads_organic_ratio`	`double` 广告流量 / 自然流量比率是指，与从自然流量获得展示次数相比，网域从购物广告获得展示次数的频率。系统会对此数字进行舍入并分桶。无法在“WHERE”子句中进行过滤。
`page_overlap_rate`	`double` 同页重叠率是指竞争对手的商品与您的商品在同一页面中同时展示的频率。无法在“WHERE”子句中进行过滤。
`higher_position_rate`	`double` 排名较您高出率是指，竞争对手的商品较您的商品在同一页面上获得更高排名的频率。无法在“WHERE”子句中进行过滤。
`relative_visibility`	`double` 相对曝光度是指相较于您的商品，竞争对手商品的展示频率。换句话说，相对曝光度是指在所选时间范围内针对特定商品类别和国家/地区，竞争对手获得的展示次数除以您的展示次数所得到的值。无法在“WHERE”子句中进行过滤。

CompetitiveVisibilityTopMerchantView

competitive_visibility_top_merchant_view 表中可供查询的字段。

竞争洞察报告，其中显示曝光度最高的商家。

系统只会为请求的搜索查询中明确请求的字段设置值。

字段
`date`	`Date` 此行的日期。无法在 `SELECT` 子句中选择。`WHERE` 子句中必须包含对 `date` 的条件。
`domain`	`string` 竞争对手的域名，或您的域名（如果“is_your_domain”为 true）。 `SELECT` 子句中必需的。无法在“WHERE”子句中进行过滤。
`is_your_domain`	`bool` 如果此行包含您的网域的数据，则为 True。无法在“WHERE”子句中进行过滤。
`report_country_code`	`string` 展示发生的国家/地区。 `SELECT` 子句中必需的。`WHERE` 子句中必须包含对 `report_country_code` 的条件。
`report_category_id`	`int64` 要为其计算报告的 Google 商品类别 ID，以 Google 商品类目中的表示法表示。 `SELECT` 子句中必需的。`WHERE` 子句中必须包含对 `report_category_id` 的条件。
`traffic_source`	`TrafficSourceEnum` 展示的流量来源。在 `SELECT` 子句中是必需的。
`rank`	`int64` 在根据展示次数对所选键值（`date`、`report_category_id`、`report_country_code`、`traffic_source`）进行的热门商家排名中，相应网域所处的位置。1 表示最高。无法在“WHERE”子句中进行过滤。
`ads_organic_ratio`	`double` 广告流量 / 自然流量比率是指，与从自然流量获得展示次数相比，网域从购物广告获得展示次数的频率。系统会对此数字进行舍入并分桶。无法在“WHERE”子句中进行过滤。
`page_overlap_rate`	`double` 同页重叠率是指竞争对手的商品与您的商品在同一页面中同时展示的频率。无法在“WHERE”子句中进行过滤。
`higher_position_rate`	`double` 排名较您高出率是指，竞争对手的商品较您的商品在同一页面上获得更高排名的频率。无法在“WHERE”子句中进行过滤。

MarketingMethod

此类型没有字段。

在 Google 上宣传商品的营销方法（自然搜索结果与广告）。

MarketingMethodEnum

营销方式值。

枚举
`MARKETING_METHOD_ENUM_UNSPECIFIED`	未指定。
`ORGANIC`	自然营销。
`ADS`	基于广告的营销。

NonProductPerformanceView

non_product_performance_view 表中可供查询的字段。

指向非商品页面的图片和网店链接的效果数据。这包括效果指标（例如 clicks）和用于对效果指标进行细分的维度（例如 date）。

在查询中选择细分字段时，必须同时选择至少一个指标字段。

系统仅为请求的搜索查询中明确请求的字段设置值。

字段
`date`	`Date` 指标适用的商家时区中的日期。细分。 `WHERE` 子句中必须包含对 `date` 的条件。
`week`	`Date` 指指标日期（以商家所在时区为准）的一周第一天（星期一）。细分。
`clicks`	`int64` 将用户引向您非商品页面的图片和网店链接获得的点击次数。指标。
`impressions`	`int64` 指向您非商品页面的图片和网店链接的展示次数。指标。
`click_through_rate`	`double` 点击率：将将用户引导至非商品页面的图片和网店链接获得的点击次数 (`clicks`) 除以展示次数 (`impressions`)。指标。

PriceCompetitivenessProductView

price_competitiveness_product_view 表中可供查询的字段。

价格竞争力报告。

系统仅为请求的搜索查询中明确请求的字段设置值。

字段
`price`	`Price` 商品的当前价格。
`benchmark_price`	`Price` 基准国家/地区中商品目录的最新可用价格基准。
`report_country_code`	`string` 价格基准的国家/地区。采用 ISO 3166 格式表示。在 `SELECT` 子句中是必需的。
`id`	`string` 商品的 REST ID，格式为 `channel~languageCode~feedLabel~offerId`。可用于将数据与 `product_view` 表联接。在 `SELECT` 子句中是必需的。
`offer_id`	`string` 商家提供的商品 ID。
`title`	`string` 商品的标题。
`brand`	`string` 商品的品牌。
`category_l1`	`string` Google 商品类目中的商品类别（第 1 级）。
`category_l2`	`string` Google 商品类目中的商品类别（第 2 级）。
`category_l3`	`string` Google 商品类目中的商品类别（第 3 级）。
`category_l4`	`string` Google 商品类目中的商品类别（第 4 级）。
`category_l5`	`string` Google 商品类目中的商品类别（第 5 级）。
`product_type_l1`	`string` 商家自有商品类目中的商品类型（第 1 级）。
`product_type_l2`	`string` 商家自有商品分类中的商品类型（第 2 级）。
`product_type_l3`	`string` 商家自有商品分类中的商品类型（第 3 级）。
`product_type_l4`	`string` 商家自有商品分类中的商品类型（第 4 级）。
`product_type_l5`	`string` 商家自有商品分类法中的商品类型（第 5 级）。

PriceInsightsProductView

price_insights_product_view 表中可供查询的字段。

价格分析报告。

系统仅为请求的搜索查询中明确请求的字段设置值。

字段
`price`	`Price` 商品的当前价格。
`suggested_price`	`Price` 商品的最新建议价格。
`effectiveness`	`Effectiveness` 应用价格建议后的预计效果（分桶）。
`id`	`string` 商品的 REST ID，格式为 `channel~languageCode~feedLabel~offerId`。可用于将数据与 `product_view` 表联接。在 `SELECT` 子句中是必需的。
`offer_id`	`string` 商家提供的商品 ID。
`title`	`string` 商品的标题。
`brand`	`string` 商品的品牌。
`category_l1`	`string` Google 商品类目中的商品类别（第 1 级）。
`category_l2`	`string` Google 商品类目中的商品类别（第 2 级）。
`category_l3`	`string` Google 商品类目中的商品类别（第 3 级）。
`category_l4`	`string` Google 商品类目中的商品类别（第 4 级）。
`category_l5`	`string` Google 商品类目中的商品类别（第 5 级）。
`product_type_l1`	`string` 商家自有商品类目中的商品类型（第 1 级）。
`product_type_l2`	`string` 商家自有商品分类法中的商品类型（第 2 级）。
`product_type_l3`	`string` 商家自有商品分类中的商品类型（第 3 级）。
`product_type_l4`	`string` 商家自有商品类目中的商品类型（第 4 级）。
`product_type_l5`	`string` 商家自有商品分类法中的商品类型（第 5 级）。
`predicted_impressions_change_fraction`	`double` 采用建议的价格后预计获得的展示次数与当前有效价格相比的变化幅度（以小数表示）。例如，0.05 表示预计展示次数会增加 5%。
`predicted_clicks_change_fraction`	`double` 采用建议的价格后预计获得的点击次数与当前有效价格相比的变化幅度（以小数表示）。例如，0.05 表示预计点击次数会增加 5%。
`predicted_conversions_change_fraction`	`double` 采用建议价格后预计的转化次数变化（与当前有效价格相比），以小数表示。例如，0.05 表示预计转化次数会增加 5%）。

效果

预测的效果分桶。

“效果”指示哪些商品在调价后受益最大。此评分会考虑调整促销价以及当前价格与建议价格之间的差值预计会提升的效果。具有 HIGH 效果的建议价格预计可最大限度地提升广告效果。

枚举
`EFFECTIVENESS_UNSPECIFIED`	效果未知。
`LOW`	效果较差。
`MEDIUM`	效果为中等。
`HIGH`	效果出色。

ProductPerformanceView

product_performance_view 表中可供查询的字段。

您账号的商品效果数据，包括效果指标（例如 clicks）和用于对效果指标进行细分的维度（例如 offer_id）。商品维度（例如 offer_id）的值反映了商品在展示时所处的状态。

在查询中选择细分字段时，必须同时选择至少一个指标字段。

系统仅为请求的搜索查询中明确请求的字段设置值。

字段
`date`	`Date` 指标适用的商家时区中的日期。细分。 `WHERE` 子句中必须包含对 `date` 的条件。
`week`	`Date` 指指标日期的一周第一天（星期一），以商家所在的时区为准。细分。
`conversion_value`	`Price` 归因于该产品的转化的价值，在转化日期报告。指标。仅适用于 `FREE` 流量来源。
`marketing_method`	`MarketingMethodEnum` 指标适用的营销方式。细分。
`customer_country_code`	`string` 事件发生时客户所在国家/地区的代码。采用 ISO 3166 格式表示。细分。如果无法确定客户所在的国家/地区，系统会返回特殊的“ZZ”代码。
`offer_id`	`string` 商家提供的商品 ID。细分。
`title`	`string` 商品的名称。细分。
`brand`	`string` 商品的品牌。细分。
`category_l1`	`string` Google 商品类目中的商品类别（第 1 级）。细分。
`category_l2`	`string` Google 商品类目中的商品类别（第 2 级）。细分。
`category_l3`	`string` Google 商品类目中的商品类别（第 3 级）。细分。
`category_l4`	`string` Google 商品类目中的商品类别（第 4 级）。细分。
`category_l5`	`string` Google 商品类目中的商品类别（第 5 级）。细分。
`product_type_l1`	`string` 商家自有商品分类中的商品类型（第 1 级）。细分。
`product_type_l2`	`string` 商家自有商品分类中的商品类型（第 2 级）。细分。
`product_type_l3`	`string` 商家自有商品分类中的产品类型（第 3 级）。细分。
`product_type_l4`	`string` 商家自有商品分类中的商品类型（第 4 级）。细分。
`product_type_l5`	`string` 商家自有商品分类中的产品类型（第 5 级）。细分。
`custom_label0`	`string` 自定义标签 0，用于自定义商品分组。细分。
`custom_label1`	`string` 自定义标签 1，用于自定义商品分组。细分。
`custom_label2`	`string` 自定义标签 2，用于对商品进行自定义分组。细分。
`custom_label3`	`string` 自定义标签 3，用于自定义商品分组。细分。
`custom_label4`	`string` 自定义标签 4，用于自定义商品分组。细分。
`clicks`	`int64` 点击次数。指标。
`impressions`	`int64` 商家商品的展示次数。指标。
`click_through_rate`	`double` 点击率 - 商家商品获得的点击次数（点击次数）除以商品的展示次数（展示次数）。指标。
`conversions`	`double` 归因于该商品的转化次数，以转化日期为依据进行报告。根据归因模型，转化可能会分配给多次点击，每次点击都会获得自己的功劳。此指标是所有此类抵用金的总和。指标。仅适用于 `FREE` 流量来源。
`conversion_rate`	`double` 转化次数除以点击次数，以展示日期为依据进行报告。指标。仅适用于 `FREE` 流量来源。

ProductView

product_view 表中可供查询的字段。

当前商品目录中的商品。此表中的商品与“Products”子 API 中的商品相同，但“Products”子 API 中的并非所有商品属性都可以在此表中查询。与 Products 子 API 不同，此表允许按商品属性过滤返回的商品列表。如需按 id 检索单个商品或列出所有商品，应使用 Products 子 API。

系统仅为请求的搜索查询中明确请求的字段设置值。

字段
`price`	`Price` 商品价格。如果没有商品价格信息，则不填。
`gtin[]`	`string` 商品的全球贸易项目代码 (GTIN) 列表。
`creation_time`	`Timestamp` 商家创建商品的时间（采用时间戳秒数形式）。
`expiration_date`	`Date` 商品的下架日期，在插入时指定。
`item_issues[]`	`ItemIssue` 商品的商品问题列表。此字段无法用于对结果进行排序。只有此字段的部分属性（例如 `item_issues.severity.aggregated_severity`）可用于过滤结果。
`click_potential`	`ClickPotential` 与商家表现最好的商品相比，商品的预估效果潜力。
`id`	`string` 商品的 REST ID，格式为 `channel~languageCode~feedLabel~offerId`。对商品执行操作的商家 API 方法会将其作为 `name` 参数。在 `SELECT` 子句中是必需的。
`channel`	`ChannelEnum` 商品的渠道。可以是 `ONLINE` 或 `LOCAL`。
`language_code`	`string` 商品的语言代码，采用 BCP 47 格式。
`feed_label`	`string` 商品的 Feed 标签。
`offer_id`	`string` 商家提供的商品 ID。
`title`	`string` 商品的标题。
`brand`	`string` 商品的品牌。
`category_l1`	`string` Google 商品类目中的商品类别（第 1 级）。
`category_l2`	`string` Google 商品类目中的商品类别（第 2 级）。
`category_l3`	`string` Google 商品类目中的商品类别（第 3 级）。
`category_l4`	`string` Google 商品类目中的商品类别（第 4 级）。
`category_l5`	`string` Google 商品类目中的商品类别（第 5 级）。
`product_type_l1`	`string` 商家自有商品类目中的商品类型（第 1 级）。
`product_type_l2`	`string` 商家自有商品分类中的商品类型（第 2 级）。
`product_type_l3`	`string` 商家自有商品分类中的商品类型（第 3 级）。
`product_type_l4`	`string` 商家自有商品分类中的商品类型（第 4 级）。
`product_type_l5`	`string` 商家自有商品分类中的商品类型（第 5 级）。
`condition`	`string` 商品的使用情况。
`availability`	`string` 商品的库存状况。
`shipping_label`	`string` 数据源中指定的标准化配送标签。
`item_group_id`	`string` 商家提供的商品组 ID，用于将款式/规格归为一组。
`thumbnail_link`	`string` 指向 Google 基础架构上托管的商品经过处理的图片的链接。
`aggregated_reporting_context_status`	`AggregatedReportingContextStatus` 汇总状态。
`click_potential_rank`	`int64` 商品的点击潜力排名。在符合搜索查询条件的商家商品中，`click_potential_rank` 为 1 的商品获得点击的潜力最高。

AggregatedReportingContextStatus

针对所有报告上下文汇总的商品状态。

下面的示例展示了如何计算汇总状态：

非付费商品详情	购物广告	状态
已批准	已批准	有效
已批准	待处理	有效
已批准	已拒登	ELIGIBLE_LIMITED
待处理	待处理	待审批
已拒登	已拒登	NOT_ELIGIBLE_OR_DISAPPROVED

枚举
`AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED`	未指定。
`NOT_ELIGIBLE_OR_DISAPPROVED`	商品不符合条件或在所有报告上下文中均未获批准。
`PENDING`	商品在所有报告上下文中的状态均为“待处理”。
`ELIGIBLE_LIMITED`	商品适用于部分（但不是全部）报告上下文。
`ELIGIBLE`	商品符合所有报告上下文的要求。

ClickPotential

商品的点击潜力用于评估该商品与商家表现最好的商品相比潜力如何。商家可参考商品获得点击的潜力来决定要优先修正哪些商品的问题，以及对比商品当前的表现与其真实潜力。

枚举
`CLICK_POTENTIAL_UNSPECIFIED`	未知的预测点击次数影响。
`LOW`	与商家表现最好的商品相比，有可能获得相对较少的点击次数。
`MEDIUM`	与商家表现最好的商品相比，有可能获得适中的点击次数。
`HIGH`	与商家表现最好的商品相比，有可能获得大体相当的点击次数。

ItemIssue

与商品相关的商品问题。

字段

字段
`type`	`ItemIssueType` 商品问题类型。
`severity`	`ItemIssueSeverity` 商品问题的严重程度。
`resolution`	`ItemIssueResolution` 商品问题解决。

type

ItemIssueType

商品问题类型。

severity

ItemIssueSeverity

商品问题的严重程度。

resolution

ItemIssueResolution

商品问题解决。

ItemIssueResolution

如何解决此问题。

枚举
`ITEM_ISSUE_RESOLUTION_UNSPECIFIED`	未指定。
`MERCHANT_ACTION`	商家必须解决此问题。
`PENDING_PROCESSING`	问题将自动解决（例如图片抓取），或通过 Google 审核解决。商家目前无需采取任何行动。解决方案可能会导致其他问题（例如抓取失败）。

ItemIssueSeverity

此问题对商品投放有何影响。

字段

字段
`severity_per_reporting_context[]`	`IssueSeverityPerReportingContext` 每个报告上下文的问题严重级别。
`aggregated_severity`	`AggregatedIssueSeverity` 针对问题所影响的所有报告上下文汇总的问题严重级别。此字段可用于过滤结果。

severity_per_reporting_context[]

IssueSeverityPerReportingContext

每个报告上下文的问题严重级别。

aggregated_severity

AggregatedIssueSeverity

针对问题所影响的所有报告上下文汇总的问题严重级别。

此字段可用于过滤结果。

AggregatedIssueSeverity

针对所有报告上下文汇总的问题严重级别。

枚举
`AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED`	未指定。
`DISAPPROVED`	问题导致商品在至少一个报告上下文中被拒批。
`DEMOTED`	问题会在其影响的所有报告上下文中将商品降级。
`PENDING`	问题解决方案为 `PENDING_PROCESSING`。

IssueSeverityPerReportingContext

每个报告上下文的问题严重级别。

字段

字段
`disapproved_countries[]`	`string` 报告上下文中的已拒登国家/地区列表，以 ISO 3166 格式表示。
`demoted_countries[]`	`string` 报告上下文中的已降级国家/地区列表，以 ISO 3166 格式表示。
`reporting_context`	`ReportingContextEnum` 问题适用的报告上下文。

disapproved_countries[]

string

报告上下文中的已拒登国家/地区列表，以 ISO 3166 格式表示。

demoted_countries[]

string

报告上下文中的已降级国家/地区列表，以 ISO 3166 格式表示。

reporting_context

ReportingContextEnum

问题适用的报告上下文。

ItemIssueType

问题类型。

字段

字段
`code`	`string` 问题错误代码，相当于商品问题的 `code`。
`canonical_attribute`	`string` 特定于属性的问题的规范属性名称。

code

string

问题错误代码，相当于商品问题的 code。

canonical_attribute

string

特定于属性的问题的规范属性名称。

RelativeDemand

此类型没有字段。

畅销商品报告中商品集合或品牌的相对需求。

RelativeDemandEnum

相对需求值。

枚举
`RELATIVE_DEMAND_ENUM_UNSPECIFIED`	未指定。
`VERY_LOW`	需求量相当于排名最高的商品集合或品牌需求量的 0-5%。
`LOW`	需求量相当于排名最高的商品集合或品牌需求量的 6-10%。
`MEDIUM`	需求量相当于排名最高的商品集合或品牌需求量的 11-20%。
`HIGH`	需求量相当于排名最高的商品集合或品牌需求量的 21-50%。
`VERY_HIGH`	需求量相当于排名最高的商品集合或品牌需求量的 51-100%。

RelativeDemandChangeType

此类型没有字段。

畅销商品报告中商品集合或品牌与上一时间段相比的相对需求。

RelativeDemandChangeTypeEnum

相对需求变化类型值。

枚举
`RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED`	未指定。
`SINKER`	相对于上一时间段，相对需求较低。
`FLAT`	相对需求与上一时间段相同。
`RISER`	相对需求高于上一时间段。

ReportGranularity

此类型没有字段。

“畅销商品”报告的粒度。畅销商品报告是根据一周和一个月的期限计算得出的。

ReportGranularityEnum

报告粒度值。

枚举
`REPORT_GRANULARITY_ENUM_UNSPECIFIED`	未指定。
`WEEKLY`	报告是根据一周的时间范围计算得出的。
`MONTHLY`	报告是根据一个月的期限计算得出的。

ReportRow

搜索查询返回的结果行。

响应中仅填充与查询的表对应的消息。在填充的消息中，系统只会填充查询中明确请求的字段。

字段
`product_performance_view`	`ProductPerformanceView` `product_performance_view` 表中可供查询的字段。
`non_product_performance_view`	`NonProductPerformanceView` `non_product_performance_view` 表中可供查询的字段。
`product_view`	`ProductView` `product_view` 表中可供查询的字段。
`price_competitiveness_product_view`	`PriceCompetitivenessProductView` `price_competitiveness_product_view` 表中可供查询的字段。
`price_insights_product_view`	`PriceInsightsProductView` `price_insights_product_view` 表中可供查询的字段。
`best_sellers_product_cluster_view`	`BestSellersProductClusterView` `best_sellers_product_cluster_view` 表中可供查询的字段。
`best_sellers_brand_view`	`BestSellersBrandView` `best_sellers_brand_view` 表中可供查询的字段。
`competitive_visibility_competitor_view`	`CompetitiveVisibilityCompetitorView` `competitive_visibility_competitor_view` 表中可供查询的字段。
`competitive_visibility_top_merchant_view`	`CompetitiveVisibilityTopMerchantView` `competitive_visibility_top_merchant_view` 表中可供查询的字段。
`competitive_visibility_benchmark_view`	`CompetitiveVisibilityBenchmarkView` `competitive_visibility_benchmark_view` 表中可供查询的字段。

SearchRequest

对 ReportService.Search 方法的请求消息。

字段
`parent`	`string` 必需。发出调用的账号的 ID。必须是独立账号或 MCA 子账号。格式：accounts/{account}
`query`	`string` 必需。用于定义要检索的报告的查询。如需详细了解如何构建查询，请参阅“查询语言”指南。如需查看可用表格和字段的完整列表，请参阅“可用字段”。
`page_size`	`int32` 可选。要在单个页面中检索的 `ReportRows` 的数量。默认值为 1000。大于 5000 的值会强制转换为 5000。
`page_token`	`string` 可选。要检索的页面的令牌。如果未指定，则返回第一页的结果。如需请求下一页结果，应使用上一个响应中从 `next_page_token` 获取的值。

SearchResponse

ReportService.Search 方法的响应消息。

字段

字段
`results[]`	`ReportRow` 与搜索查询匹配的行。
`next_page_token`	`string` 可作为 `page_token` 发送并用于检索下一页的令牌。如果省略，则不存在后续页面。

results[]

ReportRow

与搜索查询匹配的行。

next_page_token

string

可作为 page_token 发送并用于检索下一页的令牌。如果省略，则不存在后续页面。

TrafficSource

此类型没有字段。

“竞争洞察”报告中展示次数的流量来源。

TrafficSourceEnum

流量来源值。

枚举
`TRAFFIC_SOURCE_ENUM_UNSPECIFIED`	未指定。
`ORGANIC`	自然流量。
`ADS`	广告流量。
`ALL`	自然流量和广告流量。

Package google.shopping.merchant.reports.v1beta 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

索引

ReportService

BestSellersBrandView

BestSellersProductClusterView

InventoryStatus

CompetitiveVisibilityBenchmarkView

CompetitiveVisibilityCompetitorView

CompetitiveVisibilityTopMerchantView

MarketingMethod

MarketingMethodEnum

NonProductPerformanceView

PriceCompetitivenessProductView

PriceInsightsProductView

效果

ProductPerformanceView

ProductView

AggregatedReportingContextStatus

ClickPotential

ItemIssue

ItemIssueResolution

ItemIssueSeverity

AggregatedIssueSeverity

IssueSeverityPerReportingContext

ItemIssueType

RelativeDemand

RelativeDemandEnum

RelativeDemandChangeType

RelativeDemandChangeTypeEnum

ReportGranularity

ReportGranularityEnum

ReportRow

SearchRequest

SearchResponse

TrafficSource

TrafficSourceEnum

Package google.shopping.merchant.reports.v1beta