広告主・代理店向け
クリエイティブ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
}