Google Search Console コネクタ リファレンス

備考

ベータ版

This feature is in Beta.To use it, a ワークスペース admin must turn on Lakeflow Connect for Google Search Console from the Previews page.See Manage Databricks previews.

このページには、サポートされているソーステーブルや宛先テーブルのスキーマなど、管理対象の Google Search Console コネクタに関する参照情報が記載されています。

サポートされているソーステーブル

Google Search Console コネクタは、default ソーススキーマ配下の 14 個のソーステーブルをサポートしており、これらは 2 つのカテゴリに分類されます。

• サイトテーブル :認証済みのGoogleサーチコンソールプロパティおよびそのサイトマップに関するメタデータ。パイプラインの実行ごとに完全にリフレッシュしています。
• 検索パフォーマンスレポートテーブル ：Google Search Console Search Analytics APIからのクリック数、表示回数、CTR、および掲載順位のメトリクス。各テーブルは、同じ基盤データに対する異なるディメンションスライスを表します。日付または時間単位で増分同期されます。

注記

Google Search Consoleコネクタは、カスタム検索アナリティクス レポート テーブルをまだサポートしていません。構築済みのテーブルでカバーされていないディメンションの組み合わせが必要な場合は、Databricksアカウントチームにお問い合わせください。

サイトテーブル

これらのテーブルには、検証済みの Google Search Console プロパティに関するメタデータが含まれています。これらには検索パフォーマンスのメトリクスは含まれておらず、パイプラインのランごとに完全に更新されます。

ソーステーブル	プライマリーキー	説明	同期モード
sites	site_url	権限レベルを含む、Google Search Consoleに登録された検証済みサイトプロパティ。	フル更新のみ
sitemaps	site_url, path	検証済みの各プロパティについて Google Search Console に送信されたサイトマップ。	フル更新のみ

ソーステーブル	プライマリーキー	説明	同期モード
sites	site_url	権限レベルを含む、Google Search Consoleに登録された検証済みサイトプロパティ。	フル更新のみ
sitemaps	site_url, path	検証済みの各プロパティについて Google Search Console に送信されたサイトマップ。	フル更新のみ

パフォーマンス レポート テーブルを検索

これらのテーブルには、Google Search Console Search アナリティクス API からのクリック、インプレッション、CTR、および掲載順位のデータが含まれています。すべてのテーブルが増分同期されます。

各テーブルは同じ4つのメトリクス(clicks、 impressions、 ctr、 position)を返しますが、データが集計される次元やGoogleが結果を返す前に適用する aggregationType が異なります。

集計タイプの理解

aggregationType は、URL が複数の検索結果タイプに表示される場合に Google がどのようにクリックを重複排除するかを制御します。タイプごとに重複排除の方法が異なるため、集計タイプが異なるテーブル間でのクリック合計は、同じ日付範囲であっても互いに一致せず、Google Search Console UI とも一致しません。詳細については、Google Search Console API ドキュメントを参照してください。

日次検索パフォーマンステーブル

これらのテーブルは、検索パフォーマンスデータを暦日単位で集計します。カーソルフィールドは date です。

ソーステーブル	ディメンション	集計タイプ	検索タイプ	プライマリーキー	カーソルフィールド
search_analytics_all_fields	日付、国、デバイス、ページ、クエリー	自動	Web、ニュース、画像、動画	site_url、date、country、device、page、query、 search_type	date
search_analytics_by_country	日付、国	自動	ウェブ、ニュース、画像、動画、発見、Google ニュース	site_url、date、country、 search_type	date
search_analytics_by_date	日付	自動	ウェブ、ニュース、画像、動画、発見、Google ニュース	site_url、date、 search_type	date
search_analytics_by_device	日付、デバイス	自動	ウェブ、ニュース、画像、動画、googleNews	site_url、date、device、 search_type	date
search_analytics_by_page	日付、ページ	自動	ウェブ、ニュース、画像、動画、発見、Google ニュース	site_url、date、page、 search_type	date
search_analytics_by_query	日付、クエリー	自動	Web、ニュース、画像、動画	site_url、date、query、 search_type	date
search_analytics_page_report	日付、国、デバイス、ページ	自動	ウェブ、ニュース、画像、動画、googleNews	site_url、date、country、device、page、 search_type	date
search_analytics_site_report_by_page	日付、国、デバイス	ページ単位	ウェブ、ニュース、画像、動画、googleNews	site_url、date、country、device、 search_type	date
search_analytics_site_report_by_site	日付、国、デバイス	byProperty	Web、ニュース、画像、動画	site_url、date、country、device、 search_type	date

ソーステーブル	ディメンション	集計タイプ	検索タイプ	プライマリーキー	カーソルフィールド
search_analytics_all_fields	日付、国、デバイス、ページ、クエリー	自動	Web、ニュース、画像、動画	site_url、date、country、device、page、query、 search_type	date
search_analytics_by_country	日付、国	自動	ウェブ、ニュース、画像、動画、発見、Google ニュース	site_url、date、country、 search_type	date
search_analytics_by_date	日付	自動	ウェブ、ニュース、画像、動画、発見、Google ニュース	site_url、date、 search_type	date
search_analytics_by_device	日付、デバイス	自動	ウェブ、ニュース、画像、動画、googleNews	site_url、date、device、 search_type	date
search_analytics_by_page	日付、ページ	自動	ウェブ、ニュース、画像、動画、発見、Google ニュース	site_url、date、page、 search_type	date
search_analytics_by_query	日付、クエリー	自動	Web、ニュース、画像、動画	site_url、date、query、 search_type	date
search_analytics_page_report	日付、国、デバイス、ページ	自動	ウェブ、ニュース、画像、動画、googleNews	site_url、date、country、device、page、 search_type	date
search_analytics_site_report_by_page	日付、国、デバイス	ページ単位	ウェブ、ニュース、画像、動画、googleNews	site_url、date、country、device、 search_type	date
search_analytics_site_report_by_site	日付、国、デバイス	byProperty	Web、ニュース、画像、動画	site_url、date、country、device、 search_type	date

毎時の検索パフォーマンス テーブル

これらのテーブルは、検索パフォーマンスデータを時間単位で集計します。これらは常に hourly_all データ状態を使用し、data_state コネクタオプションの影響を受けません。カーソルフィールドは hour です。利用可能な検索タイプは web および googleNews に限定されています。

ソーステーブル	ディメンション	集計タイプ	検索タイプ	プライマリーキー	カーソルフィールド
hourly_search_analytics_page_report	時間、国、デバイス、ページ	自動	Web、googleNews	site_url、hour、country、device、page、 search_type	hour
hourly_search_analytics_site_report_by_page	時間、国、デバイス	ページ単位	Web、googleNews	site_url、hour、country、device、 search_type	hour
hourly_search_analytics_site_report_by_site	時間、国、デバイス	byProperty	Web、googleNews	site_url、hour、country、device、 search_type	hour

ソーステーブル	ディメンション	集計タイプ	検索タイプ	プライマリーキー	カーソルフィールド
hourly_search_analytics_page_report	時間、国、デバイス、ページ	自動	Web、googleNews	site_url、hour、country、device、page、 search_type	hour
hourly_search_analytics_site_report_by_page	時間、国、デバイス	ページ単位	Web、googleNews	site_url、hour、country、device、 search_type	hour
hourly_search_analytics_site_report_by_site	時間、国、デバイス	byProperty	Web、googleNews	site_url、hour、country、device、 search_type	hour

コネクターのオプション

Google Search Console コネクタは、以下の構成オプションをサポートしています。使用方法については、例を参照してください。

オプション	Type	スコープ	必須	適用対象	説明
site_urls	JSON形式の文字列の配列	パイプライン	はい	すべてのテーブル	取り込む、検証済みの Google Search Console プロパティ URL（1つ以上）。各 URL は、Google Search Console で検証済みのプロパティである必要があります（例：https://example.com/ または sc-domain:example.com）。
start_date	文字列 (yyyy-MM-dd)	パイプライン	No	すべての増分テーブル (search_analytics_*、hourly_search_analytics_*)	データを取り込む最も早い日付（yyyy-MM-dd形式）。最初の同期の500日前がdefault。sites または sitemaps（フル更新）には影響しません。
data_state	String	テーブル	No	日次検索パフォーマンステーブルのみ (search_analytics_*)	日次検索パフォーマンス テーブルのデータの鮮度。all (default) には、確定データと最新データが含まれます。final には確定データのみが含まれます。search_analytics_* オブジェクトに対してのみ設定してください。sites、sitemaps、および hourly_search_analytics_* テーブルでは、このオプションは使用できません。

オプション	Type	スコープ	必須	適用対象	説明
site_urls	JSON形式の文字列の配列	パイプライン	はい	すべてのテーブル	取り込む、検証済みの Google Search Console プロパティ URL（1つ以上）。各 URL は、Google Search Console で検証済みのプロパティである必要があります（例：https://example.com/ または sc-domain:example.com）。
start_date	文字列 (yyyy-MM-dd)	パイプライン	No	すべての増分テーブル (search_analytics_*、hourly_search_analytics_*)	データを取り込む最も早い日付（yyyy-MM-dd形式）。最初の同期の500日前がdefault。sites または sitemaps（フル更新）には影響しません。
data_state	String	テーブル	No	日次検索パフォーマンステーブルのみ (search_analytics_*)	日次検索パフォーマンス テーブルのデータの鮮度。all (default) には、確定データと最新データが含まれます。final には確定データのみが含まれます。search_analytics_* オブジェクトに対してのみ設定してください。sites、sitemaps、および hourly_search_analytics_* テーブルでは、このオプションは使用できません。

宛先テーブルのスキーマ

sites

主キー: site_url 同期モード: フル更新のみ

フィールド	データ型
site_url	STRING
permission_level	STRING

フィールド	データ型
site_url	STRING
permission_level	STRING

sitemaps

プライマリキー: site_url、path 同期モード: 完全更新のみ

フィールド	データ型
site_url	STRING
path	STRING
last_submitted	STRING
is_pending	BOOLEAN
is_sitemaps_index	BOOLEAN
type	STRING
last_downloaded	STRING
warnings	BIGINT
errors	BIGINT
contents	ARRAY<STRUCT<type: STRING, submitted: BIGINT, indexed: BIGINT>>

フィールド	データ型
site_url	STRING
path	STRING
last_submitted	STRING
is_pending	BOOLEAN
is_sitemaps_index	BOOLEAN
type	STRING
last_downloaded	STRING
warnings	BIGINT
errors	BIGINT
contents	ARRAY<STRUCT<type: STRING, submitted: BIGINT, indexed: BIGINT>>

search_analytics_all_fields

ディメンション： date、country、device、page、query 集計タイプ： auto 検索タイプ： web、news、image、video 主キー： site_url、date、country、device、page、query、search_type カーソルフィールド： date

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
country	STRING
device	STRING
page	STRING
query	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
country	STRING
device	STRING
page	STRING
query	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

search_analytics_by_country

ディメンション： date、country 集計タイプ： auto 検索タイプ： web、news、image、video、discover、googleNews 主キー： site_url、date、country、search_type カーソルフィールド： date

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
country	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
country	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

search_analytics_by_date

ディメンション： date 集計タイプ： auto 検索タイプ： web、news、image、video、discover、googleNews プライマリキー： site_url、date、search_type カーソルフィールド： date

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

search_analytics_by_device

ディメンション: date、device 集計タイプ: auto 検索タイプ: web、news、image、video、googleNews 主キー: site_url、date、device、search_type カーソルフィールド: date

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

search_analytics_by_page

ディメンション： date、page 集計タイプ： auto 検索タイプ： web、news、image、video、discover、googleNews 主キー： site_url、date、page、search_type カーソルフィールド： date

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
page	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
page	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

search_analytics_by_query

ディメンション： date、query 集計タイプ： auto 検索タイプ： web、news、image、video プライマリキー： site_url、date、query、search_type カーソルフィールド： date

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
query	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
query	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

search_analytics_page_report

ディメンション: date、country、device、page 集計タイプ: auto 検索タイプ: web、news、image、video、googleNews 主キー: site_url、date、country、device、page、search_type カーソルフィールド: date

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
country	STRING
device	STRING
page	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
country	STRING
device	STRING
page	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

search_analytics_site_report_by_page

ディメンション: date、country、device 集計タイプ: byPage 検索タイプ: web、news、image、video、googleNews 主キー: site_url、date、country、device、search_type カーソルフィールド: date

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

search_analytics_site_report_by_site

寸法: date 、 country 、 device 集計タイプ: プロパティ別 検索タイプ： ウェブ、ニュース、画像、動画 プライマリキー: site_url 、 date 、 country 、 device 、 search_type カーソルフィールド: date

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

フィールド	データ型
site_url	STRING
search_type	STRING
date	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

hourly_search_analytics_page_report

寸法: hour 、 country 、 device 、 page 集計タイプ: 自動 検索タイプ： ウェブ、Googleニュース プライマリキー: site_url 、 hour 、 country 、 device 、 page 、 search_type カーソルフィールド: hour

フィールド	データ型
site_url	STRING
search_type	STRING
hour	STRING
country	STRING
device	STRING
page	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

フィールド	データ型
site_url	STRING
search_type	STRING
hour	STRING
country	STRING
device	STRING
page	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

hourly_search_analytics_site_report_by_page

ディメンション： hour、country、device 集計タイプ： byPage 検索タイプ： web、googleNews 主キー： site_url、hour、country、device、search_type カーソルフィールド： hour

フィールド	データ型
site_url	STRING
search_type	STRING
hour	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

フィールド	データ型
site_url	STRING
search_type	STRING
hour	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

hourly_search_analytics_site_report_by_site

ディメンション: hour、country、device 集計タイプ: byProperty 検索タイプ: web、googleNews 主キー: site_url、hour、country、device、search_type カーソルフィールド: hour

フィールド	データ型
site_url	STRING
search_type	STRING
hour	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

フィールド	データ型
site_url	STRING
search_type	STRING
hour	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

必要なOAuth権限

Google Search Consoleコネクタは、https://www.googleapis.com/auth/webmasters.readonlyスコープをリクエストします。このスコープは、認証されたIDがアクセス権を持つプロパティのすべてのGoogle Search Consoleデータに対する読み取り専用アクセス権を付与します。

権限	必須：
https://www.googleapis.com/auth/webmasters.readonly	すべてのテーブル

権限	必須：
https://www.googleapis.com/auth/webmasters.readonly	すべてのテーブル