페이지 이동경로
  • 문서>
  • 카카오모먼트>
  • 비즈보드 랜딩 유형 조회

카카오모먼트

비즈보드 랜딩 유형 조회

이 문서는 비즈보드 랜딩 유형 조회 API 사용 방법을 안내합니다.

비즈니스폼 랜딩 유형 목록 보기

기본 정보
메서드 URL 인증 방식
GET https://apis.moment.kakao.com/openapi/v4/creatives/landing/talkBizForms 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목
필요 필요

소재 생성 및 수정 시 비즈니스폼 랜딩 유형 설정에 사용할 수 있는 비즈니스폼 목록을 조회합니다.

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 광고 계정 번호를 전달하여 요청합니다. 성공 시 응답은 비즈니스폼의 번호와 제목을 비롯한 상세 정보를 포함하며, 특정 비즈니스폼 정보를 소재 생성 및 수정 시 비즈니스폼 랜딩 유형으로 설정할 수 있습니다. 실패 시 에러 코드상세 에러 코드로 사유를 확인합니다.

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O

응답

본문
이름 타입 설명
- BusinessForm[] 비즈니스폼 정보

예제

요청
curl -X GET "https://apis.moment.kakao.com/openapi/v4/creatives/landing/talkBizForms" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}"
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
    {
        "id": 2617,
        "adAccountId": 1334,
        "bizFormId": 5678,
        "title": "비즈니스폼",
        "flowType": "SURVEY",
        "linkedDate": "2020-01-01 01:00:00",
        "beginDateTime": "2020-01-01 00:00",
        "endDateTime": "2020-01-01 00:00"
    }
]

애드뷰 랜딩 유형 목록 보기

기본 정보
메서드 URL 인증 방식
GET https://apis.moment.kakao.com/openapi/v4/creatives/landing/adViews 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목
필요 필요

소재 생성 및 수정 시 애드뷰 랜딩 유형 설정에 필요한 애드뷰 목록을 조회합니다.

비즈니스 토큰과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 광고 계정 번호를 전달해 요청합니다. 성공 시 응답의 특정 애드뷰 정보를 소재 생성 및 수정 시 애드뷰 랜딩 유형으로 설정 시 사용할 수 있습니다. 실패 시 에러 코드상세 에러 코드로 사유를 확인합니다.

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O

응답

본문
이름 타입 설명
- AdView[] 애드뷰 정보

예제

요청
curl -X GET "https://apis.moment.kakao.com/openapi/v4/creatives/landing/adViews" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}"
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
    {
        "id": 5678,
        "name": "첫번째_애드뷰",
        "type": "COMPACT",
        "templateType": "IMAGE"
    },
    {
        "id": 5679,
        "name": "두번째_애드뷰",
        "type": "FULL",
        "templateType": "SCROLL"
    }
]

채널 소식 랜딩 유형 목록 보기

기본 정보
메서드 URL 인증 방식
GET https://apis.moment.kakao.com/openapi/v4/creatives/landing/channelPosts/${PROFILE_ID} 비즈니스 토큰
권한 사전 설정 비즈니스 인증 비즈니스 동의항목
필요: 사용 권한 신청 비즈 앱 전환
비즈니스 Redirect URI 등록
비즈니스 동의항목
필요 필요

소재 생성 및 수정 시 채널 소식 랜딩 유형 설정에 필요한 애드뷰 목록을 조회합니다.

사용자 비즈니스 토큰을 헤더에 담아 GET으로 광고 계정 번호를 전달해 요청합니다. 요청 성공 시 응답의 특정 채널포스 정보를 소재 생성 및 수정 시 채널 소식 랜딩 유형으로 설정 시 사용할 수 있습니다.

요청

헤더
이름 설명 필수
Authorization Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}
인증 방식, 비즈니스 토큰으로 인증 요청
O
adAccountId adAccountId: ${AD_ACCOUNT_ID}
광고계정 ID
O
경로 변수
이름 타입 설명 필수
PROFILE_ID Integer 프로필 번호 O

응답

본문
이름 타입 설명
items ChannelPost[] 채널 소식 정보

예제

요청
curl -X GET "https://apis.moment.kakao.com/openapi/v4/creatives/landing/channelPosts/${PROFILE_ID}" \
    -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
    -H "adAccountId: ${AD_ACCOUNT_ID}"
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "items": [
        {
            "id": 1,
            "title": "포스트",
            "status": "published",
            "permalink": "http://kakao.com/_xxxx/1",
            "createdDate": "2020-01-01 00:00:00",
            "publishedDate": "2020-01-01 00:00:00"
        }
    ]
}

더 보기