개체 사용

Facebook을 사용하면 개체와 행동으로 구성된 강력한 형식의 API를 통해 앱에서 적절히 구성된 다양한 소식을 게시할 수 있습니다. 개체는 앱에서 사용자가 수행한 행동의 대상이거나 '명사'입니다.

개체는 웹페이지에서 오픈 그래프 HTML 마크업을 사용하여 정의합니다.

개체 만들기

개체는 콘텐츠가 호스팅되는 페이지에 오픈 그래프 메타 태그를 추가하여 만듭니다.

이러한 속성은 페이지를 개체로 전환하는 데 필요한 기본 태그입니다. 이를 페이지 HTML의 <head>에 추가합니다.

<meta property="fb:app_id"          content="1234567890" /> 
<meta property="og:type"            content="article" /> 
<meta property="og:url"             content="http://newsblog.org/news/136756249803614" /> 
<meta property="og:title"           content="Introducing our New Site" /> 
<meta property="og:image"           content="https://scontent-sea1-1.xx.fbcdn.net/hphotos-xap1/t39.2178-6/851565_496755187057665_544240989_n.jpg" /> 
<meta property="og:description"    content="http://samples.ogp.me/390580850990722" />

개체 페이지를 만들고 오픈 그래프에 개체를 동시에 게시하는 일부 호스팅 및 개발 플랫폼에서 개체가 없음을 표시하는 오류가 발생할 수 있습니다. 이 오류는 일부 시스템에 있는 경쟁 조건 때문일 수 있습니다. 오픈 그래프에 행동을 게시하기 전에 개체 페이지가 생성되었는지 확인하거나 계정에 복제 지연을 처리할 짧은 지연 시간(예: 15~30초)을 도입하는 것이 좋습니다.


테스트

공유 디버거를 통해 URL을 전달하여 마크업을 테스트할 수 있습니다. 그러면 오류나 경고 외에도 크롤러가 스크래핑하는 태그를 표시합니다.

개체 업데이트

다음의 경우에 Facebook 크롤러가 개체를 다시 스크래핑(즉, 업데이트)합니다.

  • 개체 URL이 공유 디버거의 입력인 경우
  • 첫 번째 스크랩 이후 30일마다
  • 앱이 API 엔드포인트를 사용하여 스크랩을 트리거하는 경우

이 그래프 API 엔드포인트는 그저 다음을 호출합니다.

POST /?id={object-instance-id or object-url}&scrape=true

이 엔드포인트의 응답은 스크래핑된 개체에 대한 모든 정보를 포함하는 JSON 개체가 됩니다(그래프 API에서 개체 ID를 읽을 때 반환되는 데이터와 동일).

id 매개변수는 그래프에 있는 개체 인스턴스의 ID이거나 개체의 표준 URL일 수 있습니다.


다음의 두 경우를 제외하고, 개체 속성은 언제든 수정할 수 있습니다.

  • 제목: 개체와 관련된 행동(좋아요, 공유 및 댓글)이 50회를 넘으면 해당 제목을 업데이트할 수 없습니다.
  • 유형: 소식에서 개체를 사용하고 나면 개체의 유형을 변경할 수 없습니다. 자세한 내용은 오픈 그래프 유형을 참조하세요.

개체의 이미지를 업데이트하고자 하는 경우 이미지 URL을 원본 이미지 URL과 다르게 지정하는 것이 좋습니다. 캐싱하면 이미지가 업데이트되지 않을 수 있습니다.

페이지 마이그레이션 및 URL 변경

페이지를 새 URL로 이동하는 경우 이전 URL을 새 URL의 표준 소스로 사용하여 개체의 좋아요, 댓글 및 공유를 유지할 수 있습니다. 자세한 내용은 웹 마스터용 공유 가이드에서 알아보세요.