Googleサービスアカウントの設定

Googleサービスアカウントを作成し、Search ConsoleとAnalytics APIを有効化し、JSONキーを1MarketingToolに接続します。

1MarketingToolで個人のGoogleアカウントを経由せずにSearch ConsoleとGA4のデータを読み取りたい場合は、Googleサービスアカウントを使用します。

クイックCloud Shellフローを選択するか、手動でGoogle Cloud Consoleの手順に従ってください。

Cloud Shellでクイックセットアップ

Cloud Shellはブラウザ内で実行され、すでにGoogleアカウントにサインインされています。Cloud Shellを開き、スクリプトを貼り付けてEnterキーを押すと、完了時にkey.jsonがダウンロードされます。その後、1MarketingToolの「JSONをインポート」を使用してダウンロードしたキーを読み込み、保存してください。

set -e
PROJECT_ID=$(gcloud config get-value project 2>/dev/null)
if [ -z "$PROJECT_ID" ]; then
  PROJECT_ID="marketing-tool-$RANDOM$RANDOM"
  gcloud projects create "$PROJECT_ID" --set-as-default
fi
gcloud services enable iam.googleapis.com searchconsole.googleapis.com analyticsadmin.googleapis.com \
  analyticsdata.googleapis.com indexing.googleapis.com --project "$PROJECT_ID"
SA_EMAIL="marketing-tool@$PROJECT_ID.iam.gserviceaccount.com"
gcloud iam service-accounts create marketing-tool --display-name "1MarketingTool" --project "$PROJECT_ID" || true
echo "Waiting for the service account to be ready..."
for i in $(seq 1 30); do
  gcloud iam service-accounts describe "$SA_EMAIL" --project "$PROJECT_ID" >/dev/null 2>&1 && break
  sleep 2
done
rm -f key.json
gcloud iam service-accounts keys create key.json --iam-account "$SA_EMAIL" --project "$PROJECT_ID"
cloudshell download key.json
echo "Grant read access in Search Console and GA4 to: $SA_EMAIL"

1. Google Cloudプロジェクトを作成する

Google Cloud Consoleを開き、上部のプロジェクトドロップダウンを使用して新しいプロジェクトを選択します。このワークスペース用に既存のプロジェクトがある場合は、それを再利用することもできます。

プロジェクトにmarketing-toolのような分かりやすい名前を付けて、作成をクリックします。

続行する前に、上部バーで新しいプロジェクトが選択されていることを確認してください。

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

APIとサービス -> 認証情報に移動し、認証情報を作成 -> サービスアカウントを選択します。

marketing-tool-readerのような名前を入力します。Googleはその名前からサービスアカウントIDとメールアドレスを生成します。作成して続行をクリックします。

Google Cloudプロジェクトのロールの付与はスキップできます。Search ConsoleとGA4へのアクセスは、後で各製品内で付与します。完了をクリックします。

サービスアカウントのメールをコピーします。[email protected]のような形式です。このメールはSearch ConsoleとAnalyticsへのアクセスを付与する際に使用します。

3. JSONキーをダウンロードする

サービスアカウントを開き、キータブに切り替えて、キーを追加 -> 新しいキーを作成を選択します。

JSONを選択し、作成をクリックします。.jsonファイルがお使いのコンピュータにダウンロードされます。このファイルは認証情報なので、秘密に保管してください。

4. 必要なAPIを有効化する

Google Cloud ConsoleでAPIとサービス -> ライブラリを開き、Google Search Console APIを検索します。

Google Search Console APIを選択します。

選択したプロジェクトに対して有効にするをクリックします。

APIライブラリに戻り、Google Analytics Data APIを検索して有効化します。このAPIはGA4レポートに必要です。

オプションでGoogle Analytics Admin APIも有効化します。これにより、接続されたワークフローでサポートされている場合にアプリがGA4プロパティを一覧表示できるようになります。

5. Search Consoleでアクセスを付与する

Google Search Consoleを開き、接続したいプロパティを選択して、設定 -> ユーザーと権限 -> ユーザーを追加に移動します。

手順2でコピーしたサービスアカウントのメールを貼り付けます。フルまたは制限付きの権限を選択し、追加をクリックします。

6. Google Analyticsでアクセスを付与する

Google Analyticsを開き、管理をクリックして、正しいGA4プロパティを選択します。

プロパティへのアクセス管理に移動し、+をクリックして、サービスアカウントのメールを追加します。閲覧者またはアナリストのアクセスを使用し、追加をクリックします。

7. 1MarketingToolで接続する

1MarketingToolでGoogleプロバイダーまたはインテグレーション設定を開き、先にダウンロードしたJSONキーファイルをインポートします。

保存後、アプリ内でSearch ConsoleまたはGA4プロパティを適切なプロジェクトにマッピングします。

注意事項

Search ConsoleまたはGA4のデータがすぐに表示されない場合は、少し待ってから再試行してください。Googleの権限が反映されるまでに数分かかることがあります。
1つのサービスアカウントを必要な数のSearch ConsoleとGA4プロパティに追加し、1MarketingTool内でプロジェクトごとにマッピングできます。
Google CloudでJSONキーをローテーションまたは削除した場合は、アプリで新しいキーをインポートしてください。
JSONキーは安全に保管し、ソース管理にコミットしないでください。