広告主・代理店向け
クリエイティブAPI
広告に使う画像・動画をアップロードし、入稿できるクリエイティブを一覧します。サイズ・向き・長さは入稿時に広告面の仕様と照合され、内容はキャンペーンの審査で確認されます。organizationId に広告主アカウントのIDを指定します。代理店のトークンは、連携中のクライアントのIDを指定するとそのクライアントとして操作できます(代理店が審査に提出したキャンペーンは、クライアントの確認待ちになります)。必要なスコープは advertiser.campaigns.read(一覧)と advertiser.campaigns.write(アップロード)です。
api/v1/advertiser
APIリファレンスで確認
エンドポイント一覧
| メソッド | パス | 説明 | レスポンス |
|---|---|---|---|
| GET |
/api/v1/advertiser/creatives
|
クリエイティブを一覧取得
入稿に使えるクリエイティブを新しい順に返します(却下されたものは除く)。
|
200 403 |
| POST |
/api/v1/advertiser/creatives
|
クリエイティブをアップロード
multipart/form-data の file フィールド。画像・動画のみ、100MBまで。
|
201 400 403 |
エンドポイント詳細
入稿に使えるクリエイティブを新しい順に返します(却下されたものは除く)。
完全パス:
GET /api/v1/advertiser/creatives
レスポンスコード:
200
403
multipart/form-data の file フィールド。画像・動画のみ、100MBまで。
完全パス:
POST /api/v1/advertiser/creatives
レスポンスコード:
201
400
403
リクエスト例
リクエスト
POST /api/v1/advertiser/creatives?organizationId={organizationId}
Authorization: Bearer {access_token}
Content-Type: multipart/form-data
(file: autumn-1920x1080.png)
レスポンス
{
"id": "c7a1…",
"name": "autumn-1920x1080.png",
"type": "Image",
"status": "Draft",
"width": 1920,
"height": 1080
}
認証について
このAPIを利用するには、Authorization: Bearer {access_token} ヘッダーが必要です。トークンの取得方法は認証ガイドをご確認ください。