사이드 메뉴
시작하기
로그인
커뮤니케이션
광고
카카오모먼트
비즈보드 랜딩 유형 조회
이 문서는 비즈보드 랜딩 유형 조회 API 사용 방법을 안내합니다.
| 메서드 | URL | 인증 방식 |
|---|---|---|
GET | https://apis.moment.kakao.com/openapi/v4/creatives/landing/talkBizForms | 비즈니스 토큰 |
소재 생성 및 수정 시 비즈니스폼 랜딩 유형 설정에 사용할 수 있는 비즈니스폼 목록을 조회합니다.
비즈니스 토큰과 광고계정 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 OKContent-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 | 비즈니스 토큰 |
소재 생성 및 수정 시 애드뷰 랜딩 유형 설정에 필요한 애드뷰 목록을 조회합니다.
비즈니스 토큰과 광고계정 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 OKContent-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} | 비즈니스 토큰 |
소재 생성 및 수정 시 채널 소식 랜딩 유형 설정에 필요한 애드뷰 목록을 조회합니다.
사용자 비즈니스 토큰을 헤더에 담아 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 OKContent-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"}]}