제출물 내보내기

크리에이터가 제출한 콘텐츠를 글로비 화면 밖으로 꺼내 전달하기 위한 기능입니다. 화면에서 보이는 것과 같은 내용 — 제출물 본문, AI 검수 결과, 피드백 — 을 파일 하나로 묶습니다.

받는 사람은 글로비 계정이 없는 광고주·클라이언트입니다. 데이터 덤프가 아니라 읽기 좋은 문서를 지향합니다.

엔드포인트

대상	엔드포인트
어드민	`GET /ai/admin/contents/export`
광고주 · 에이전시	`GET /ai/business/contents/export`
미디어 중계 (무인증)	`GET /media/{token}`

두 내보내기 엔드포인트는 파라미터와 응답이 동일합니다. 차이는 누가 무엇까지 보느냐 하나뿐입니다.

포맷 3종

포맷	응답	이미지	영상
`xlsx`	파일 바이트	셀에 삽입	링크
`sheet`	구글 스프레드시트 URL (JSON)	셀에 삽입	링크
`pdf`	파일 바이트	페이지에 삽입	링크

CSV는 지원하지 않습니다.

CSV는 시트 개념이 없어 "인플루언서별 탭"을 만들 수 없고, 이미지도 넣을 수 없습니다. 가볍게 열기는 구글 시트가, 데이터 가공은 xlsx의 요약 시트가 대신합니다.

파일 구조

캠페인 전체를 받으면 첫 시트가 요약이고, 그 뒤로 인플루언서마다 시트가 하나씩 붙습니다.

[요약]      ← 인플루언서 전원 × 제출물 한 행씩 (필터·정렬 가능)
[홍길동]    ← 블록형 상세
[김영희]
[박철수] ...

인플루언서 한 명만 받으면 요약 시트 없이 그 사람 시트만 생성됩니다.

요약 시트

한 행이 제출물 하나입니다.

크리에이터	회차	항목	제출여부	제출일	AI결과	피드백수	미반영

AI결과 열은 세 가지로 구분됩니다.

PASS / FAIL / PARTIAL — 실제 검수 결과
— — 검수를 받지 않음
조회 실패 — AI 결과 저장소(MongoDB) 조회에 실패. 다른 데이터는 정상

인플루언서 시트

화면 순서 그대로 위에서 아래로 쌓입니다.

[홍길동 / @gildong / 인스타그램]

■ 1차   상태: APPROVED
영상 대본 #1
  (본문 전문)
  └ AI 검수: FAIL
     도입   HOOK        FAIL   훅 약함  (근거: "...")
     중반   PRODUCT     PASS
  └ 피드백 (2)
     관리자 08-02  도입부 짧게       미반영
     광고주 08-02  로고 노출 필요     반영완료

■ 2차   상태: REVIEWING
영상 / 캡션 / 해시태그 ...

AI 검수 줄은 FAIL·UNCERTAIN이 위로 정렬되고 셀 배경색으로 강조됩니다.

마스킹 규칙

크리에이터가 아직 제출하지 않은 임시저장 초안이 있을 때 동작이 갈립니다.

요청자	미제출 초안
어드민 (`ROLE_ADMIN`)	실제 현재 내용을 그대로 노출
광고주 · 에이전시	마지막 제출 스냅샷으로 대체

에이전시는 광고주급으로 취급됩니다.

에이전시가 만든 파일이 그대로 고객사에게 전달되는 용도이므로, 크리에이터의 미완성 초안이 새어나가면 안 됩니다.

접근 범위

어드민: 모든 캠페인
광고주: 자기 캠페인
에이전시: 자기 고객사(AGENCY_CLIENT) 캠페인

에이전시 판정은 AgencyAccessService가 담당하며, 별도 파라미터가 필요 없습니다.

미디어 링크

파일 안의 영상·이미지 링크는 원본 스토리지 주소가 아니라 우리 도메인의 프록시 URL입니다.

https://{에이전시 도메인}/media/{token}

에이전시가 받은 파일이 고객사에 전달돼도 어느 플랫폼을 쓰는지 드러나지 않습니다. 자세한 동작은 미디어 프록시 문서를 참고하세요.

개요