이 문서는 비즈보드 랜딩 유형 조회 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"
}
]
}