広告主・代理店向け
キャンペーン管理API
広告キャンペーンの作成・配信・停止を行います。ターゲット属性、期間、地域を柔軟に設定できます。広告グループや広告枠の管理も含みます。
api/v1/advertiser/adcampaigns
APIリファレンスで確認
エンドポイント一覧
| メソッド | パス | 説明 | レスポンス |
|---|---|---|---|
| GET |
/api/v1/advertiser/adcampaigns/{id}
|
キャンペーン詳細を取得
特定の広告キャンペーンの詳細を取得します。
|
200 404 |
| GET |
/api/v1/advertiser/adcampaigns/search
|
キャンペーンを検索
名前、ステータス、日付範囲で広告キャンペーンを検索します。
|
200 |
| POST |
/api/v1/advertiser/adcampaigns/
|
キャンペーンを作成・更新（Upsert）
IDが指定されない場合は新規作成、既存の場合は更新します。
|
200 |
| DELETE |
/api/v1/advertiser/adcampaigns/{id}
|
キャンペーンを削除
キャンペーンと関連する広告グループ・広告をすべて削除します。
|
204 404 |
エンドポイント詳細
特定の広告キャンペーンの詳細を取得します。
完全パス：
GET /api/v1/advertiser/adcampaigns/{id}
レスポンスコード：
200
404
名前、ステータス、日付範囲で広告キャンペーンを検索します。
完全パス：
GET /api/v1/advertiser/adcampaigns/search
レスポンスコード：
200
IDが指定されない場合は新規作成、既存の場合は更新します。
完全パス：
POST /api/v1/advertiser/adcampaigns/
レスポンスコード：
200
キャンペーンと関連する広告グループ・広告をすべて削除します。
完全パス：
DELETE /api/v1/advertiser/adcampaigns/{id}
レスポンスコード：
204
404
リクエスト例
リクエスト
POST /api/v1/advertiser/adcampaigns
Authorization: Bearer {access_token}
{
"name": "春のセールキャンペーン",
"startDate": "2025-03-01",
"endDate": "2025-03-31",
"budget": 500000,
"targetRegion": "関東"
}
レスポンス
{
"id": "camp-001",
"name": "春のセールキャンペーン",
"status": "draft",
"createdAt": "2025-02-15T10:00:00Z"
}
認証について
このAPIを利用するには、Authorization: Bearer {access_token} ヘッダーが必要です。
トークンの取得方法は認証ガイドをご確認ください。