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 の概要をご覧ください。

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 Google の商品分類で表される、商品クラスタの商品カテゴリ（第 1 レベル）。
category_l2	string Google の商品分類で表される、商品クラスタの商品カテゴリ（第 2 レベル）。
category_l3	string Google の商品分類で表される、商品クラスタの商品カテゴリ（第 3 レベル）。
category_l4	string Google の商品分類で表される、商品クラスタの商品カテゴリ（第 4 レベル）。
category_l5	string Google の商品分類で表される、商品クラスタの商品カテゴリ（第 5 レベル）。
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 先週または先月の、同じカテゴリと国で最も人気ランクの高い商品クラスタとの比較で予測される需要。
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 で 1 つの商品を取得する、またはすべての商品を一覧表示するには、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	オーガニック トラフィックと広告トラフィック。