メインコンテンツまでスキップ

Google Search Consoleへの認証を構成する

備考

ベータ版

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

このページでは、Google Search Console コネクタ用に Databricks からの認証を有効にするための Google Search Console の設定方法について説明します。このページのステップで取得した資格情報を使用して、Databricks で Unity Catalog の接続を作成します。

前提条件

Google Search Console コネクタを使用するには、以下が必要です:

  • 1 つ以上の Google Search Console プロパティ(サイト URL)に対する所有権または完全な権限を持つ Google アカウント。
  • Google Cloud Console にアクセスして、プロジェクトの作成、Google Search Console API の有効化、および認証情報の設定を行います。

Google Search Console を設定する

Google Search Console コネクタは、OAuth 2.0 ユーザーマシン間 (U2M) 認証と、サービスアカウントを使用した OAuth 2.0 マシン間 (M2M) 認証の 2 つの認証方法をサポートしています。選択した方法のステップに従ってください。

Google Search Console API を有効にする

資格情報を設定する前に、SaaS (ソフトウェア as a サービス) Google Search Console API を有効にします。

  1. Google Cloud Console に移動してサインインします。
  2. Google Cloud プロジェクトを選択または作成します。
  3. 左側のサイドバーで、 [APIs & サービス] > [ライブラリ] をクリックします。
  4. Google Search Console API を検索してクリックします。
  5. [ 有効にする ]をクリックします。

オプション 1:OAuth U2M(推奨)

対話型サインイン フローを使用して特定のGoogleユーザーとして認証するには、このオプションを使用します。この接続では独自のGoogle IDを使用し、Googleアカウントが所有している、またはフル権限を持つすべてのGoogle Search Consoleプロパティにアクセスできます。

OAuth 2.0 クライアントを作成する

  1. Google Cloud コンソールで、 [APIs & Services] > [Credentials] をクリックします。
  2. 資格情報の作成 > OAuth クライアント ID をクリックします。
  3. OAuth 同意画面の設定を求められた場合は、 同意画面を設定 をクリックします。 外部 を選択し、必要なアプリ名と連絡先Eメールフィールドに入力して、概要ページに到達するまで 保存して続行 をクリックし、その後 ダッシュボードに戻る をクリックします。
  4. 認証情報 > 認証情報の作成 > OAuth クライアント ID に戻ります。
  5. Application typeWeb application を選択します。
  6. クライアントの名前を入力してください。
  7. Authorized redirect URIs 」で、Databricks OAuthリダイレクトURI https://<your-databricks-workspace-url>/login/oauth/http.html を追加します。<your-databricks-workspace-url> を Databricks ワークスペースの URL (例: https://dbc-a1b2c3d4-e5f6.cloud.databricks.com) に置き換えます。
  8. 作成 をクリックします。
  9. 確認ダイアログに表示される クライアントIDクライアントシークレット を控えておいてください。これらは、Databricks で接続を作成する際に入力します。

オプション 2: サービスアカウント (OAuth M2M)

対話型のユーザーサインインを必要としないサーバー間認証には、このオプションを使用します。サービスアカウントは、自動化されたパイプラインに適しています。サービスアカウントが Google Search Console にアクセスする方法は、次の 2 通りです。

  • サービス アカウントは自分自身として認証します。サービスアカウントに各物件へのアクセス権を付与します。ほとんどの場合、こちらを使用してください。
  • ドメイン全体の委任 : サービス アカウントが Google Workspace ユーザーを偽装し、Google Search Console がそのユーザーの既存のアクセス権に対して認証を行います。プロパティが個々のユーザーによって所有されている Google ワークスペース 環境でこれを使用します。

1つ選択してください。サービスアカウントに Search Console プロパティへのアクセス権を付与するドメイン全体の委任を構成するの両方を完了しないでください。

サービス アカウントを作成する

  1. Google Cloud コンソールで、 IAM と管理 > サービス アカウント をクリックします。
  2. サービスアカウント作成 」をクリックします。
  3. サービスアカウントの名前と説明を入力し、作成 して続ける
  4. 役割付与のオプションステップを飛ばして 「完了 」をクリックしてください。
  5. サービス アカウント ページで、作成したサービス アカウントをクリックします。
  6. キー タブで、 キーの追加 > 新しいキーの作成 をクリックします。
  7. JSON を選択し、 作成 をクリックします。ブラウザがサービスアカウントキーファイルをダウンロードします。
  8. JSON キーファイルを安全に保存してください。Databricks で接続を作成する際に、その内容を入力します。

サービスアカウントにSearch Consoleプロパティへのアクセス権を付与する

このステップは、サービス アカウントが 独自の ID として認証される場合(つまり、接続の作成時に 偽装するユーザーの Eメール を空のままにする場合)にのみ実行してください。代わりにドメイン全体の委任を使用する場合は、ドメイン全体の委任を構成するまでスキップしてください。その場合、Google Search Console はサービス アカウントではなく偽装されたユーザーのアクセス権に対して認証を行うため、このステップは無効です。

  1. Googleサーチコンソールに行きサインインしてください。
  2. プロパティ(サイトURL)を選択します。
  3. 左のサイドバーで、 [設定] > [ユーザーと権限] をクリックします。
  4. [ ユーザーを追加 ]をクリックします。
  5. サービスアカウントのメールアドレス( name@project-id.iam.gserviceaccount.comの形式)を入力してください。
  6. 権限を Full に設定し、[ 追加 ] をクリックします。
  7. パイプラインが取り込む追加のプロパティごとに繰り返します。

(オプション)ドメイン全体の委任を構成する

サービス アカウントがすでにプロパティを所有している Google Workspace ユーザーを偽装するようにする場合は、サービス アカウントに直接アクセス権を付与する代わりに、このステップを完了してください。これには、Google Workspace のスーパー管理者アクセス権が必要です。手順の詳細については、Google ドキュメントの「Set up domain-wide delegation」を参照してください。

  1. Google Cloud コンソールの サービス アカウント ページで、作成したサービス アカウントをクリックし、[ 詳細設定を表示 ] をクリックします。
  2. Domain-wide delegation 」で、サービス アカウントの「 Client ID 」をコピーします。
  3. Google ワークスペース のスーパー管理者として、管理コンソールに移動し、 セキュリティ > アクセスとデータ制御 > API の制御 に移動します。
  4. Manage Domain Wide Delegation をクリックし、 新規追加 をクリックします。
  5. クライアント ID フィールドに、コピーしたクライアント ID を貼り付けます。
  6. OAuthスコープ フィールドに https://www.googleapis.com/auth/webmasters.readonly を入力します。
  7. [許可] をクリックします。
  8. 偽装する Google ワークスペース ユーザーの Eメールアドレスを控えておきます。このユーザーが、パイプラインが取り込むプロパティの所有者であるか、フル権限を持っていることを確認してください。Databricks で接続を作成する際、この Eメールを 偽装するユーザーの Eメール フィールドに入力します。

次のステップ

Databricks で Google Search Console 接続を作成します。Google Search Console 接続の作成を参照してください。