Method: accounts.reports.search

擷取搜尋查詢所定義的報表。回應包含的資料列數可能會少於 pageSize 指定的列數。根據 nextPageToken 判斷是否有更多列要求。

HTTP 要求

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必要欄位。進行呼叫的帳戶 ID。必須是獨立帳戶或 MCA 子帳戶。格式：accounts/{account}

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
欄位
query

string

必要欄位。定義要擷取報表的查詢。

如要進一步瞭解如何建構查詢，請參閱查詢語言指南。如需可用表格和欄位的完整清單，請參閱「可用」欄位。
pageSize

integer

選用設定。在單一頁面中擷取的 ReportRows 數量。預設值為 1000。系統會將超過 5,000 個值強制轉換為 5000。
pageToken

string

選用設定。要擷取的網頁權杖。如果未指定，則會傳回第一頁的結果。為了要求下一頁的結果，則應使用透過上一項回應中 nextPageToken 取得的值。

回應主體

ReportService.Search 方法的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
欄位
results[]

object (ReportRow)

與搜尋查詢相符的資料列。
nextPageToken

string

可做為 pageToken 傳送的權杖，用於擷取下一頁。如果省略此引數，系統就不會提供後續頁面。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

ReportRow

搜尋查詢傳回的結果列。

回應中只會填入與查詢資料表相對應的訊息。在填入的訊息中，系統只會填入查詢中明確要求的欄位。

JSON 表示法 
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
欄位
productPerformanceView

object (ProductPerformanceView)

productPerformanceView 資料表中可查詢的欄位。
nonProductPerformanceView

object (NonProductPerformanceView)

nonProductPerformanceView 資料表中可查詢的欄位。
productView

object (ProductView)

productView 資料表中可查詢的欄位。
priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

priceCompetitivenessProductView 資料表中可查詢的欄位。
priceInsightsProductView

object (PriceInsightsProductView)

priceInsightsProductView 資料表中可查詢的欄位。
bestSellersProductClusterView

object (BestSellersProductClusterView)

bestSellersProductClusterView 資料表中可查詢的欄位。
bestSellersBrandView

object (BestSellersBrandView)

bestSellersBrandView 資料表中可查詢的欄位。
competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

competitiveVisibilityCompetitorView 資料表中可查詢的欄位。
competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

competitiveVisibilityTopMerchantView 資料表中可查詢的欄位。
competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

competitiveVisibilityBenchmarkView 資料表中可查詢的欄位。

ProductPerformanceView

productPerformanceView 資料表中可查詢的欄位。

帳戶的產品成效資料，包括成效指標 (例如 clicks) 和系統區隔成效指標 (例如：offerId) 的維度。產品維度 (例如 offerId) 的值代表曝光當下的產品狀態。

您必須先選取至少一個指標欄位，才能在查詢中選取區隔欄位。

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

JSON 表示法 
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
欄位
date

object (Date)

指標套用的商家時區日期。區隔。

WHERE 子句必須指定 date 的條件。
week

object (Date)

商家時區的指標日期是星期幾 (星期一)。區隔。
conversionValue

object (Price)

歸因於產品的轉換價值 (在轉換日期中記錄)。指標：

僅適用於 FREE 流量來源。
marketingMethod

enum (MarketingMethodEnum)

指標適用的行銷方式。區隔。
customerCountryCode

string

活動舉辦時，客戶所在國家/地區的代碼。以 ISO 3166 格式表示。區隔。

如果無法判斷客戶的國家/地區，系統會傳回特殊的「ZZ」代碼。
offerId

string

商家提供的產品 ID。區隔。
title

string

產品名稱。區隔。
brand

string

產品的品牌。區隔。
categoryL1

string

Google 產品分類中的產品類別 (第 1 層)。區隔。
categoryL2

string

Google 產品分類中的產品類別 (第 2 層)。區隔。
categoryL3

string

Google 產品分類中的產品類別 (第 3 層)。區隔。
categoryL4

string

Google 產品分類中的產品類別 (第 4 層)。區隔。
categoryL5

string

Google 產品分類中的產品類別 (第 5 層)。區隔。
productTypeL1

string

商家自有產品分類中的產品類型 (第 1 層)。區隔。
productTypeL2

string

商家自有產品分類中的產品類型 (第 2 層)。區隔。
productTypeL3

string

商家自有產品分類中的產品類型 (第 3 層)。區隔。
productTypeL4

string

商家自有產品分類中的產品類型 (第 4 層)。區隔。
productTypeL5

string

商家自有產品分類中的產品類型 (第 5 層)。區隔。
customLabel0

string

用於自訂產品群組的自訂標籤 0。區隔。
customLabel1

string

用於自訂產品群組的自訂標籤 1。區隔。
customLabel2

string

用於自訂產品群組的自訂標籤 2。區隔。
customLabel3

string

用於自訂產品群組的自訂標籤 3。區隔。
customLabel4

string

用於自訂產品群組的自訂標籤 4。區隔。
clicks

string (int64 format)

點擊次數。指標：
impressions

string (int64 format)

商家產品的顯示次數。指標：
clickThroughRate

number

點閱率：將商家產品獲得的點擊次數 (點擊次數) 除以產品顯示次數 (曝光次數) 所得到的結果。指標：
conversions

number

歸因於產品的轉換次數 (在轉換日期中記錄)。視歸因模式而定，轉換可能會分配給多次點擊，而每次點擊都會分配到各自的功勞。這項指標是所有這類功勞的總和。指標：

僅適用於 FREE 流量來源。
conversionRate

number

轉換次數除以點擊次數 (以曝光日期為準)。指標：

僅適用於 FREE 流量來源。

MarketingMethodEnum

行銷方式的值。

列舉
MARKETING_METHOD_ENUM_UNSPECIFIED 未指定。
ORGANIC 自然行銷。
ADS 以廣告為基礎的行銷。

NonProductPerformanceView

nonProductPerformanceView 資料表中可查詢的欄位。

導向非產品網頁的圖片和網路商店連結成效資料。包括成效指標 (例如 clicks) 和維度 (例如date)。

您必須先選取至少一個指標欄位，才能在查詢中選取區隔欄位。

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

JSON 表示法 
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
欄位
date

object (Date)

指標套用的商家時區日期。區隔。

WHERE 子句必須指定 date 的條件。
week

object (Date)

商家時區的指標日期是星期幾 (星期一)。區隔。
clicks

string (int64 format)

導向非產品網頁的圖片和網路商店連結點擊次數。指標：
impressions

string (int64 format)

連往你非產品網頁的圖片和網路商店連結的次數。指標：
clickThroughRate

number

點閱率：將導向非產品網頁的圖片和網路商店連結點擊次數 (clicks) 除以曝光次數 (impressions)。指標：

ProductView

productView 資料表中可查詢的欄位。

目前商品目錄中的產品。這份表格中的產品與「Products」子 API 相同，但這個表格並非所有來自 Product 子 API 的產品屬性都可供查詢。與 Products 子 API 相比，這個表格可讓您依據產品屬性篩選傳回的產品清單。如要在 id前擷取單一產品或列出所有產品，請使用「Products」子 API。

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

JSON 表示法 
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
欄位
price

object (Price)

產品價格。如果無法提供產品價格資訊，則為空白。
gtin[]

string

產品的全球交易品項識別碼 (GTIN) 清單。
creationTime

string (Timestamp format)

商家建立產品的時間，以時間戳記的秒數為單位。
expirationDate

object (Date)

產品到期日，於插入時指定。
itemIssues[]

object (ItemIssue)

產品的商品問題清單。

這個欄位無法用於排序結果。

只有這個欄位已選取的屬性 (例如 itemIssues.severity.aggregated_severity) 可以用來篩選結果。
clickPotential

enum (ClickPotential)

與商家成效最佳的產品比較後，所得出的預估成效潛力。
id

string

產品的 REST ID，格式為 channel~languageCode~feedLabel~offerId。適用於產品的 Merchant API 方法則是其 name 參數。

此為 SELECT 子句的必要欄位。
channel

enum (ChannelEnum)

產品的通路。可以是 ONLINE 或 LOCAL。
languageCode

string

BCP 47 格式的產品語言代碼。
feedLabel

string

產品的動態饋給標籤。
offerId

string

商家提供的產品 ID。
title

string

產品的標題。
brand

string

產品的品牌。
categoryL1

string

Google 產品分類中的產品類別 (第 1 層)。
categoryL2

string

Google 產品分類中的產品類別 (第 2 層)。
categoryL3

string

Google 產品分類中的產品類別 (第 3 層)。
categoryL4

string

Google 產品分類中的產品類別 (第 4 層)。
categoryL5

string

Google 產品分類中的產品類別 (第 5 層)。
productTypeL1

string

商家自有產品分類中的產品類型 (第 1 層)。
productTypeL2

string

商家專屬產品分類中的產品類型 (第 2 層)。
productTypeL3

string

商家專屬產品分類中的產品類型 (第 3 層)。
productTypeL4

string

商家專屬產品分類中的產品類型 (第 4 層)。
productTypeL5

string

商家專屬產品分類中的產品類型 (第 5 層)。
condition

string

產品的狀況。
availability

string

產品的供應情形。
shippingLabel

string

資料來源中指定的正規化運送標籤。
itemGroupId

string

商家為將子類分組提供的商品群組 ID。
aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

匯總狀態。
clickPotentialRank

string (int64 format)

依產品點擊次數潛力排列的產品排名。在商家符合搜尋查詢條件的情況下，clickPotentialRank 1 的產品點擊次數潛力最高的商家產品。

AggregatedReportingContextStatus

所有報表情境的匯總產品狀態。

以下舉例說明匯總狀態的計算方式：

免費產品資訊 購物廣告 狀態
已核准 已核准 符合資格
已核准 待核准 符合資格
已核准 已拒登 ELIGIBLE_LIMITED
待核准 待核准 待處理
已拒登 已拒登 NOT_ELIGIBLE_OR_DISAPPROVED
列舉
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED 未指定。
NOT_ELIGIBLE_OR_DISAPPROVED 產品在所有報表結構定義中均不符合資格或遭到拒登。
PENDING 在所有報表情境中，產品的狀態為「待處理」。
ELIGIBLE_LIMITED 產品適用於部分報表內容 (但非全部)。
ELIGIBLE 產品可用於所有報表情境。

ItemIssue

與產品有關的商品問題。

JSON 表示法 
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
欄位
type

object (ItemIssueType)

商品問題類型。
severity

object (ItemIssueSeverity)

商品問題嚴重性。
resolution

enum (ItemIssueResolution)

商品問題已解決。

ItemIssueType

問題類型。

JSON 表示法 
{
  "code": string,
  "canonicalAttribute": string
}
欄位
code

string

問題的錯誤代碼，相當於產品問題的 code。
canonicalAttribute

string

用於屬性相關問題的標準屬性名稱。

ItemIssueSeverity

問題對產品放送的影響。

JSON 表示法 
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
欄位
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

各回報情境的問題嚴重性。
aggregatedSeverity

enum (AggregatedIssueSeverity)

問題 (影響所有回報情境) 的匯總嚴重性。

這個欄位可用來篩選結果。

IssueSeverityPerReportingContext

各回報情境的問題嚴重性。

JSON 表示法 
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
欄位
disapprovedCountries[]

string

報表內容中遭拒登的國家/地區清單，以 ISO 3166 格式表示。
demotedCountries[]

string

報表內容中降低排名的國家/地區清單，以 ISO 3166 格式表示。
reportingContext

enum (ReportingContextEnum)

回報問題發生情況的背景資訊。

AggregatedIssueSeverity

所有回報情境都會匯總的問題嚴重性。

列舉
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED 未指定。
DISAPPROVED 問題會在至少一項檢舉情境中拒登產品。
DEMOTED 問題會在所有影響的報表情境下降低產品排名。
PENDING 問題為PENDING_PROCESSING解決。

ItemIssueResolution

如何解決問題。

列舉
ITEM_ISSUE_RESOLUTION_UNSPECIFIED 未指定。
MERCHANT_ACTION 商家必須修正問題。
PENDING_PROCESSING 系統會自動透過 Google 審查 (例如圖片檢索) 或 Google 審查解決問題。商家目前不需要採取任何行動。該解析度可能導致其他問題，例如檢索失敗。

ClickPotential

產品的點擊次數潛力是與商家成效最佳的產品比較後，所得出的成效潛力預估值。商家可以運用產品潛力，決定哪些產品需要優先修正，並瞭解產品成效是否與潛力相符。

列舉
CLICK_POTENTIAL_UNSPECIFIED 未知的預測點擊次數影響。
LOW 相較於該商家成效最佳的產品，可能會獲得較少的點擊次數。
MEDIUM 相較於該商家成效最佳的產品，可能會獲得中等的點擊次數。
HIGH 相較於該商家成效最佳的產品，可能會獲得類似的點擊次數。

PriceCompetitivenessProductView

priceCompetitivenessProductView 資料表中可查詢的欄位。

價格競爭力報表。

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

JSON 表示法 
{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
欄位
price

object (Price)

產品目前價格。
benchmarkPrice

object (Price)

基準國家/地區中的產品目錄最新價格基準。
reportCountryCode

string

價格基準的國家/地區。以 ISO 3166 格式表示。

此為 SELECT 子句的必要欄位。
id

string

產品的 REST ID，格式為 channel~languageCode~feedLabel~offerId。可用來彙整資料與 productView 資料表。

此為 SELECT 子句的必要欄位。
offerId

string

商家提供的產品 ID。
title

string

產品的標題。
brand

string

產品的品牌。
categoryL1

string

Google 產品分類中的產品類別 (第 1 層)。
categoryL2

string

Google 產品分類中的產品類別 (第 2 層)。
categoryL3

string

Google 產品分類中的產品類別 (第 3 層)。
categoryL4

string

Google 產品分類中的產品類別 (第 4 層)。
categoryL5

string

Google 產品分類中的產品類別 (第 5 層)。
productTypeL1

string

商家自有產品分類中的產品類型 (第 1 層)。
productTypeL2

string

商家專屬產品分類中的產品類型 (第 2 層)。
productTypeL3

string

商家專屬產品分類中的產品類型 (第 3 層)。
productTypeL4

string

商家專屬產品分類中的產品類型 (第 4 層)。
productTypeL5

string

商家專屬產品分類中的產品類型 (第 5 層)。

PriceInsightsProductView

priceInsightsProductView 資料表中可查詢的欄位。

價格分析報表。

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

JSON 表示法 
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
欄位
price

object (Price)

產品目前價格。
suggestedPrice

object (Price)

產品的最新建議價格。
effectiveness

enum (Effectiveness)

套用分類價格建議後的預測成效。
id

string

產品的 REST ID，格式為 channel~languageCode~feedLabel~offerId。可用來彙整資料與 productView 資料表。

此為 SELECT 子句的必要欄位。
offerId

string

商家提供的產品 ID。
title

string

產品的標題。
brand

string

產品的品牌。
categoryL1

string

Google 產品分類中的產品類別 (第 1 層)。
categoryL2

string

Google 產品分類中的產品類別 (第 2 層)。
categoryL3

string

Google 產品分類中的產品類別 (第 3 層)。
categoryL4

string

Google 產品分類中的產品類別 (第 4 層)。
categoryL5

string

Google 產品分類中的產品類別 (第 5 層)。
productTypeL1

string

商家自有產品分類中的產品類型 (第 1 層)。
productTypeL2

string

商家專屬產品分類中的產品類型 (第 2 層)。
productTypeL3

string

商家專屬產品分類中的產品類型 (第 3 層)。
productTypeL4

string

商家專屬產品分類中的產品類型 (第 4 層)。
productTypeL5

string

商家專屬產品分類中的產品類型 (第 5 層)。
predictedImpressionsChangeFraction

number

採用建議價格與目前有效價格後，曝光次數的預計變化百分比。舉例來說，0.05 代表曝光次數預計會增加 5%。
predictedClicksChangeFraction

number

採用建議價格後，與目前有效價格相比的預估點擊次數變化。舉例來說，0.05 代表點擊次數預計會增加 5%。
predictedConversionsChangeFraction

number

採用建議價格後，預估轉換次數變化 (以小數表示)。例如，0.05 代表轉換次數預計會增加 5%)。

成效

預測效益區間。

「效益」代表調整價格對哪些產品最有幫助。這項評分會考量調整特價後提升的預估成效，以及目前價格和建議價格之間的差額。「HIGH」效益的建議價格預計帶動的成效升幅最大。

列舉
EFFECTIVENESS_UNSPECIFIED 成效不明。
LOW 成效偏低。
MEDIUM 成效中等。
HIGH 效益很高。

BestSellersProductClusterView

bestSellersProductClusterView 資料表中可查詢的欄位。

「暢銷商品」報表會列出熱門產品集群。產品叢集是將代表相同產品的不同優惠和子類分成一組，例如 Google Pixel 7。

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

JSON 表示法 
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
欄位
reportDate

object (Date)

報表日期。這個欄位的值只能設為下列其中一項：

  • 每週報表的第一天 (週一)，
  • 每月報表每個月的第一天。

此為 SELECT 子句的必要欄位。如未在查詢中指定 reportDate 的 WHERE 條件，系統會傳回最新的每週或每月報表。
variantGtins[]

string

產品叢集範例子類的全球交易品項識別碼。
reportGranularity

enum (ReportGranularityEnum)

報表的精細程度。排名可以透過一週或一個月的時間進行。

此為 SELECT 子句的必要欄位。WHERE 子句必須指定 reportGranularity 的條件。
reportCountryCode

string

計算排名的國家/地區。以 ISO 3166 格式表示。

此為 SELECT 子句的必要欄位。WHERE 子句必須指定 reportCountryCode 的條件。
reportCategoryId

string (int64 format)

計算排名的 Google 產品類別 ID，以「Google 產品分類」表示。

此為 SELECT 子句的必要欄位。如未在查詢中指定 reportCategoryId 的 WHERE 條件，系統將傳回所有頂層類別的排名。
title

string

產品叢集的名稱。
brand

string

產品叢集的品牌。
categoryL1

string

產品叢集的產品類別 (第 1 層)，以 Google 產品分類表示。
categoryL2

string

產品叢集的產品類別 (第 2 層)，以 Google 產品分類表示。
categoryL3

string

產品叢集的產品類別 (第 3 層)，以 Google 產品分類表示。
categoryL4

string

產品叢集的產品類別 (第 4 層)，以 Google 產品分類表示。
categoryL5

string

產品叢集的產品類別 (第 5 層)，以 Google 產品分類表示。
inventoryStatus

enum (InventoryStatus)

代表產品叢集是否IN_STOCK位於至少一個國家/地區、OUT_OF_STOCK所有國家/地區的產品資料來源中，或是NOT_IN_INVENTORY。

請注意，這個欄位不會將「暢銷商品」報表中的國家/地區篩選條件納入考量。
brandInventoryStatus

enum (InventoryStatus)

不論在至少一個國家/地區，您的產品資料來源中目前至少有一項品牌的產品為 IN_STOCK，在所有國家/地區的產品資料來源中，所有產品均為 OUT_OF_STOCK，或是 NOT_IN_INVENTORY。

請注意，這個欄位不會將「暢銷商品」報表中的國家/地區篩選條件納入考量。
rank

string (int64 format)

產品叢集在 Google Ads 和自然平台上的熱銷程度，排名依據為所選類別和國家/地區的預估銷售量。
previousRank

string (int64 format)

上週或上個月的熱門程度排名。
relativeDemand

enum (RelativeDemandEnum)

相較於相同國家/地區最熱銷的同類別產品叢集，預估需求。
previousRelativeDemand

enum (RelativeDemandEnum)

相較於過去一週或一個月內，熱銷度排名最高的產品叢集相較於前一週或一個月內，熱門程度排名最高的產品叢集的預估需求。
relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

預估需求變化。不管是玫瑰、乾燥或保持平坦。

ReportGranularityEnum

報表精細程度值。

列舉
REPORT_GRANULARITY_ENUM_UNSPECIFIED 未指定。
WEEKLY 報表是以一週的資料計算。
MONTHLY 報表是以一個月的時間範圍計算。

InventoryStatus

商品目錄中產品叢集或品牌的狀態。

列舉
INVENTORY_STATUS_UNSPECIFIED 未指定。
IN_STOCK 這個產品叢集或品牌有現貨。
OUT_OF_STOCK 您在商品目錄中為這個產品叢集或品牌有一項產品，但目前缺貨。
NOT_IN_INVENTORY 商品目錄中沒有這個產品叢集或品牌的產品。

RelativeDemandEnum

相對需求價值。

列舉
RELATIVE_DEMAND_ENUM_UNSPECIFIED 未指定。
VERY_LOW 需求是指排名最高產品叢集或品牌的 0% 至 5%。
LOW 需求是排名最高產品叢集或品牌需求的 6% 至 10%。
MEDIUM 需求是最熱銷產品叢集或品牌需求的 11% 至 20%。
HIGH 需求是最熱銷產品叢集或品牌需求的 21% 至 50%。
VERY_HIGH 需求是最熱銷產品叢集或品牌需求的 51% 至 100%。

RelativeDemandChangeTypeEnum

相對需求變更類型值。

列舉
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED 未指定。
SINKER 相對需求比先前的時間範圍還低。
FLAT 相對需求是指先前的時間範圍。
RISER 相對需求高於先前的時間範圍。

BestSellersBrandView

bestSellersBrandView 資料表中可查詢的欄位。

「暢銷商品」報表，列出熱銷品牌。

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

JSON 表示法 
{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
欄位
reportDate

object (Date)

報表日期。這個欄位的值只能設為下列其中一項：

  • 每週報表的第一天 (週一)，
  • 每月報表每個月的第一天。

此為 SELECT 子句的必要欄位。如未在查詢中指定 reportDate 的 WHERE 條件，系統會傳回最新的每週或每月報表。
reportGranularity

enum (ReportGranularityEnum)

報表的精細程度。排名可以透過一週或一個月的時間進行。

此為 SELECT 子句的必要欄位。WHERE 子句必須指定 reportGranularity 的條件。
reportCountryCode

string

計算排名的國家/地區。以 ISO 3166 格式表示。

此為 SELECT 子句的必要欄位。WHERE 子句必須指定 reportCountryCode 的條件。
reportCategoryId

string (int64 format)

計算排名的 Google 產品類別 ID，以「Google 產品分類」表示。

此為 SELECT 子句的必要欄位。如未在查詢中指定 reportCategoryId 的 WHERE 條件，系統將傳回所有頂層類別的排名。
brand

string

品牌名稱。
rank

string (int64 format)

品牌在 Google Ads 和自然平台上的熱銷程度，排名依據為品牌在所選類別和國家/地區的預估銷售量。
previousRank

string (int64 format)

上週或上個月的熱門程度排名。
relativeDemand

enum (RelativeDemandEnum)

相較於相同國家/地區中，熱銷度排名最高的品牌，預估需求。
previousRelativeDemand

enum (RelativeDemandEnum)

相較於上週或一個月內，熱銷度排名最高的品牌 (例如上週或一個月)，該品牌的預估需求。
relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

預估需求變化。不管是玫瑰、乾燥或保持平坦。

CompetitiveVisibilityCompetitorView

competitiveVisibilityCompetitorView 資料表中可查詢的欄位。

競爭曝光率報表列出曝光率相近的商家。

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

JSON 表示法 
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
欄位
date

object (Date)

此資料列的日期。

WHERE 子句必須指定 date 的條件。
domain

string

競爭對手的網域或您的網域 (如果「isYourDomain」為 true)。

此為 SELECT 子句的必要欄位。無法在 'WHERE' 子句中篩選。
isYourDomain

boolean

如果這一列包含您網域的資料，則為「是」。

無法在 'WHERE' 子句中篩選。
reportCountryCode

string

曝光出現的國家/地區。

此為 SELECT 子句的必要欄位。WHERE 子句必須指定 reportCountryCode 的條件。
reportCategoryId

string (int64 format)

用於計算報表的 Google 產品類別 ID，以「Google 產品分類」表示。

此為 SELECT 子句的必要欄位。WHERE 子句必須指定 reportCategoryId 的條件。
trafficSource

enum (TrafficSourceEnum)

曝光流量來源。

此為 SELECT 子句的必要欄位。
rank

string (int64 format)

根據曝光次數，針對所選鍵 (date、reportCategoryId、reportCountryCode、trafficSource)，網域在相似商家排名中的位置。1 是最高的參數。

無法在 'WHERE' 子句中篩選。
adsOrganicRatio

number

廣告 / 自然比率是指網域從購物廣告獲得曝光的頻率，與自然流量相比。該數字會經過四捨五入並經過值區處理。

無法在 'WHERE' 子句中篩選。
pageOverlapRate

number

「頁面重疊率」是指競爭零售商的商品和你的商品在同一頁面中曝光的頻率。

無法在 'WHERE' 子句中篩選。
higherPositionRate

number

排序率偏高：顯示競爭對手商品在網頁上顯示的頻率高於商品的頻率。

無法在 'WHERE' 子句中篩選。
relativeVisibility

number

「相對曝光率」是指與您產品相比，競爭對手的產品顯示頻率。換句話說，這個數字是指在所選時間範圍內，競爭對手零售商顯示的曝光次數，除以所選產品類別和國家/地區顯示的曝光次數。

無法在 'WHERE' 子句中篩選。

TrafficSourceEnum

流量來源值。

列舉
TRAFFIC_SOURCE_ENUM_UNSPECIFIED 未指定。
ORGANIC 自然流量：
ADS 來自廣告的流量。
ALL 自然流量和廣告流量。

CompetitiveVisibilityTopMerchantView

competitiveVisibilityTopMerchantView 資料表中可查詢的欄位。

「競爭曝光率」報表，顯示曝光率最高的商家。

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

JSON 表示法 
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
欄位
date

object (Date)

此資料列的日期。

無法在 SELECT 子句中選取。WHERE 子句必須指定 date 的條件。
domain

string

競爭對手的網域或您的網域 (如果「isYourDomain」為 true)。

此為 SELECT 子句的必要欄位。無法在 'WHERE' 子句中篩選。
isYourDomain

boolean

如果這一列包含您網域的資料，則為「是」。

無法在 'WHERE' 子句中篩選。
reportCountryCode

string

曝光出現的國家/地區。

此為 SELECT 子句的必要欄位。WHERE 子句必須指定 reportCountryCode 的條件。
reportCategoryId

string (int64 format)

用於計算報表的 Google 產品類別 ID，以「Google 產品分類」表示。

此為 SELECT 子句的必要欄位。WHERE 子句必須指定 reportCategoryId 的條件。
trafficSource

enum (TrafficSourceEnum)

曝光流量來源。

此為 SELECT 子句的必要欄位。
rank

string (int64 format)

根據曝光次數，為所選鍵 (date、reportCategoryId、reportCountryCode、trafficSource) 排名的熱門商家排名。1 是最高的參數。

無法在 'WHERE' 子句中篩選。
adsOrganicRatio

number

廣告 / 自然比率是指網域從購物廣告獲得曝光的頻率，與自然流量相比。該數字會經過四捨五入並經過值區處理。

無法在 'WHERE' 子句中篩選。
pageOverlapRate

number

「頁面重疊率」是指競爭零售商的商品和你的商品在同一頁面中曝光的頻率。

無法在 'WHERE' 子句中篩選。
higherPositionRate

number

排序率偏高：顯示競爭對手商品在網頁上顯示的頻率高於商品的頻率。

無法在 'WHERE' 子句中篩選。

CompetitiveVisibilityBenchmarkView

competitiveVisibilityBenchmarkView 資料表中可查詢的欄位。

包含類別基準的「競爭曝光率」報表。

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

JSON 表示法 
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
欄位
date

object (Date)

此資料列的日期。

此為 SELECT 子句的必要欄位。WHERE 子句必須指定 date 的條件。
reportCountryCode

string

曝光出現的國家/地區。

此為 SELECT 子句的必要欄位。WHERE 子句必須指定 reportCountryCode 的條件。
reportCategoryId

string (int64 format)

用於計算報表的 Google 產品類別 ID，以「Google 產品分類」表示。

此為 SELECT 子句的必要欄位。WHERE 子句必須指定 reportCategoryId 的條件。
trafficSource

enum (TrafficSourceEnum)

曝光流量來源。

此為 SELECT 子句的必要欄位。
yourDomainVisibilityTrend

number

根據所選時間範圍的開始日期 (或第一天放送非零曝光數) 的曝光，根據曝光次數的變化情況做出調整。

無法在 'WHERE' 子句中篩選。
categoryBenchmarkVisibilityTrend

number

針對一組在所選時間範圍起點 (或第一天獲得非零曝光次數)，在市場上曝光率最高的一組商家，顯示曝光率變化。

無法在 'WHERE' 子句中篩選。