広告主・代理店向け

クリエイティブAPI

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

api/v1/advertiser View in API Reference

Endpoints

Method Path Description Response
GET /api/v1/advertiser/creatives クリエイティブを一覧取得
入稿に使えるクリエイティブを新しい順に返します（却下されたものは除く）。
 200 403
POST /api/v1/advertiser/creatives クリエイティブをアップロード
multipart/form-data の file フィールド。画像・動画のみ、100MBまで。
 201 400 403

Endpoint details

入稿に使えるクリエイティブを新しい順に返します（却下されたものは除く）。

Full path: GET /api/v1/advertiser/creatives
Response codes: 200 403

multipart/form-data の file フィールド。画像・動画のみ、100MBまで。

Full path: POST /api/v1/advertiser/creatives
Response codes: 201 400 403

Example request

Request 
POST /api/v1/advertiser/creatives?organizationId={organizationId}
Authorization: Bearer {access_token}
Content-Type: multipart/form-data

(file: autumn-1920x1080.png)
Response 
{
  "id": "c7a1…",
  "name": "autumn-1920x1080.png",
  "type": "Image",
  "status": "Draft",
  "width": 1920,
  "height": 1080
}
About authentication

To use this API, the Authorization: Bearer {access_token} header is required. See the authentication guide for how to obtain a token.

View the authentication & access API
To API Reference