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 レポート日。このフィールドの値は、次のいずれかになります。 週次レポートの場合は週の最初の日（月曜日）、 月次レポートの毎月 1 日。 SELECT 句で必須です。クエリで report_date の WHERE 条件が指定されていない場合、利用可能な最新の週次レポートまたは月次レポートが返されます。
report_granularity	ReportGranularityEnum レポートの粒度。ランキングは 1 週間または 1 か月単位で実施できます。 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 レポート日。このフィールドの値は、次のいずれかになります。 週次レポートの場合は週の最初の日（月曜日）、 月次レポートの毎月 1 日。 SELECT 句で必須です。クエリで report_date の WHERE 条件が指定されていない場合、利用可能な最新の週次レポートまたは月次レポートが返されます。
variant_gtins[]	string 商品クラスタの例のバリエーションの GTIN。
report_granularity	ReportGranularityEnum レポートの粒度。ランキングは 1 週間または 1 か月単位で実施できます。 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 商品クラスタが、少なくとも 1 か国の商品データソースで IN_STOCK であるか、すべての国の商品データソースで OUT_OF_STOCK であるか、まったく NOT_IN_INVENTORY であるか。 この項目には、ベストセラー レポートの国のフィルタが適用されません。
brand_inventory_status	InventoryStatus 少なくとも 1 か国の商品データソースに、現在 IN_STOCK であるブランドの商品が 1 つ以上あるか、すべての国の商品データソースにすべての商品が OUT_OF_STOCK であるか、NOT_IN_INVENTORY であるか。 この項目には、ベストセラー レポートの国のフィルタが適用されません。
rank	int64 推定の販売数に基づく、選択したカテゴリと国における広告とオーガニック サーフェスでの商品クラスタの人気度。
previous_rank	int64 前週または前月の人気度ランキング。
relative_demand	RelativeDemandEnum 同一のカテゴリと国で人気ランキング最上位の商品クラスタと比較した際の、推定需要。
previous_relative_demand	RelativeDemandEnum 同一のカテゴリと国で、過去 1 週間または 1 か月間の人気ランキング最上位の商品クラスタと比較した推定需要。
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」が 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」句でフィルタすることはできません。

MarketingMethod

この型にはフィールドがありません。

Google で商品を宣伝するために使用されるマーケティング方法（オーガニック検索と広告）。

MarketingMethodEnum

マーケティング方法の値。

列挙型
MARKETING_METHOD_ENUM_UNSPECIFIED	指定されていません。
ORGANIC	オーガニック マーケティング。
ADS	広告ベースのマーケティング。

NonProductPerformanceView

non_product_performance_view テーブルでクエリに使用できるフィールド。

商品以外のページにつながる画像とオンライン ショップのリンクのパフォーマンス データ。これには、パフォーマンス指標（clicks など）と、パフォーマンス指標がセグメント化されるディメンション（date など）が含まれます。

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

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

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

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

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

フィールド
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	問題により、少なくとも 1 つのレポート コンテキストで商品が不承認になっている。
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

この型にはフィールドがありません。

ベストセラー レポートの粒度。ベストセラー レポートは、1 週間と 1 か月間の期間で計算されます。

ReportGranularityEnum

レポートの粒度値。

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

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 省略可。1 ページで取得する ReportRows の数。デフォルトは 1,000 です。5,000 を超える値は 5,000 に強制変換されます。
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	自然検索と広告のトラフィック。