피드 대화 상자

피드 대화 상자를 앱에 추가하여 사용자가 댓글이 달린 개별 소식을 자신의 타임라인에 게시할 수 있도록 할 수 있습니다.

피드 대화 상자를 통해 소식을 공유할 때는 확장된 권한을 요청할 필요가 없습니다.

통합

이 대화 상자는 Facebook SDKs for JavaScript, iOS 및 Android에서 URL로의 전체 페이지 리디렉션을 수행하여 사용할 수 있습니다. 이 대화 상자를 트리거하는 데 사용할 수 있는 픽셀 코드 예시는 다음과 같습니다.

JavaScript

피드 대화 상자를 트리거하려면 FB.ui 함수를 호출하고 method 매개변수에 feed 값을 사용합니다.

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

iOS

오픈 그래프 소식을 게시할 수 있는 iOS 공유 대화 상자 가이드를 참조하세요.

Android

오픈 그래프 소식을 게시할 수 있는 Android 공유 대화 상자에 대해 알아보세요.

URL 리디렉션

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

참고

사용자가 '내 타임라인에 글을 남길 수 있는 사람은?' 설정을 '나만'으로 설정했는데 다른 사용자가 피드 대화 상자를 사용하여 이 사용자의 타임라인에 게시물을 게시하려고 시도하면 '게시할 수 없습니다' 오류가 표시됩니다.

매개변수

참고: 앱에서 iTunes 또는 Google Play 스토어에 링크를 공유하거나 Facebook 프로필 또는 페이지에 링크를 공유하는 경우 아래의 매개변수로 공유된 콘텐츠에 지정하는 이미지나 설명은 게시하지 않습니다. 대신 Webcrawler를 사용하여 앱 스토어 또는 Facebook 페이지에서 직접 스크래핑하는 앱 정보를 게시합니다. 이미지는 포함되지 않을 수도 있습니다. iTunes나 Google Play에 대한 링크 공유를 미리 보려면 공유 디버거에 해당 URL을 입력합니다.

매개변수 설명

app_id

앱의 고유한 식별자. 필수 사항.

redirect_uri

사용자가 대화 상자에서 버튼을 클릭한 후 리디렉션될 URL. URL 리디렉션을 사용할 때 필수입니다.

display

대화 상자가 렌더링되는 방식을 결정합니다.

  • URL 리디렉션 대화 상자 구현을 사용하는 경우 Facebook.com에 보이는 전체 페이지가 표시됩니다. 이 표시 유형은 page라고 합니다.
  • iOS 또는 Android용 Facebook SDK를 사용하여 이 대화 상자를 호출할 경우 자동으로 지정되고 기기에 적절한 표시 유형을 선택합니다.
  • Facebook SDK for JavaScript를 사용하는 경우 이는 앱에 로그인한 사용자에게 모달 iframe 유형으로 기본 설정되거나 Facebook.com 게임 내에서 사용하는 경우 async로 기본 설정되며 그 외의 모든 사용자에게는 popup 창으로 기본 설정됩니다. 또한 Facebook SDK for JavaScript를 사용할 때 popup 또는 page 유형을 강제 적용할 수도 있습니다(필요한 경우).
  • 모바일 웹 앱은 항상 touch 표시 유형으로 기본 설정됩니다.

from

메시지를 게시하는 사용자의 ID. 이 ID를 지정하지 않으면 현재 사용자로 기본 설정됩니다. 이 ID를 지정할 경우 사용자 본인 또는 사용자가 관리하는 페이지의 ID여야 합니다.

to

이 소식을 게시할 프로필의 ID. 이 ID를 지정하지 않으면 from의 값으로 기본 설정됩니다. 이 ID는 앱을 사용하는 친구여야 합니다.

link

이 게시물에 첨부된 링크.

source

이 게시물에 첨부된 미디어 파일의 URL(SWF 또는 MP3). SWF일 경우 picture도 지정하여 동영상의 썸네일을 제공해야 합니다.

ref

이 인수는 최대 5가지 항목으로 구성되고 쉼표로 구분된 리스트. 각 항목의 길이는 '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_' 세트에서 가져온 문자 1~15개입니다. 각 카테고리는 Facebook 인사이트에서 여러 게시물 유형의 성과를 측정하는 데 사용됩니다.

사용 중단된 매개변수

매개변수 설명

post_id

사용자가 자신의 타임라인에 게시하기로 선택한 경우 게시된 소식의 ID.

properties

설명 아래의 스트림 첨부 파일에 표시되는 키/값 쌍의 JSON 개체이며, 각 속성은 각 행에 표시됩니다. 키는 문자열이어야 하고 값은 texthref 키를 포함한 문자열 또는 JSON 개체여야 합니다.

actions

행동 링크를 설명하는 단일 개체를 포함하는 JSON 배열이며, 게시물 아래의 '댓글'과 '좋아요' 링크 옆에 표시됩니다. 포함된 개체에는 namelink 키가 있어야 합니다.

picture

이 게시물에 첨부된 사진의 URL. 이 사진은 최소 200x200픽셀이어야 합니다. 크기에 대한 자세한 내용은 공유 모범 사례 관련 문서를 참조하세요.

name

링크 첨부 파일의 이름.

caption

링크의 캡션(링크 이름 아래에 표시). 지정하지 않을 경우 이 필드는 링크의 URL로 자동 입력됩니다.

description

링크의 설명(링크 캡션 아래에 표시). 지정하지 않을 경우 이 필드에는 링크에서 스크래핑된 정보가 자동 입력되는데 이 정보는 일반적으로 페이지의 제목입니다.

thumbnail

업로드된 로컬 이미지 파일(.jpg.jpeg.gif 또는 .png).