メインコンテンツまでスキップ
に最終更新

Google Search Console コネクタのトラブルシューティング

備考

ベータ版

この機能はベータ版です。使用するには、ワークスペース管理者は、 プレビュー ページから Lakeflow Connect for Google Search Console を有効にする必要があります。Databricks previews を管理するを参照してください。

このページでは、管理されるGoogleサーチコンソールコネクタでよくあるエラーとその解決方法について説明します。

すべてのマネージド インジェスト パイプラインに適用される一般的なトラブルシューティングのガイダンスについては、「マネージド インジェスト パイプラインのトラブルシューティング」を参照してください。

Search アナリティクス の QPS クォータを超過しました​

エラーメッセージ：

Google Search Console Search Analytics QPS quota exceeded. Retrying with backoff.

原因： パイプラインが短期間に Google Search Console Search アナリティクス API へリクエストを送信しすぎたため、Google のユーザー単位、秒単位の割り当て制限に達しました。

ソリューション:

このエラーが発生すると、コネクタはバックオフを使用して自動的に再試行します。パイプラインの失敗が続く場合は、単一のパイプラインで取り込まれるサイトURLまたはテーブルの数を減らすか、パイプラインのラン間のスケジュール間隔を長くして、APIリクエストの全体的なボリュームを削減してください。

アクセスが拒否されました (403)​

エラーメッセージ：

パイプラインがHTTP 403応答で失敗し、そのエラーは設定エラーとして分類されます。

原因: 認証済みのアイデンティティ(サービスアカウントまたはOAuthユーザー)は、1つ以上のGoogleサーチコンソールプロパティに対して十分な権限を持っていません。これは、IDがプロパティの検証済み所有者または完全な権限を持つユーザーでない場合、あるいはドメイン全体の委任設定が誤っている場合に発生します。

ソリューション:

サービスアカウントのEメールまたはOAuthユーザーが、site_urlsで指定された各サイトURLに対して フル 権限を持っていることを確認してください。Google Search Consoleでアクセス権を付与する手順については、「Google Search Consoleへの認証を構成する」を参照してください。

ドメイン全体の委任が設定されたサービスアカウントを使用する場合は、以下を確認してください。

  • 接続内の User Email to Impersonate (偽装するユーザーの E メール) フィールドでは、プロパティを所有しているか、プロパティへのフルアクセス権を持つアカウントを使用します。
  • https://www.googleapis.com/auth/webmasters.readonly スコープは、サービスアカウントのクライアントIDに対して Google ワークスペース 管理コンソールで承認されています。

認証情報を更新するには、カタログエクスプローラ で接続を編集します。Google Search Console 接続の作成を参照してください。

無効なリクエスト（400）​

エラーメッセージ：

パイプラインが HTTP 400 レスポンスで失敗し、エラーが構成エラーとして分類されています。

原因: Google Search Console Search アナリティクス API がレポート要求を拒否しました。一般的な原因は、aggregation_type が byProperty であり、dimensions に page が含まれているか、search_types に discover または googleNews が含まれている custom_report オブジェクトです。

ソリューション:

byProperty を使用する custom_report オブジェクトの場合、dimensions から page を削除し、search_types から discover および googleNews を削除するか、aggregation_type を auto または byPage に設定します。カスタムレポートを参照してください。

無効なコネクタオプション値​

エラーメッセージ：

Text
Invalid connector_options option '<option-name>' for source 'google_search_console': expected array<string>. <reason>
Text
Invalid connector_options option '<option-name>' for source 'google_search_console': value '<value>' is not one of <allowed-values>.

原因： コネクタは、Google Search Console にリクエストを送信する前にコネクタオプションを検証します。dimensions または search_types の値は、以下の場合にバリデーションに失敗します。

  • 有効なJSON形式の文字列の配列ではありません。
  • 空の配列です。
  • 同じ値を複数回リストします。
  • オプションで許可されていない値が含まれています。

ソリューション:

dimensions と search_types を、許容される各値を最大1回リストするJSON配列文字列に設定します。たとえば '["country", "device"]' です。許容される値については、 コネクタ オプションを参照してください。例については、 例を参照してください。

アクセストークンの有効期限が切れました (401)​

エラーメッセージ：

パイプラインがHTTP 401応答で失敗します。

原因: 接続で使用されたアクセストークンの有効期限が切れたか、取り消されました。

ソリューション:

コネクターは401応答を受信すると自動的にOAuthトークンを更新します。エラーが続く場合は、更新トークンが取り消された可能性があります。カタログエクスプローラーで接続を編集し、再度サインインフローを完了することで、再認証を行ってください。「 Google Search Console 接続を作成する」をご覧ください。

サービスアカウント接続の場合は、接続内のサービスアカウントキー JSON が有効であり、Google Cloud コンソールで削除されていないことを確認してください。必要に応じて新しいキーをdownloadし、接続を更新してください。

一時的なサーバーエラー (500、502、503、504)​

エラーメッセージ：

パイプラインが HTTP 500、502、503、または 504 レスポンスで失敗します。

原因: Google Search Console API が一時的なサーバーエラーを返しました。これらのエラーは一時的なものであり、資格情報やパイプライン設定とは無関係です。

ソリューション:

コネクタは、一時的なエラーに対してエクスポネンシャル バックオフを使用して自動的に再試行します。再試行後もパイプラインが失敗し続ける場合は、Google ワークスペース ステータス ダッシュボードで Google Search Console の進行中のインシデントがないか確認してください。インシデントが報告されていない場合は、パイプラインを手動で再実行してください。

このページの見出し