Google Ads API を使う手順【後編】OAuth認証とPython実装

#!/usr/bin/env python3
"""OAuth認証でRefresh Tokenを取得"""

from google_auth_oauthlib.flow import InstalledAppFlow
import os

# 環境変数から認証情報を読み込み
CLIENT_ID = os.environ.get('GOOGLE_ADS_CLIENT_ID')
CLIENT_SECRET = os.environ.get('GOOGLE_ADS_CLIENT_SECRET')

if not CLIENT_ID or not CLIENT_SECRET:
    print("エラー: 環境変数 GOOGLE_ADS_CLIENT_ID と GOOGLE_ADS_CLIENT_SECRET を設定してください")
    exit(1)

# OAuth設定
client_config = {
    "installed": {
        "client_id": CLIENT_ID,
        "client_secret": CLIENT_SECRET,
        "auth_uri": "https://accounts.google.com/o/oauth2/auth",
        "token_uri": "https://oauth2.googleapis.com/token",
    }
}

# スコープ設定（Google Ads API専用）
SCOPES = ['https://www.googleapis.com/auth/adwords']

# 認証フロー実行
flow = InstalledAppFlow.from_client_config(client_config, SCOPES)
credentials = flow.run_local_server(port=8080)

# Refresh Token表示
print("\n✅ Refresh Token取得成功:")
print(credentials.refresh_token)
print("\n⚠️ このトークンを環境変数 GOOGLE_ADS_REFRESH_TOKEN に保存してください")

# 必要なパッケージをインストール
pip install google-auth google-auth-oauthlib google-ads

# 環境変数を設定
export GOOGLE_ADS_CLIENT_ID="your-client-id"
export GOOGLE_ADS_CLIENT_SECRET="your-client-secret"

# スクリプト実行
python get_refresh_token.py

# .env ファイル
GOOGLE_ADS_DEVELOPER_TOKEN=your-developer-token
GOOGLE_ADS_CLIENT_ID=your-client-id
GOOGLE_ADS_CLIENT_SECRET=your-client-secret
GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token
GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890  # 親アカウント（ハイフンなし）
GOOGLE_ADS_CUSTOMER_ID=9876543210        # 子アカウント（ハイフンなし）

#!/usr/bin/env python3
"""Google Ads API接続確認"""

from google.ads.googleads.client import GoogleAdsClient
from dotenv import load_dotenv
import os

# 環境変数読み込み
load_dotenv()

def main():
    # 設定を辞書形式で準備
    config = {
        "developer_token": os.environ["GOOGLE_ADS_DEVELOPER_TOKEN"],
        "client_id": os.environ["GOOGLE_ADS_CLIENT_ID"],
        "client_secret": os.environ["GOOGLE_ADS_CLIENT_SECRET"],
        "refresh_token": os.environ["GOOGLE_ADS_REFRESH_TOKEN"],
        "login_customer_id": os.environ["GOOGLE_ADS_LOGIN_CUSTOMER_ID"],
    }

    # クライアント初期化
    client = GoogleAdsClient.load_from_dict(config)
    customer_id = os.environ["GOOGLE_ADS_CUSTOMER_ID"]

    # Google Ads サービス取得
    ga_service = client.get_service("GoogleAdsService")

    # シンプルなクエリで接続確認
    query = """
        SELECT
            campaign.id,
            campaign.name,
            campaign.status
        FROM campaign
        LIMIT 10
    """

    # クエリ実行
    response = ga_service.search(customer_id=customer_id, query=query)

    # 結果表示
    print("✅ 接続成功！キャンペーン一覧:")
    for row in response:
        print(f"  - {row.campaign.name} (ID: {row.campaign.id})")

if __name__ == "__main__":
    main()

Google Ads APIのPythonクライアントを実装してください。

要件:
- 環境変数から認証情報を読み込む
- エラーハンドリングを適切に実装
- キャンペーン一覧を取得する関数
- 日別レポートを取得する関数

制約:
- google-ads公式ライブラリを使用
- IDはハイフンなしで処理
- ログは構造化（JSON形式）

# ❌ 間違い
customer_id = "123-456-7890"

# ✅ 正しい
customer_id = "1234567890"

# ❌ 間違い（一般的なGoogleスコープ）
SCOPES = ['https://www.googleapis.com/auth/userinfo.email']

# ✅ 正しい（Google Ads専用）
SCOPES = ['https://www.googleapis.com/auth/adwords']

config = {
    # 親アカウント（マネージャー）
    "login_customer_id": "1234567890",

    # これとは別！
}

# 操作対象（子アカウント）は別途指定
customer_id = "9876543210"

DEVELOPER_TOKEN_NOT_APPROVED

# .gitignoreに必ず追加
.env
*.json  # クライアントシークレットファイル

# Google Secret Manager例
from google.cloud import secretmanager

def get_secret(secret_id):
    client = secretmanager.SecretManagerServiceClient()
    name = f"projects/{project_id}/secrets/{secret_id}/versions/latest"
    response = client.access_secret_version(request={"name": name})
    return response.payload.data.decode("UTF-8")