広告主・代理店向け

クリエイティブAPI

広告に使う画像・動画をアップロードし、入稿できるクリエイティブを一覧します。サイズ・向き・長さは入稿時に広告面の仕様と照合され、内容はキャンペーンの審査で確認されます。organizationId に広告主アカウントのIDを指定します。代理店のトークンは、連携中のクライアントのIDを指定するとそのクライアントとして操作できます(代理店が審査に提出したキャンペーンは、クライアントの確認待ちになります)。必要なスコープは advertiser.campaigns.read(一覧)と advertiser.campaigns.write(アップロード)です。


エンドポイント一覧

メソッド パス 説明 レスポンス
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} ヘッダーが必要です。トークンの取得方法は認証ガイドをご確認ください。

認証・アクセスAPIを見る