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

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。

このページには、サポートされているソーステーブルや宛先テーブルのスキーマなど、管理対象の 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	すべてのテーブル