確認日: 2026-07-23
この記事を読む前に
Advertiser APIを使った広告運用の自動化を検討している開発者・運用担当者向けの記事です。公開されている公式資料で設計できる部分と、自社アカウントで事前確認が必要な部分を分けて説明します。
まず確認すること
- Ads ManagerでAPIキーを作成できる権限があるかを、アカウント管理者に確認します。
- 自社の広告アカウントで必要な機能が有効か、実装を始める前に管理画面と公式ドキュメントの両方で確認します。
- 実装時点のエンドポイント、権限、利用制限は変更され得るため、必ず公式資料の最新版を参照します。
公式URL別の確認台帳
| 公式URL | 確認できた事実 | 確認不能・要確認 | 確認日 |
|---|---|---|---|
| Ads Manager ベータ概要（OpenAI公式） | Ads Managerのaccount-level settingsにAPI keysが含まれる | API keyを作成できるロール、権限差 | 2026-07-23 |
| ChatGPT Ads 開発者向けドキュメント（OpenAI Developer Docs） | Measurement、Advertiser API、API Referenceの公開入口がある | ページ上の明示的な最終更新日 | 2026-07-23 |
| Advertiser API overview（OpenAI Developer Docs） | Campaigns、Ad Groups、Ads、Bulk API、Product feeds、Files、Insights、Conversionsの対象範囲。API keyは1広告アカウントにscopeされる | 各アカウントでの機能enablement状況、公開rate limit | 2026-07-23 |
| Advertiser API authentication（OpenAI Developer Docs） | Base URLはhttps://api.ads.openai.com/v1。Bearer token認証。多くのendpointはJSON |
API key発行権限、key rotation手順、公開rate limit | 2026-07-23 |
| Advertiser API quickstart（OpenAI Developer Docs） | GET /ad_account、file upload、campaign、ad group、ad作成、ad insights取得の公開例がある |
実アカウントでの利用可否、審査・権限条件 | 2026-07-23 |
| Bulk API（OpenAI Developer Docs） | 非同期のBulk APIページが公開されている | 対象アカウントでのenablement、実運用上限の適用条件 | 2026-07-23 |
| Product feeds（OpenAI Developer Docs） | Product feedsのAPI資料が公開されている | UIのSFTP FeedとAPI機能の利用条件差 | 2026-07-23 |
| Campaign targeting（OpenAI Developer Docs） | Campaign targetingの公開資料がある | 国・地域・Audience等のアカウント別提供差 | 2026-07-23 |
| Conversion-optimized campaigns（OpenAI Developer Docs） | Conversion-optimized campaignの公開資料がある | 対象アカウントへの提供状態 | 2026-07-23 |
| Insights API（OpenAI Developer Docs） | Ad account、campaign、ad group、ad scopeのInsights endpointと集計項目が公開されている | データ保持期間、rate limit、アカウント別制限 | 2026-07-23 |
公開資料で確認できる機能
次は、公式の公開ドキュメント上で存在を確認できた範囲です。
| 領域 | 公開確認 | 注意 |
|---|---|---|
| Authentication | 確認済み | Ads Managerで発行したkeyをBearer tokenとして使用 |
| API version | 確認済み | Base URLにv1が含まれる |
| Ad account | 確認済み | keyが対象アカウントにscopeされる |
| Campaign CRUD-like operations | 確認済み | アカウント状態・審査・enablementは別 |
| Ad group operations | 確認済み | 同上 |
| Ad operations | 確認済み | Creative reviewは別工程 |
| File upload | 確認済み | URL uploadとmultipartの案内あり |
| Insights | 確認済み | account、campaign、ad group、ad scope |
| Conversion setup | 公開ページあり | Programmatic conversion managementはenablementが必要な場合あり |
| Bulk API | 公開ページあり | 利用可否と上限条件はアカウントで確認 |
| Product feeds | 公開ページあり | UI Feedとの運用差を確認 |
| Campaign targeting・geo | 公開ページあり | 対象機能の提供状態を確認 |
| Rate limit | 要確認 | 共通の公開上限値を確認できず |
オーナーへ求める確認資料
公開判定を公開可へ変更する前に、次を取得してください。
- Ads ManagerのSettings内にあるAPI Keys画面のスクリーンショット
- API key作成ボタンを操作できるユーザーのロール名
- Owner、Admin、Member等での作成・閲覧・削除権限差
- Key作成時に表示される注意事項、scope、再表示可否
- 対象アカウントでAdvertiser APIが利用可能であることを示す画面または成功レスポンス
- Bulk API、Conversions管理、Product feeds、Campaign targetingのenablement状態
- OpenAI公式のrate limitページ、レスポンスヘッダー、またはサポート回答
- 実アカウントで
GET /ad_accountを実行した際の秘密情報を除いた結果
API keyやAuthorization headerの実値は共有・公開しないでください。
公開時に残す注意書き
追加確認が取れた場合でも、本文には次を明記します。
- Advertiser APIはAds Manager用APIであり、OpenAI API一般とは別である
- API keyは1広告アカウントにscopeされる
- 対象アカウントや機能にenablementが必要な場合がある
- 公開ドキュメントと実アカウント画面の差を確認する
- Rate limitは公式に確認できた値だけを書く
- API利用で広告審査や配信を回避できない
- Keyをコード、リポジトリ、記事、画面キャプチャへ含めない
公式ソース
- Ads Manager ベータ概要（OpenAI公式）
- ChatGPT Ads 開発者向けドキュメント（OpenAI Developer Docs）
- Advertiser API overview（OpenAI Developer Docs）
- Advertiser API authentication（OpenAI Developer Docs）
- Advertiser API quickstart（OpenAI Developer Docs）
- Bulk API（OpenAI Developer Docs）
- Product feeds（OpenAI Developer Docs）
- Campaign targeting（OpenAI Developer Docs）
- Conversion-optimized campaigns（OpenAI Developer Docs）
- Insights API（OpenAI Developer Docs）