代理店・クリエイター向け
広告コンテンツ管理API
バナー・動画素材のアップロード・管理を行います。ブランド別の配信設定、差し替え、レビューステータス管理にも対応しています。
api/v1/advertiser/adcontents
APIリファレンスで確認
エンドポイント一覧
| メソッド | パス | 説明 | レスポンス |
|---|---|---|---|
| GET |
/api/v1/advertiser/adcontents/{id}
|
クリエイティブ詳細を取得
特定の広告クリエイティブのメタデータを返します。
|
200 404 |
| GET |
/api/v1/advertiser/adcontents/
|
クリエイティブ一覧
ステータス、フォーマット、リンクされたキャンペーンでフィルタリングしてクリエイティブを一覧表示します。
|
200 |
| POST |
/api/v1/advertiser/adcontents/
|
クリエイティブをアップロード
新しいクリエイティブ素材を登録し、IDとCDN URLを返します。
|
201 |
| PUT |
/api/v1/advertiser/adcontents/{id}/status
|
レビューステータスを更新
クリエイティブ素材のレビューステータスを変更します。
|
200 |
| DELETE |
/api/v1/advertiser/adcontents/{id}
|
クリエイティブを削除
クリエイティブ素材を削除し、リンクされた広告からも除去します。
|
204 |
エンドポイント詳細
特定の広告クリエイティブのメタデータを返します。
完全パス：
GET /api/v1/advertiser/adcontents/{id}
レスポンスコード：
200
404
ステータス、フォーマット、リンクされたキャンペーンでフィルタリングしてクリエイティブを一覧表示します。
完全パス：
GET /api/v1/advertiser/adcontents/
レスポンスコード：
200
新しいクリエイティブ素材を登録し、IDとCDN URLを返します。
完全パス：
POST /api/v1/advertiser/adcontents/
レスポンスコード：
201
クリエイティブ素材のレビューステータスを変更します。
完全パス：
PUT /api/v1/advertiser/adcontents/{id}/status
レスポンスコード：
200
クリエイティブ素材を削除し、リンクされた広告からも除去します。
完全パス：
DELETE /api/v1/advertiser/adcontents/{id}
レスポンスコード：
204
リクエスト例
リクエスト
POST /api/v1/advertiser/adcontents
Authorization: Bearer {access_token}
Content-Type: multipart/form-data
(file: banner.jpg, campaignId: camp-001)
レスポンス
{
"id": "creative-789",
"cdnUrl": "https://cdn.example.com/creatives/banner.jpg",
"status": "pending_review",
"format": "image/jpeg"
}
認証について
このAPIを利用するには、Authorization: Bearer {access_token} ヘッダーが必要です。
トークンの取得方法は認証ガイドをご確認ください。