Google APIの導入・使用手順（GA4・サチコ）

2025年3月4日 最終更新日時 : 2025年3月4日 rd_wiki@admin

前提条件

  • Google アカウント を持っており、GA4 プロパティや Search Console サイトの管理権限がある
  • Google Cloud プロジェクト が用意されている（新規作成でもOK）
  • API を有効化・認証情報を作成できる権限（オーナーまたは編集者）を持っている

1. 共通の手順

1-1. Google Cloud プロジェクトを準備

  1. Google Cloud Console にアクセス
  2. 既存のプロジェクトを選択、または「プロジェクトを作成」で新規作成
  3. プロジェクトが選択された状態を確認

ポイント: どちらの API も、同じプロジェクトで有効化して構いません。

1-2. API を有効化

  1. 左メニューの「APIとサービス」 > 「ライブラリ」
  2. GA4 Data API を検索して「有効にする」
  3. Search Console API を検索して「有効にする」

ポイント:

  • GA4 Data API を使う場合、必要に応じて「Google Analytics Admin API」も有効化しておくと、プロパティ管理操作が可能。
  • Search Console API は単独でOK。

1-3. 認証情報（Credentials）の作成

  1. 「APIとサービス」>「認証情報」へ移動
  2. 「+ 認証情報を作成」ボタンを押す
    • サービスアカウント: サーバーサイド・バッチなど自動処理向け
    • OAuth クライアントID: ユーザーごとにGoogleログインが必要なWebアプリ向け
  3. 作成後、必要に応じてJSONキーをダウンロード（サービスアカウントの場合）

ポイント:

  • サービスアカウントの場合、GA4 / Search Console 側でサービスアカウントに権限を付与する必要あり
  • OAuth クライアントIDの場合、ユーザーがログインして同意するフローになる

1-4. 実際の呼び出し方法

  • Google APIs Explorer や 公式クライアントライブラリ（Python, Node.js, etc.）を利用
  • サービスアカウントで呼ぶ場合は、取得したJSONキーを使ってトークンを取得し、APIにリクエスト
  • OAuth クライアントIDの場合は、ユーザーが認可を与えた後のアクセストークンを使ってAPIを呼ぶ

ポイント:

  • まずは Google APIs Explorer で簡易テストすると理解しやすい
  • 本番運用ではサーバーサイドのコードで自動化・定期実行するケースが多い

2. GA4 Data API 特有のポイント

2-1. GA4 側の権限設定

  1. GA4（Google Analytics）の管理画面を開く
  2. 左下「歯車アイコン（管理）」 > 「プロパティアクセス管理」
  3. 「ユーザーを追加」から、サービスアカウント または 使用するGoogleアカウント を登録し、「閲覧者」以上の権限を付与

プロパティID は数値のみ（例: 123456789）を確認し、API では properties/123456789 の形式で指定。

2-2. テストでページビューを取得する例

  1. Google APIs Explorer を開く
  2. 「Analytics Data API」を選択し、properties.runReport メソッドを探す
  3. property に properties/<GA4プロパティID> を入力
  4. Request body の例:json
    コピーする
    { "dateRanges": [ { "startDate": "2023-01-01", "endDate": "2023-01-31" } ], "dimensions": [ { "name": "pagePath" } ], "metrics": [ { "name": "screenPageViews" } ] }
  5. 「Execute」して OAuth 認証
  6. レスポンスにページパスとページビュー数が JSON で返る

メトリック名に注意: GA4 では screenPageViews がページビュー相当。UA の pageviews は使えない。

3. Search Console API 特有のポイント

3-1. Search Console 側のサイト所有権確認

  1. Search Console でサイトを登録し、所有権を確認済みにしておく
  2. サービスアカウントで呼ぶ場合は、Search Console の「設定 > ユーザーと権限」からサービスアカウントに権限を付与

ポイント:

  • 所有権がないサイトはデータが取得できない
  • URLプレフィックスプロパティ / ドメインプロパティ いずれかでOK

3-2. テストでクエリパフォーマンスを取得する例

  1. Google APIs Explorer を開く
  2. 「Search Console API」を選択し、searchanalytics.query メソッドを探す
  3. Request body の例:json
    コピーする
    { "startDate": "2023-01-01", "endDate": "2023-01-31", "dimensions": ["query"], "rowLimit": 10 }
    siteUrl には "https://example.com/" のように、Search Console に登録したサイトURLを指定
  4. 「Execute」して OAuth 認証
  5. レスポンスにクエリごとのクリック数・表示回数などが返る

ポイント:

  • URLの形式（https://含むかどうか）に注意
  • 大文字・小文字や末尾スラッシュなどが Search Console 登録時と一致していないとエラーになる

4. まとめ

  1. 共通作業
    • Google Cloud プロジェクトの用意
    • 対象API（GA4 Data API / Search Console API）を有効化
    • 認証情報を作成（サービスアカウント or OAuth クライアントID）
  2. GA4 / Search Console 側の設定
    • GA4 プロパティアクセス管理でユーザー or サービスアカウントに権限付与
    • Search Console でサイト所有権を確認し、ユーザー or サービスアカウントに権限付与
  3. テスト呼び出し
    • Google APIs Explorer で runReport（GA4）、searchanalytics.query（Search Console） を試す
    • 正常にデータが返れば設定完了
  4. 実装・自動化
    • 公式クライアントライブラリ（Python 等）でサービスアカウントの JSON キーを使い、定期レポートやダッシュボード化が可能
前の記事
GTM設定手順
2025年2月13日
次の記事
GA4 API 利用ガイド
2025年3月4日