Pinterest広告の連携
Pinterest API v5 を使うOAuthリダイレクト方式です。認可は www.pinterest.com 経由で行われます。
| 項目 | 内容 |
|---|---|
| 認可方式 | Pinterest API v5 OAuth リダイレクト |
| スコープ | ads:read / ads:write |
| 用意するもの | Pinterestアプリの App ID / App secret |
| コールバックURL | https://app.ad-submission.com/api/oauth/pinterest/callback |
事前準備(媒体側)
- Pinterest developers でアプリを登録し、App ID(Client ID) と App secret(Client Secret) を取得します。
- アプリの コールバックURL(Redirect URI) に次を完全一致で登録します(末尾スラッシュなし)。
-
https://app.ad-submission.com/api/oauth/pinterest/callback
-
- アプリに広告関連のスコープ(
ads:read/ads:write)の利用権限があることを確認します。
連携の手順【アプリ】
- 「Pinterest広告」セクションの 「+ Pinterest広告アカウントを連携」 を押します。
- 取得した App ID / App secret を入力します。
- 「Pinterestで連携する」を押し、Pinterestの同意画面で広告の閲覧・管理権限を許可します。
- 認可したアカウントが操作できる広告アカウントがまとめて登録されます。アカウント名はPinterest APIから自動取得されます。
うまくいかないときは
- 「アクセスできる広告アカウントが見つからない」: Pinterest側でログインしたアカウントに広告アカウントの権限があるか確認してください。
- Redirect URIエラー: developersに登録したRedirect URIと、実際のアプリURLが完全一致しているか確認します(http/https・末尾スラッシュ)。
ヒント
App secret はサーバーでAES-256-GCM暗号化して保存され、画面やAPIレスポンスに平文で出ることはありません。