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 在选定的类别和国家/地区中，品牌在 Google Ads 和自然平台中的热门程度（基于估算的售出商品数量）。
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 在所选类别和国家/地区，此商品集群在 Google Ads 和自然平台中的热门程度（基于估算的售出商品数量）。
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 显示情况变化，基于您网域的展示次数，从所选时间范围的起始日期（或第 1 天获得非零展示次数）开始。 无法在“WHERE”子句中进行过滤。
category_benchmark_visibility_trend	double 曝光度变化，基于展示次数相对于所选时间范围（或第 1 天，展示次数不为零）开始，曝光度最高且近似市场的一组商家组合。 无法在“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”表中可供查询的字段。

当前商品目录中的商品。此表中的商品与商品子 API 中的商品相同，但并非商品子 API 中的所有商品属性都可在此表中查询。与商品子 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 数。默认值为 1,000。大于 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	自然流量和广告流量。