콘텐츠로 이동
EasterAdEasterAdDocs

광고 단위 생성

POST
/api/core/organization/{organizationId}/apps/{appId}/adUnits
curl --request POST \
  --url https://www.easterad.com/api/core/organization/example/apps/example/adUnits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "type": "AD_UNIT_TYPE_DISPLAY", "pricing": { "floorCpm": 1 }, "mediaTerms": { "fixedCpm": { "cpmMicros": "example", "effectiveFrom": "example", "effectiveUntil": "example" }, "model": "MEDIA_PAYOUT_MODEL_EXPECTED_CPM" } }'

Authorizations

섹션 제목: “Authorizations”

Parameters

섹션 제목: “Parameters”

Path Parameters

섹션 제목: “Path Parameters”
organizationId
required
string
appId
required
string

Request Bodyrequired

섹션 제목: “Request Bodyrequired”
Media typeapplication/json
object
name
string
>= 1 characters <= 40 characters
type
Any of:
string
Allowed value: AD_UNIT_TYPE_DISPLAY
pricing
object
floorCpm
required
number
mediaTerms
object
fixedCpm
object
cpmMicros
required
string
effectiveFrom
required
string
/^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$/
effectiveUntil
string
/^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$/
model
Any of:
string
Allowed value: MEDIA_PAYOUT_MODEL_EXPECTED_CPM

Responses

섹션 제목: “Responses”

200

섹션 제목: “200”

성공

Media typeapplication/json
object
_id
required
string
name
required
string
type
required
Any of:
string
Allowed value: AD_UNIT_TYPE_DISPLAY
appId
required
string
deletedAt
string
/^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$/
createdAt
required
string
/^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$/
updatedAt
required
string
/^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$/
pricing
object
floorCpm
required
number
mediaTerms
object
fixedCpm
object
cpmMicros
required
string
effectiveFrom
required
string
/^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$/
effectiveUntil
string
/^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$/
model
Any of:
string
Allowed value: MEDIA_PAYOUT_MODEL_EXPECTED_CPM
Example
{
  "type": "AD_UNIT_TYPE_DISPLAY",
  "mediaTerms": {
    "model": "MEDIA_PAYOUT_MODEL_EXPECTED_CPM"
  }
}

default

섹션 제목: “default”

오류 — 공통 오류 응답. 인증 단계 오류 코드는 문서의 “인증” 페이지를 참조.

Media typeapplication/json
object
statusCode
required
number
code
required

BadRequest | Unauthorized | Forbidden | NotFound | Conflict | TooManyRequests | InternalServerError | ServiceUnavailable

string
message
required
string
reason

선택 상세 사유. 예: CREATIVE_NOT_READY

string
assetId

관련 소재 ID (선택)

string
authorization
object
reason
required
Any of:
number
0
condition
required
Any of:
number
0
permissions
required
Array<object>
object
statement
required
string
label
required
string
Example
{
  "authorization": {
    "reason": 0,
    "condition": 0
  }
}