리소스
청구 및 결제 복구
지출은 캠페인 전체에 걸쳐 계정 수준에서 수금됩니다. 결제가 실패하면 각 캠페인에 설정된 active/pausedstatus는 유지되지만 delivery_status: "payment_failed"로 게재가 차단됩니다. 계정의 결제 수단을 수정한 다음, 계정에 대해 실패한 광고 결제 재시도를 한 번 호출하세요. 응답은 백그라운드 시도를 대기열에 넣을 뿐이며 결제를 확정하지는 않습니다. 정산이 완료되면 다른 게재 요건을 충족하는 한 활성 캠페인은 재개될 수 있고 일시 중지된 캠페인은 일시 중지 상태로 유지됩니다.
대시보드 흐름, 요청 예시, 중복 요청 동작, 레거시 캠페인 처리 방식은 광고 비용 결제를 참고하세요.
최초 1회 설정
- 스코프:
media:generate,media:read,ad_campaign:create,ad_campaign:update,ad_campaign:basic:read. - 광고 결제 수단: 대시보드에서 연결합니다(잔액 또는 카드). 게재를 시작할 때만 필요하며, 초안은 결제 수단 없이도 작동합니다.
1
크리에이티브 생성
amount_charged, 잔액이 부족하면 deposit_url과 함께 402 반환). status가 ready가 될 때까지 GET /media/{id}를 폴링한 다음 file.id를 사용하세요.failed이면 요금이 환불됩니다. 프롬프트를 수정해 다시 시도하세요. 동영상: "type": "video"와 함께 선택적으로 duration_seconds(5/10/15), resolution(480p–4k), 최대 4개의 reference_media 파일 ID(첫 번째 파일이 시작 프레임의 기반이 됨)를 지정합니다.2
광고 생성 및 게재 시작 — 한 번의 요청
인라인 아직 지출할 준비가 되지 않았나요?
ad_group과 ad_campaign을 포함한 POST /ads는 하나의 트랜잭션으로 전체 트리를 생성하고 게재를 시작합니다.ad_campaign에 "status": "draft"를 추가한 다음, 나중에 PATCH /ad_campaigns/{id} {"status": "active"}로 게재를 시작하세요.기존 컨테이너를 재사용하려면
ad_group 대신 ad_group_id를, ad_campaign 대신 ad_campaign_id를 전달하세요.3
모니터링
GET /ads/{id}를 폴링하세요. delivery_status는 실시간 상태이며(콘텐츠 검토를 위한 짧은 in_review는 정상입니다), issues[]에는 광고 네트워크가 비동기적으로 거부한 항목에 대해 사람이 읽을 수 있는 message가 담겨 있습니다.광고, 광고 그룹 또는 캠페인에서 pause / unpause로 게재를 제어하세요. 문구나 크리에이티브는 PATCH /ads/{id}로 편집하세요. creatives를 보내면 전체 세트가 교체되므로 기본 항목을 포함해야 합니다.오류
모든 검증 실패는 무엇을 수정해야 하는지 알려주는 메시지와 함께400을 반환합니다.

