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 など）は、インプレッション時の商品の状態を表します。

クエリでセグメント フィールドを選択するには、少なくとも 1 つの指標フィールドも選択する必要があります。

値は、リクエストの検索クエリで明示的にリクエストされたフィールドにのみ設定されます。

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 など）が含まれます。

クエリでセグメント フィールドを選択するには、少なくとも 1 つの指標フィールドも選択する必要があります。

値は、リクエストの検索クエリで明示的にリクエストされたフィールドにのみ設定されます。

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 の商品と同じですが、Products サブ 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 問題により、少なくとも 1 つのレポート コンテキストで商品が不承認になっています。
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)

レポートの日付。このフィールドの値は、次のいずれかになります。

  • 週次レポートの場合は週の最初の日（月曜日）、
  • 月次レポートの毎月 1 日。

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)

商品クラスタが、少なくとも 1 か国の商品データソースで IN_STOCK であるか、すべての国の商品データソースで OUT_OF_STOCK であるか、まったく NOT_IN_INVENTORY であるか。

この項目には、ベストセラー レポートの国のフィルタが適用されません。
brandInventoryStatus

enum (InventoryStatus)

少なくとも 1 つの国の商品データソースに、現在 IN_STOCK であるブランドの商品が 1 つ以上あるかどうか、すべての国の商品データソースにすべての商品が OUT_OF_STOCK であるか NOT_IN_INVENTORY であるか。

この項目には、ベストセラー レポートの国のフィルタが適用されません。
rank

string (int64 format)

推定の販売数に基づく、選択したカテゴリと国における広告とオーガニック サーフェスでの商品クラスタの人気度。
previousRank

string (int64 format)

前週または前月の人気度ランキング。
relativeDemand

enum (RelativeDemandEnum)

同一のカテゴリと国で人気ランキング最上位の商品クラスタと比較した際の、推定需要。
previousRelativeDemand

enum (RelativeDemandEnum)

同一のカテゴリと国で、過去 1 週間または 1 か月間の人気ランキング最上位の商品クラスタと比較した推定需要。
relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

推定需要の変化。上昇、下落、横ばいのいずれか。

ReportGranularityEnum

レポートの粒度値。

列挙型
REPORT_GRANULARITY_ENUM_UNSPECIFIED 指定されていません。
WEEKLY レポートは 1 週間の期間で計算されます。
MONTHLY レポートは 1 か月単位で計算されます。

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)

レポートの日付。このフィールドの値は、次のいずれかになります。

  • 週次レポートの場合は週の最初の日（月曜日）、
  • 月次レポートの毎月 1 日。

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」句でフィルタすることはできません。

メソッド
検索クエリで定義されたレポートを取得します。