페이지 이동경로
  • 문서>
  • 카카오모먼트

카카오모먼트

광고 만들기: 광고계정

이 문서는 광고 만들기: 광고계정 API 사용법을 안내합니다.

광고계정 목록 보기

기본 정보
메서드 URL 인증 방식
GET https://apis.moment.kakao.com/openapi/v4/adAccounts 액세스 토큰
권한 사전 설정 카카오 로그인 사용자 동의
필요 플랫폼 등록
카카오 로그인 활성화
비즈 앱		 필요 -

주의

이 API는 제공 종료될 예정입니다. 신규 API인 광고계정 목록 보기 사용을 권장합니다.

광고계정 목록을 조회합니다. 이 API는 한 번에 최대 1,500개의 광고계정 목록을 조회할 수 있도록 제한되어 있습니다.

액세스 토큰(Access token)을 헤더에 담아 GET으로 요청하고, 성공 시 응답 본문에 JSON 객체로 광고계정들의 정보 배열을 받습니다.

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${ACCESS_TOKEN}
인증 방식, 액세스 토큰으로 인증 요청		 O
쿼리 파라미터
이름 타입 설명 필수
config String 광고계정 상태
ON, OFF, DEL 중 하나 이상의 값을 쉼표로 구분된 문자열에 담아 전달
(기본값 : ON, OFF)		 X

응답

본문
이름 타입 설명
content AdAccount[] 광고계정 정보 목록
AdAccount
이름 타입 설명
id Long 광고계정 번호
name String 광고계정명
memberType MemberType 멤버타입
MASTER(마스터 권한), MEMBER(멤버 권한) 중 하나
config Config 광고계정 상태
businessAccount BusinessAccount 비즈니스계정 정보
소속된 비즈니스계정이 없는 경우 응답에서 제외

예제

요청
curl -v -G GET "https://apis.moment.kakao.com/openapi/v4/adAccounts" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -d "config=ON,OFF,DEL"
응답
{
    "content": [
        {
            "id": 1111,
            "name": "카카오모먼트_광고계정1",
            "memberType": "MASTER",
            "config": "ON"
        },
        {
            "id": 1112,
            "name": "카카오모먼트_광고계정2",
            "memberType": "MEMBER",
            "config": "OFF"
        }
    ]
}
카카오모먼트