Meta 광고 계정 목록 조회 (ADMIN)

비즈니스 매니저 산하에 연결된 모든 Meta 광고 계정 목록을 반환합니다. TB_META_OBJECT_SNAPSHOT 의 object_level='ACCOUNT' row 기반.

매시간 정각 active batch 시작 시 /me/adaccounts 를 자동 호출하여 ACCOUNT row 를 upsert 합니다. 비즈니스 매니저에 새 광고 계정이 연결되면 다음 사이클에 자동으로 본 목록에 노출됩니다 (별도 시드 INSERT 불필요).

HTTP 요청

GET /ai/business/meta/accounts
Authorization: Bearer {admin_access_token}

응답

성공 응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "광고계정 목록 조회 완료",
  "data": [
    {
      "adAccountId": "act_2916260795344961",
      "name": "글로우비",
      "status": "ACTIVE",
      "currency": "KRW",
      "timezoneName": "Asia/Seoul"
    },
    {
      "adAccountId": "act_1160065922750394",
      "name": "디웨더",
      "status": "ACTIVE",
      "currency": "KRW",
      "timezoneName": "Asia/Seoul"
    },
    {
      "adAccountId": "act_4440796359491110",
      "name": "Glow.B 리빙",
      "status": "ACTIVE",
      "currency": "KRW",
      "timezoneName": "Asia/Seoul"
    },
    {
      "adAccountId": "act_1912893489351900",
      "name": "Glow.B Supera",
      "status": "ACTIVE",
      "currency": "USD",
      "timezoneName": "Asia/Tokyo"
    },
    {
      "adAccountId": "act_1228857182239350",
      "name": "Glow.B 건식 건기식",
      "status": "ACTIVE",
      "currency": "KRW",
      "timezoneName": "Asia/Seoul"
    }
  ]
}

응답 필드

필드	타입	설명
`adAccountId`	`String`	Meta 광고 계정 ID (`act_xxx` 형식)
`name`	`String`	광고 계정 표시명 (Meta UI 에 설정된 값)
`status`	`String`	광고 계정 상태. `DISABLED` 인 계정은 본 목록에서 자동 제외 (Meta `account_status` 매핑: 1→ACTIVE / 2→DISABLED / 7→PENDING_RISK_REVIEW 등)
`currency`	`String`	통화 (`KRW`, `USD` 등)
`timezoneName`	`String`	타임존 (`Asia/Seoul`, `Asia/Tokyo` 등)

권한

ADMIN 전용. 일반 기업 회원은 본 엔드포인트 호출 불가 (403).

사용 시나리오

ADMIN 화면에서 광고 계정 드롭다운 선택 → GET /ai/business/meta/campaigns?accountId=... 로 해당 계정 캠페인만 필터링
POST /ai/admin/meta-insight/batch/run?accountId=... 로 특정 계정만 수동 트리거할 때 ID 목록 조회용

에러 응답

상태 코드	설명
`403`	관리자 권한 없음

GET /ai/business/meta/accounts