本頁面由 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 總覽。

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` 子句中這是必要項目。`report_granularity` 的條件是 `WHERE` 子句中的條件。
`report_country_code`	`string` 計算排名的國家/地區。以 ISO 3166 格式表示。 `SELECT` 子句中這是必要項目。`report_country_code` 的條件是 `WHERE` 子句中的條件。
`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` 產品叢集範例子類的全球交易品項識別碼。
`report_granularity`	`ReportGranularityEnum` 報表精細程度。這項排名可以透過一週或一個月的時間決定。 `SELECT` 子句中這是必要項目。`report_granularity` 的條件是 `WHERE` 子句中的條件。
`report_country_code`	`string` 計算排名的國家/地區。以 ISO 3166 格式表示。 `SELECT` 子句中這是必要項目。`report_country_code` 的條件是 `WHERE` 子句中的條件。
`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` 根據網域在指定時間範圍開始 (或非零曝光次數的第一天) 的曝光次數變化，顯示曝光率的變化。無法在「WHERE」子句中篩選。
`category_benchmark_visibility_trend`	`double` 系統會根據所選時間範圍 (或曝光次數不為 0 的第一天) 的一組曝光次數變化，針對大概市場上曝光率最高的商家組合，根據曝光次數的變化變化。無法在「WHERE」子句中篩選。

CompetitiveVisibilityCompetitorView

適用於 competitive_visibility_competitor_view 資料表中查詢的欄位。

「競爭曝光率」報表會說明曝光率相近的商家。

只有要求搜尋查詢中明確要求的欄位才會設定值。

欄位
`date`	`Date` 此資料列的日期。 `WHERE` 子句中必須有 `date` 的條件。
`domain`	`string` 您的競爭對手網域或您的網域 (如果「is_your_domain」為 true)。 `SELECT` 子句中這是必要項目。無法在「WHERE」子句中篩選。
`is_your_domain`	`bool` 如果這一列包含您網域的資料，則為「是」。無法在「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` 如果這一列包含您網域的資料，則為「是」。無法在「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` 指標適用商家時區的日期。區隔。 `date` 的條件是 `WHERE` 子句中的條件。
`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` 指標適用商家時區的日期。區隔。 `date` 的條件是 `WHERE` 子句中的條件。
`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 資料表中查詢的欄位。

目前商品目錄中的產品。這個表格中的產品與 Product 子 API 相同，但並非所有產品子 API 的產品屬性都能在這個表格中查詢。相較於 Product 子 API，這個表格可以依產品屬性篩選傳回的產品清單。如要在 id前擷取單一產品或列出所有產品，請使用 Product 子 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` 商品問題已解決。

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`	自然流量和廣告流量。