카카오링크와 관련된 함수들이 포함되어 있습니다.
Methods
(static) cleanup()
카카오 링크 전송과 관련된 리소스를 해제합니다.
(static) createCustomButton(settings)
- See:
-
- Kakao.Link.sendCustom 직접 카카오링크 버튼을 제작하여 사용할 때 이용하세요.
- 데모 보러가기
원하는 형태의 메시지 템플릿을 만든 후 전송합니다. 메시지 템플릿 가이드로 이동
Parameters:
Name | Type | Description | |||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
settings |
Object | 카카오링크와 관련된 설정을 key/value로 전달합니다. Properties
|
(static) createDefaultButton(settings)
- See:
-
- Kakao.Link.sendDefault 직접 카카오링크 버튼을 제작하여 사용할 때 이용하세요.
- 데모 보러가기
링크 타입 (Feed, List, Location, Commerce, Text)에 맞는 Object를 구성하여 링크를 쉽게 전송할 수 있습니다.
Parameters:
Name | Type | Description | ||||||
---|---|---|---|---|---|---|---|---|
settings |
DefaultFeedSettings | DefaultListSettings | DefaultLocationSettings | DefaultCommerceSettings | DefaultTextSettings | 카카오링크와 관련된 설정을 key/value로 전달합니다. Properties
|
(static) createScrapButton(settings)
- See:
-
- Kakao.Link.sendScrap 직접 카카오링크 버튼을 제작하여 사용할 때 이용하세요.
- 데모 보러가기
사이트의 메타 정보를 활용하여 링크를 전송합니다.
Parameters:
Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
settings |
Object | 카카오링크와 관련된 설정을 key/value로 전달합니다. Properties
|
(static) deleteImage(settings) → {Promise}
삭제할 이미지의 경로를 전달하면 이미지를 삭제할 수 있습니다.
Parameters:
Name | Type | Description | ||||||
---|---|---|---|---|---|---|---|---|
settings |
Object | 카카오링크 이미지와 관련된 설정을 key/value로 전달합니다. Properties
|
Returns:
- Type
- Promise
(static) scrapImage(settings) → {Promise.<ImageInfos>}
스크랩 하고 싶은 이미지의 경로를 전달하면 스크랩 후 업로드 합니다. (이미지는 20일 동안 보관됩니다.)
Parameters:
Name | Type | Description | ||||||
---|---|---|---|---|---|---|---|---|
settings |
Object | 카카오링크 이미지와 관련된 설정을 key/value로 전달합니다. Properties
|
Returns:
- Type
- Promise.<ImageInfos>
(static) sendCustom(settings)
- See:
-
- Kakao.Link.createCustomButton 직접 카카오링크 공유 버튼을 제작하여 사용할 필요가 없는 경우 유용합니다.
- 데모 보러가기
원하는 형태의 메시지 템플릿을 만든 후 전송합니다. 메시지 템플릿 가이드로 이동
Parameters:
Name | Type | Description | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
settings |
Object | 카카오링크와 관련된 설정을 key/value로 전달합니다. Properties
|
(static) sendDefault(settings)
- See:
-
- Kakao.Link.createDefaultButton 직접 카카오링크 공유 버튼을 제작하여 사용할 필요가 없는 경우 유용합니다.
- 데모 보러가기
링크 타입 (Feed, List, Location, Commerce, Text)에 맞는 Object를 구성하여 링크를 쉽게 전송할 수 있습니다.
Parameters:
Name | Type | Description |
---|---|---|
settings |
DefaultFeedSettings | DefaultListSettings | DefaultLocationSettings | DefaultCommerceSettings | DefaultTextSettings | 카카오링크와 관련된 설정을 key/value로 전달합니다. |
(static) sendScrap(settings)
- See:
-
- Kakao.Link.createScrapButton 직접 카카오링크 공유 버튼을 제작하여 사용할 필요가 없는 경우 유용합니다.
- 데모 보러가기
사이트의 메타 정보를 활용하여 링크를 전송합니다.
Parameters:
Name | Type | Description | |||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
settings |
Object | 카카오링크와 관련된 설정을 key/value로 전달합니다. Properties
|
(static) uploadImage(settings) → {Promise.<ImageInfos>}
카카오링크에 필요한 이미지를 업로드 합니다. (이미지는 20일 동안 보관됩니다.)
Parameters:
Name | Type | Description | ||||||
---|---|---|---|---|---|---|---|---|
settings |
Object | 카카오링크 이미지와 관련된 설정을 key/value로 전달합니다. Properties
|
Returns:
- Type
- Promise.<ImageInfos>
Type Definitions
ButtonObject
Properties:
Name | Type | Description |
---|---|---|
title |
String | 버튼의 타이틀 |
link |
LinkObject | 버튼 클릭 시 이동할 링크 정보 |
메시지 하단에 추가되는 버튼 오브젝트입니다.
Type:
- Object
CommerceObject
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
regularPrice |
Number | 정상가격 |
|
discountPrice |
Number |
<optional> |
할인된 가격 |
discountRate |
Number |
<optional> |
할인율 |
fixedDiscountPrice |
Number |
<optional> |
정액 할인 가격, 할인율과 동시 사용불가 |
가격 정보를 표현하기 위해 사용되는 오브젝트입니다.
Type:
- Object
ContentObject
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
title |
String | 콘텐츠의 타이틀 |
|
imageUrl |
String | 콘텐츠의 이미지 URL |
|
link |
LinkObject | 콘텐츠 클릭 시 이동할 링크 정보 |
|
imageWidth |
Number |
<optional> |
콘텐츠의 이미지 너비 (단위: 픽셀) |
imageHeight |
Number |
<optional> |
콘텐츠의 이미지 높이 (단위: 픽셀) |
description |
String |
<optional> |
콘텐츠의 상세 설명 |
콘텐츠의 내용을 담고 있는 오브젝트입니다.
Type:
- Object
DefaultCommerceSettings
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
objectType |
String | 고정값 "commerce" |
||
content |
ContentObject | 메인 콘텐츠 |
||
commerce |
CommerceObject | 가격 정보 |
||
buttonTitle |
String |
<optional> |
버튼명, [앱 설정]에 따른 기본 링크 사용, buttonTitle과 buttons 함께 있을 경우 buttons가 적용됨 |
|
buttons |
Array.<ButtonObject> |
<optional> |
버튼, 링크 설정 가능, buttonTitle과 buttons 함께 있을 경우 buttons가 적용됨 |
|
installTalk |
Boolean |
<optional> |
false
|
카카오톡이 설치되어 있지 않은 경우 마켓의 카카오톡 설치 페이지로 이동합니다. |
callback |
function |
<optional> |
카카오링크 웹공유에서 공유 버튼 클릭 시 호출되는 콜백 함수 (IE 제외) |
|
serverCallbackArgs |
Object | String |
<optional> |
카카오링크 공유 시 전송되는 링크 콜백에 포함되는 파라미터. 링크 콜백 가이드로 이동 |
Type:
- Object
DefaultFeedSettings
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
objectType |
String | 고정값 "feed" |
||
content |
ContentObject | 메인 콘텐츠 |
||
social |
SocialObject |
<optional> |
소셜 정보 |
|
buttonTitle |
String |
<optional> |
버튼명, [앱 설정]에 따른 기본 링크 사용, buttonTitle과 buttons 함께 있을 경우 buttons가 적용됨 |
|
buttons |
Array.<ButtonObject> |
<optional> |
버튼, 링크 설정 가능, buttonTitle과 buttons 함께 있을 경우 buttons가 적용됨 |
|
installTalk |
Boolean |
<optional> |
false
|
카카오톡이 설치되어 있지 않은 경우 마켓의 카카오톡 설치 페이지로 이동합니다. |
callback |
function |
<optional> |
카카오링크 웹공유에서 공유 버튼 클릭 시 호출되는 콜백 함수 (IE 제외) |
|
serverCallbackArgs |
Object | String |
<optional> |
카카오링크 공유 시 전송되는 링크 콜백에 포함되는 파라미터. 링크 콜백 가이드로 이동 |
Type:
- Object
DefaultListSettings
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
objectType |
String | 고정값 "list" |
||
headerTitle |
String | 헤더 타이틀 |
||
headerLink |
LinkObject | 헤더 링크 |
||
contents |
Array.<ContentObject> | 메인 콘텐츠 |
||
buttonTitle |
String |
<optional> |
버튼명, [앱 설정]에 따른 기본 링크 사용, buttonTitle과 buttons 함께 있을 경우 buttons가 적용됨 |
|
buttons |
Array.<ButtonObject> |
<optional> |
버튼, 링크 설정 가능, buttonTitle과 buttons 함께 있을 경우 buttons가 적용됨 |
|
installTalk |
Boolean |
<optional> |
false
|
카카오톡이 설치되어 있지 않은 경우 마켓의 카카오톡 설치 페이지로 이동합니다. |
callback |
function |
<optional> |
카카오링크 웹공유에서 공유 버튼 클릭 시 호출되는 콜백 함수 (IE 제외) |
|
serverCallbackArgs |
Object | String |
<optional> |
카카오링크 공유 시 전송되는 링크 콜백에 포함되는 파라미터. 링크 콜백 가이드로 이동 |
Type:
- Object
DefaultLocationSettings
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
objectType |
String | 고정값 "location" |
||
content |
ContentObject | 메인 콘텐츠 |
||
address |
String | 지도 뷰에서 사용 할 주소, ex.성남시 분당구 판교역로 235 |
||
addressTitle |
String |
<optional> |
지도 뷰에서 사용될 주소명, ex.카카오 본사 |
|
social |
SocialObject |
<optional> |
소셜 정보 |
|
buttonTitle |
String |
<optional> |
버튼명, [앱 설정]에 따른 기본 링크 사용, buttonTitle과 buttons 함께 있을 경우 buttons가 적용됨 |
|
buttons |
Array.<ButtonObject> |
<optional> |
버튼, 링크 설정 가능, buttonTitle과 buttons 함께 있을 경우 buttons가 적용됨 |
|
installTalk |
Boolean |
<optional> |
false
|
카카오톡이 설치되어 있지 않은 경우 마켓의 카카오톡 설치 페이지로 이동합니다. |
callback |
function |
<optional> |
카카오링크 웹공유에서 공유 버튼 클릭 시 호출되는 콜백 함수 (IE 제외) |
|
serverCallbackArgs |
Object | String |
<optional> |
카카오링크 공유 시 전송되는 링크 콜백에 포함되는 파라미터. 링크 콜백 가이드로 이동 |
Type:
- Object
DefaultTextSettings
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
objectType |
String | 고정값 "text" |
||
text |
String | 최대 200자의 텍스트 |
||
buttonTitle |
String |
<optional> |
버튼명, [앱 설정]에 따른 기본 링크 사용, buttonTitle과 buttons 함께 있을 경우 buttons가 적용됨 |
|
buttons |
Array.<ButtonObject> |
<optional> |
버튼, 링크 설정 가능, buttonTitle과 buttons 함께 있을 경우 buttons가 적용됨 |
|
installTalk |
Boolean |
<optional> |
false
|
카카오톡이 설치되어 있지 않은 경우 마켓의 카카오톡 설치 페이지로 이동합니다. |
callback |
function |
<optional> |
카카오링크 웹공유에서 공유 버튼 클릭 시 호출되는 콜백 함수 (IE 제외) |
|
serverCallbackArgs |
Object | String |
<optional> |
카카오링크 공유 시 전송되는 링크 콜백에 포함되는 파라미터. 링크 콜백 가이드로 이동 |
Type:
- Object
ImageInfos
Properties:
Name | Type | Description | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
original |
Object |
Properties
|
이미지 정보
LinkObject
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
webUrl |
String |
<optional> |
PC버전 카카오톡에서 사용하는 웹 링크 URL |
mobileWebUrl |
String |
<optional> |
모바일 카카오톡에서 사용하는 웹 링크 URL |
androidExecutionParams |
String |
<optional> |
안드로이드 카카오톡에서 사용하는 앱 링크 URL에 사용될 파라미터 |
iosExecutionParams |
String |
<optional> |
iOS 카카오톡에서 사용하는 앱 링크 URL에 사용될 파라미터 |
메시지에서 콘텐츠 영역이나 버튼 클릭 시에 이동되는 링크 정보 오브젝트입니다. 오브젝트 내 프로퍼티 중 하나 이상은 반드시 존재해야 합니다.
Type:
- Object
SocialObject
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
likeCount |
Number |
<optional> |
콘텐츠의 좋아요 수 |
commentCount |
Number |
<optional> |
콘텐츠의 댓글 수 |
sharedCount |
Number |
<optional> |
콘텐츠의 공유 수 |
viewCount |
Number |
<optional> |
콘텐츠의 조회 수 |
subscriberCount |
Number |
<optional> |
콘텐츠의 구독 수 |
좋아요 수, 댓글 수 등의 소셜 정보를 표현하기 위해 사용되는 오브젝트입니다.
Type:
- Object