SmartNews広告の連携
SmartNews Ads Marketing API v3 を使います。同意画面（リダイレクト）はありません。入力した認証情報でアクセストークンを発行し、アプリに紐づく広告アカウントを直接登録する client_credentials 方式です。
| 項目 | 内容 |
|---|---|
| 認可方式 | client_credentials（リダイレクトなし） |
| 用意するもの | デベロッパーアプリの Client ID / Client Secret |
| コールバックURL | 不要 |
事前準備（媒体側）
- SmartNews Ads アカウント（広告アカウント）を保有していることを確認します（保有組織のみデベロッパーアプリを申請できます）。
- SmartNews Marketing API のスタートガイドに従い、デベロッパーアプリを申請します（デベロッパーアプリは1組織につき1つのみ）。
- 承認後、デベロッパーアプリの Client ID と Client Secret を取得します。
注意
Client Secretは生成時に一度しか表示されません。 必ず安全な場所に控えてください（紛失時は再生成）。
連携の手順【アプリ】
- 「SmartNews広告」セクションの 「+ SmartNews広告アカウントを連携」 を押します。
- 取得した Client ID / Client Secret を入力します。
- 「SmartNewsを連携する」を押します。リダイレクト・同意画面はありません。
- 入力した認証情報でアクセストークンを発行し、デベロッパーアプリでアクセスできる広告アカウントをまとめて登録します。アカウント名はMarketing APIから自動取得されます。
ヒント
すでに連携済みのアカウントは重複登録されません。もう一度「連携する」を実行すると、アカウント名と認証情報が最新の内容に更新されます。SmartNews Ads 側でアカウント名を変更したときは、これで反映できます。
注意
アクセストークンの発行は 1分あたり5回まで（デベロッパーアプリ単位）です。連携をリトライする場合は間隔を空けてください。
うまくいかないときは
- 連携に失敗する: Client ID / Client Secret が正しいか、デベロッパーアプリが承認済みかを確認します。短時間に複数回試した場合はレート制限の可能性があるため、少し待ってから再試行してください。
ヒント
Client SecretはサーバーでAES-256-GCM暗号化して保存され、画面やAPIレスポンスに平文で出ることはありません。