確認日: 2026-08-25
この記事を読む前に
Ads Managerの画面設定とAdvertiser APIの公開範囲を照合する開発者・運用者向けの整理です。UIに見える項目をAPI payloadへ推測で追加せず、未確認項目をunknownとして残します。
この記事は、公式情報・報道情報・実務仮説を分けて整理しています。ChatGPT/OpenAI広告は提供地域、仕様、審査、計測方法が変わる可能性があるため、出稿前に必ず公式画面と最新規約を確認してください。
結論
API Overviewが示すresource・reporting範囲と、Create Campaignsが説明するAds Managerの入力項目は、同じ広告運用領域を指しますが、機能が完全に同じだとは書かれていません。UI observed、API documented、account enabled、parity unknownの四つを分けて管理します。
30秒要約
- UIのラベルとAPIのfield名を直接同一視しない。
- API docsにないUI機能を、推測payloadで送らない。
- APIのresource作成と、Ads Managerの審査・表示を分ける。
- 差分は「未対応」ではなく、確認前はunknownとする。
比較表
| 比較軸 | UIで確認 | API文書で確認 | 判定 |
|---|---|---|---|
| Campaign設定 | 画面の入力項目 | resourceカテゴリ・例 | 要照合 |
| Creative | preview、LP、image | upload/createの例 | 要照合 |
| Reporting | table/chart/CSV | Insights endpoint | 粒度確認 |
| Preview機能 | account表示 | docsのlimited preview | enablement確認 |
具体例1: UIにある細かい最適化設定
UIで選べる設定がAPI Overviewに書かれていないなら、APIに同名fieldがあると仮定しません。画面で保存した値、APIのschema、実アカウントのread responseを三つの証拠に分けます。
具体例2: APIで作成できた場合
APIのresource作成は、Ads Managerの審査、掲載、配信、請求を自動的に証明しません。UIの状態とInsightsの実績を別に照合します。
まだ断定しないこと
- APIとUIが同じ機能を持つ、または持たないと一覧なしに断言しません。
- docsにないfieldを「将来対応」「非対応」と断定しません。
- API作成の成功を、実際の広告成果へ変換しません。
確認チェックリスト
- [ ] UI label、API field、resource IDを別記録した
- [ ] API docsの確認日と対象versionを保存した
- [ ] account enablementと一般ドキュメントを分けた
- [ ] 未確認機能へ
unknownを付けた - [ ] UI/API/Insightsの三状態を照合した
更新監視ポイント
Advertiser API Overviewのresource一覧、API Quickstart、Ads ManagerのCreate Campaigns画面を確認します。新機能を見つけた時は、UIの観測とAPIの公式記載が揃うまで記事の断定を更新しません。