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 概览。

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）中，相应网域在前 10 名商家中的排名。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 表中可供查询的字段。

当前商品目录中的商品。此表中的商品与商品子 API 中的商品相同，但此表中无法查询商品子 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 商品问题解决。

ItemIssueResolution

如何解决该问题。

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

ItemIssueSeverity

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

字段
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 报告问题适用的背景。

ItemIssueType

问题类型。

字段
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 发送以检索下一页的令牌。如果省略，则没有后续页面。

TrafficSource

此类型没有字段。

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

TrafficSourceEnum

流量来源值。

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