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。

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」為真)。 必須在 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。針對產品運作的 Merchant API 方法會將此做為 name 參數。 必須在 SELECT 子句中使用。
channel	ChannelEnum 產品管道。可以是 ONLINE 或 LOCAL。
language_code	string 產品的語言代碼，格式為 BCP 47。
feed_label	string 產品的動態饋給標籤。
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	自然流量和廣告流量。