広告主・代理店向け

クリエイティブ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} โปรดดูวิธีขอ token ได้ที่คู่มือการยืนยันตัวตน

ดู API การยืนยันตัวตนและการเข้าถึง
ไปที่เอกสารอ้างอิง API