URL /?id={url}

게시물 또는 게시물의 댓글에서 공유된 URL을 나타냅니다.

자세한 내용은 뉴스 탭 인덱싱 API 문서를 참조하세요.

읽기

게시물 또는 게시물의 댓글에서 공유된 URL에 대한 정보를 가져옵니다.

요구 사항

제한 사항

• 반환된 참여 값은 정확하지 않지만 URL에 대한 사용자 참여를 반영합니다.
• 앱 한 개 기준 시간당 한 URL에 GET 요청을 10개까지만 보낼 수 있습니다.

매개변수

요청을 보강하기 위해 다음 쿼리 문자열 매개변수를 포함합니다.

필드

예

게시물 또는 댓글에 공개된 URL에 대한 정보를 가져오려면 https://graph.facebook.com으로 GET 요청을 보냅니다. 이때 id 매개변수는 URL로 설정하고 URL과 관련된 모든 필드 및 게시물이나 댓글을 공개한 사용자 또는 페이지에서 요청한 액세스 토큰을 포함합니다.

다음 예시는 사용자 액세스 토큰으로 대표되는 사용자가 공유한 https://www.facebook.com이라는 URL에 대한 참여를 나타냅니다.

curl -i -X GET \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com
    &fields=engagement
    &access_token={user-access-token}"

요청이 성공하면 앱이 공유된 URL에 대해 다음과 같이 참여 수를 수신합니다.

{
  "engagement": {
    "reaction_count": 514919172,
    "comment_count": 68687082,
    "share_count": 975739682,
    "comment_plugin_count": 1641
  },
  "id": "https://www.facebook.com"
}

만들기

이 엔드포인트에서는 해당 작업을 수행할 수 없습니다.

업데이트

URL을 업데이트합니다.

요구 사항

예

게시물이나 댓글에 공개된 URL에 대한 정보를 업데이트하려면 https://graph.facebook.com으로 POST 요청을 보냅니다. 이때 id 매개변수는 URL로 설정하고, scrape 매개변수는 true로 설정하며, URL과 관련된 모든 fields 및 게시물이나 댓글을 공개한 사용자 또는 페이지가 요청한 액세스 토큰을 포함합니다.

다음 예시에서는 사용자 액세스 토큰으로 대표되는 사용자가 공유한 https://www.facebook.com/my-update라는 URL을 업데이트합니다.

curl -i -X POST \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com/my-update
    &scrape=true
    &access_token={user-access-token}"

요청이 성공하면 앱이 공유된 URL에 대해 다음과 같이 참여 수를 수신합니다.

{
  "success": true
}  

쿼리 문자열 매개변수

요청을 보강하기 위해 다음 쿼리 문자열 매개변수를 포함합니다.

요청 예시

POST /{version}/?id={url}&scrape=true
Host: graph.facebook.com

응답 예시

{
  "success": true
}

삭제

이 엔드포인트에서는 해당 작업을 수행할 수 없습니다.