REST Resource: accounts.reports

資源：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 表格中查詢的欄位。

目前商品目錄中的產品。這個表格中的產品與產品子 API 中的產品相同，但並非所有產品子 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 審查解決。商家目前無須採取任何行動。解決問題可能會導致其他問題 (例如檢索失敗)。

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

產品叢集的子類範例 GTIN。
reportGranularity

enum (ReportGranularityEnum)

報表的精細程度。排名可在 1 週或 1 個月的時間內完成。

必須在 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)

產品叢集在廣告和自然曝光面向的熱銷程度，排名依據為產品在所選類別和國家/地區的預估銷量。
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)

報表的精細程度。排名可在 1 週或 1 個月的時間內完成。

必須在 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)

品牌在廣告和自然曝光面向的熱銷度，排名依據為品牌在所選類別和國家/地區的預估銷量。
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

如果這個資料列包含貴機構網域的資料，則為 True。

無法在「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

如果這個資料列包含貴機構網域的資料，則為 True。

無法在「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」子句中篩選。

方法
擷取由搜尋查詢定義的報表。