공유 대화 상자

공유 대화 상자는 자신의 타임라인, 친구의 타임라인, 그룹 또는 Messenger의 비공개 메시지를 통해 개별 스토리를 게시할 수 있는 기능을 제공합니다. 공유 대화 상자는 웹에서 공유 기능을 제공할 수 있는 가장 간편한 방법이므로 Facebook 로그인이나 확장 권한이 필요하지 않습니다.

이 문서에서는 웹에서 공유 대화 상자를 구현하는 방법에 대해 설명합니다. 모바일 앱에서 공유 대화 상자를 구현하려면 iOS에서 공유 및 Android에서 공유를 참조하세요.

사용자의 타임라인에 링크를 공유하는 공유 대화 상자의 예시는 다음과 같습니다.

앞의 이미지에서는 공유할 대상을 선택하는 드롭다운 리스트에서 자신의 타임라인에 공유가 선택되었습니다. 공유할 대상을 선택하는 드롭다운 리스트는 사용자가 쿠키로 로그인되지 않은 브라우저를 사용할 때는 표시되지 않습니다. 앱이 공유 대화 상자 대신 피드 대화 상자를 사용하거나 앱이 iframe 웹 보기를 사용하는 경우에도 마찬가지입니다.

Facebook에 공유되는 페이지의 웹마스터인 경우, 오픈 그래프 메타 태그를 포함하여 Facebook에 다시 공유되는 스토리를 맞춤 설정하세요. 오픈 그래프 태그로 웹사이트를 마크업하여 Facebook에 콘텐츠를 표시하는 방식을 관리하는 것이 중요합니다. 자세한 내용은 웹마스터를 위한 공유 가이드를 참조하세요.

URL 리디렉션을 사용한 공유

URL 리디렉션을 사용하여 링크를 공유하려면 다음 코드를 사용하세요. 가독성을 높이기 위해 줄 바꿈을 포함했습니다. 이 코드를 사용할 때는 줄 바꿈을 삭제하세요.

https://www.facebook.com/dialog/share?
  app_id=145634995501895
  &display=popup
  &href=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https%3A%2F%2Fdevelopers.facebook.com%2Ftools%2Fexplorer

Javascript용 Facebook SDK를 사용한 공유

Javascript용 Facebook SDK에서 share 메서드 매개변수와 FB.ui 함수를 사용하여 공유 대화 상자를 이용할 수 있습니다. 다음 코드 조각을 사용하여 공유 대화 상자를 엽니다.

FB.ui({
  method: 'share',
  href: 'https://developers.facebook.com/docs/',
}, function(response){});

직접 사용해 보세요!

매개변수

다음은 공유 대화 상자에 사용하는 매개변수입니다.

매개변수	설명	필수인가요?
`app_id`	앱의 고유한 식별자입니다.	예. SDK를 사용할 때 자동으로 제공됩니다.
`display`	공유 대화 상자가 렌더링되는 방식입니다. URL 리디렉션 – `display` 값은 `page`입니다. 공유 대화 상자는 Facebook.com에 표시되는 전체 페이지입니다. JavaScript용 Facebook SDK – display 값은 다음 중 하나입니다. 앱에 로그인한 사용자의 경우 `iframe` 모달 Facebook.com의 게임 내에서 사용할 경우 `async` 그 외의 다른 사용자에게는 `popup` 창 필요한 경우, Javascript용 Facebook SDK를 사용할 때 `popup` 유형을 강제 적용할 수도 있습니다. 모바일 웹 앱 – `display` 값은 항상 `touch`입니다. iOS 또는 Android용 Facebook SDK – SDK는 `display`를 자동으로 지정하고 기기에 적절한 표시 유형을 선택합니다.	예. SDK를 사용할 때 자동으로 제공됩니다.
`hashtag`	공유된 콘텐츠에 추가할 해시태그입니다. 사용자가 공유 대화 상자에서 해시태그를 삭제할 수 있습니다. 해시태그에는 해시 기호를 포함해야 합니다(예: `#facebook`). 기본값은 `null`입니다.	아니요
`href`	공유할 링크입니다. 기본값은 현재 URL입니다.	SDK 사용 시 필수입니다.
~~`redirect_uri`~~ 사용 중단	~~사용자가 공유 대화 상자에서 버튼을 클릭한 후 리디렉션될 URL입니다.~~	~~예. SDK를 사용할 때 자동으로 제공됩니다.~~
~~`mobile_iframe`~~ 사용 중단	~~웹사이트 상의 iframe에서 공유 대화상자를 열 경우 `true`입니다. 이 옵션은 데스크톱이 아니라 모바일에만 제공됩니다.~~	~~`false`~~

응답 데이터

사용자가 Facebook 로그인을 사용하여 앱에 로그인한 경우에만 응답이 발생합니다.

매개변수	설명
`error_message`	오류 메시지입니다.

기타 참고 자료

공유를 위한 모범 사례