비즈니스 토큰으로 로그인한다. 토큰을 tokeninfo로 검증하고 서버 세션에 저장 → 이후 툴은 토큰 인자 없이 호출 가능. 반환에 token_user_id와 접근 가능 계정(tokeninfo).

이후 조회의 기본 대상 광고계정을 세션에 설정한다.

세션의 로그인/계정 정보를 지운다.

현재 인증 상태(로그인 여부·token_user_id·선택된 계정). 토큰 값은 노출하지 않음.

OAuth 로그인-온-커넥트 모드면 요청의 OAuth 토큰 컨텍스트를 보고(=실제 인증 경로), 아니면 세션 저장소(login 툴/웹 로그인)를 본다.

비즈니스 토큰의 소유자(token_user_id)와 접근 가능 광고계정 조회 (GET kapi.kakao.com/v1/business/tokeninfo). biz_agreements[].ad_account_ids가 접근 가능 계정('*'=전체).

비즈니스 토큰 사용자 정보 (GET /v1/business/userinfo).

토큰이 접근 가능한 광고계정 목록 (GET /adAccounts/pages). 계정 선택 전에도 호출 가능.

광고계정 상세 (GET /adAccounts/{adAccountId}).

광고계정 실시간 잔액 (GET /adAccounts/balance).

영업권 조회 (GET /adAccounts/bizRight).

캠페인 목록 (GET /campaigns).

단일 캠페인 상세 (GET /campaigns/{id}).

광고그룹 목록 (GET /adGroups).

단일 광고그룹 상세 (GET /adGroups/{id}).

키워드 목록 (GET /keywords).

단일 키워드 상세 (GET /keywords/{id}).

키워드 품질지수 (GET /keywords/{id}/quality). 검색광고 최적화 분석의 핵심 신호.

소재 목록 (GET /creatives/basic?bizChannelId=). bizChannelId 필수 — 캠페인의 bizChannelId 값을 넘긴다 (소재는 비즈채널 단위).

단일 소재 상세 (GET /creatives/basic/{id}).

광고계정 성과 리포트 (GET /adAccounts/report).

캠페인별 성과 리포트 (GET /campaigns/report).

광고그룹별 성과 리포트 (GET /adGroups/report). campaignId 필수.

키워드별 성과 리포트 (GET /keywords/report). campaignId 필수, adGroupId 선택. 검색광고 분석의 핵심.

소재별 성과 리포트 (GET /creatives/report). campaignId 필수, adGroupId 선택.

레벨 지정 통합 성과 리포트 (KEYWORD 포함). 인사이트 도출용 1급 툴. AD_GROUP/KEYWORD/CREATIVE 레벨은 campaign_id 필수.